byte_buy_data
Buy a single data packet from any PayPerByte feed via the x402 payment gateway. Pay per call in USDC with no subscription or prior on-chain setup.
Instructions
Buy a single data packet from any PayPerByte feed via the x402 payment gateway. No subscription, no allowance, no prior on-chain setup — pay-per-call USDC settlement. The MCP server signs an EIP-3009 transferWithAuthorization on behalf of the wallet whose PRIVATE_KEY is configured, the x402 facilitator submits the tx, and the data comes back inline with the on-chain settlement tx hash. Use byte_subscribe instead if you want a continuous stream of broadcasts from a publisher. The catalog of available feed slugs lives at https://x402.payperbyte.io/feeds (free GET). Requires PRIVATE_KEY env var on the MCP server and USDC on the configured wallet. NOTE: paid feeds settle REAL USDC on Base mainnet (eip155:8453) — the exact price is quoted in the 402 challenge (flagship address-reputation: $0.05/verdict). Use a dedicated wallet holding only what you intend to spend.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| feed | Yes | Feed slug — one of: defi-yields ($0.049), weather ($0.021), earthquakes ($0.0015), space-weather ($0.0024), news-feed ($0.0063), code-pulse ($0.010), runtime-eol ($0.069), threat-intel ($0.026), x402-pulse ($0.015), stablecoin-rails ($0.020), perp-funding ($0.0073), usc-statute ($0.012), evidence-pack ($0.100), address-reputation ($0.050), pkg-verdict ($0.050), sanctions-screen ($0.050), liquidation-stream ($0.0079), positioning-snapshot ($0.037). Full catalog: https://x402.payperbyte.io/feeds (free GET). (For fact-oracle Q&A use byte_query_fact instead — it uses a different request-response flow.) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| feed | No | Echoed feed slug | |
| paid | No | True if an x402 payment was made (false on free/cached feeds) | |
| price | No | USDC paid for this packet (e.g. '$0.001000'); omitted on free feeds | |
| txHash | No | x402 settlement transaction hash | |
| payer | No | Wallet that signed the EIP-3009 authorization | |
| status | No | HTTP status of the (post-payment) gateway response | |
| data | No | Decoded feed payload returned by the publisher | |
| error | No | Error message if the buy failed | |
| detail | No | Additional error detail, if any |