Lightweight
The state of the network.
0.0025USDC
per request
- Block height and slot
- Network identity
- Latest block hash
eth_blockNumber
Agent-native. x402-only.
Blockchain intelligence
for AI agents.
Ethereum and Bitcoin mainnet data, ready for your agent. Read balances, blocks, transactions and more through one pay-per-request API.
No subscription. No credit card. Only x402.
Ethereum: 37 read-only RPC methods and simulations. Bitcoin: seven read-only methods. Mainnet blockchain data; payments use USDC on Base mainnet.
01 / Native to the agent economy
Read balances. Inspect transactions. Query contracts. Pay for the data you request, not another monthly plan.
Send a bounded JSON-RPC request to a chain endpoint.
POST /rpc/ethereumThe 402 response specifies the exact amount. Your agent signs a USDC authorization.
402 PAYMENT-REQUIREDData is delivered after recorded settlement. Recover a paid result with the same private request key.
200 PAYMENT-RESPONSE02 / Launch rate card
Pay as you go. Settle in USDC on Base, whichever chain you query.
The state of the network.
0.0025USDC
per request
eth_blockNumberThe context your agent needs.
0.005USDC
per request
eth_getBalanceMore work. More detail.
0.01USDC
per request
eth_callCurrent prices in USDC on Base mainnet. The endpoint's 402 quote is authoritative. Request and response limits apply; no unbounded scans, traces, or unsupported history. Cache hits have the same price.
03 / From request to result
Start with an unpaid quote. Our agent client handles the x402 handshake, a private request key, a spending budget and recovery.
Example request
/rpc/ethereumThese examples target our production API. Start with an unpaid quote; no wallet connection or payment happens on this page.
Install the agent client Wallet examples API documentation Agent guide (llms.txt) Official x402 documentation# Retain this private key for retries of this request.
export BLOCK402_RECOVERY_KEY=$(openssl rand -hex 32)
curl --include https://api.block402.xyz/rpc/ethereum \
-H 'Content-Type: application/json' \
-H "Idempotency-Key: $BLOCK402_RECOVERY_KEY" \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'One logical request, one private recovery key. Persist the key before sending. Reuse it on retries. A 202 payment_pending response means wait and reconcile, not authorize a new payment.
Agent setup
Use the local MCP bridge with a dedicated buyer wallet, or connect an x402-capable client to the remote server. Listing tools is free; a plain MCP connection does not supply payment handling.
Read-only blockchain operations. Prices: 0.0025, 0.005 and 0.01 USDC on Base mainnet. No subscription or API key. Archive state is not guaranteed.
{
"mcpServers": {
"block402": {
"url": "https://api.block402.xyz/mcp"
}
}
}04 / Good to know
Payments use USDC on Base mainnet (chain ID 8453), whether you query Ethereum or Bitcoin mainnet data. The 402 response identifies the exact token, network, recipient, and amount.
No. All Block402 customer payments use x402. There are no card payments, Stripe checkout, or recurring card subscriptions.
Invalid requests and upstream errors before settlement are not charged. A timeout during settlement may still mean a payment succeeded. Keep the original request key and recover the receipt instead of paying again. Results are retained for seven days by default.
Ethereum and Bitcoin mainnet RPC are available now. Base, Solana and BNB Chain are coming later. Ethereum includes 37 methods for balances, blocks, transactions, receipts, logs, proofs and simulations. Payments use USDC on Base mainnet.
Historical blocks and transactions are supported. Ethereum historical state and proofs depend on data retained by our node; archive state is not guaranteed. Batch RPC, transaction submission, debug, trace, and unbounded scans are not enabled.
Intelligence without the billing friction.
Start building