byte_buy_data
Purchase a single data packet from any PayPerByte feed via x402 payment gateway. Settle per-call in USDC without 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.030), weather ($0.0050), earthquakes ($0.0030), space-weather ($0.0030), news-feed ($0.010), code-pulse ($0.020), runtime-eol ($0.020), threat-intel ($0.050), x402-pulse ($0.010), stablecoin-rails ($0.030), perp-funding ($0.020), usc-statute ($0.050), evidence-pack ($0.020), address-reputation ($0.050), pkg-verdict ($0.050), sanctions-screen ($0.050), reasoning-verdict ($0.050), liquidation-stream ($0.030), positioning-snapshot ($0.030), agent-compute ($0.050), agent-memory ($0.050), agent-tools ($0.050). 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 |
|---|---|---|---|
| data | No | Decoded feed payload returned by the publisher | |
| feed | No | Echoed feed slug | |
| paid | No | True if an x402 payment was made (false on free/cached feeds) | |
| error | No | Error message if the buy failed | |
| payer | No | Wallet that signed the EIP-3009 authorization | |
| price | No | USDC paid for this packet (e.g. '$0.001000'); omitted on free feeds | |
| detail | No | Additional error detail, if any | |
| status | No | HTTP status of the (post-payment) gateway response | |
| txHash | No | x402 settlement transaction hash |