cURL

curl is the fastest way to test the Base JSON-RPC API without pulling in an SDK — handy for sanity-checking your endpoint, debugging a response, or scripting a quick health check in CI. Because Base is EVM-equivalent, the same eth_* methods you use on Ethereum work here against chain ID 8453. Every request is an HTTP POST carrying a JSON-RPC body, sent with the header Content-Type: application/json. Your API key lives in the URL path, so you send requests to https://base.therpc.io/YOUR_API_KEY.

By default your API key goes in the Base URL path (https://base.therpc.io/YOUR_API_KEY), but you can instead pass it as a Bearer token using the Authorization: Bearer YOUR_API_KEY header. Either way, all Base JSON-RPC requests must use POST with Content-Type: application/json.

Basic Usage

1curl -X POST \
2  -H "Content-Type: application/json" \
3  --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
4  https://base.therpc.io/YOUR_API_KEY

Authentication

1curl -X POST \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer YOUR_API_KEY" \
4  --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
5  https://base.therpc.io/YOUR_API_KEY

Common Operations

1curl -X POST \
2  -H "Content-Type: application/json" \
3  --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x742d35Cc6634C0532925a3b844Bc454e4438f44e","latest"],"id":1}' \
4  https://base.therpc.io/YOUR_API_KEY

1curl -X POST \
2  -H "Content-Type: application/json" \
3  --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],"id":1}' \
4  https://base.therpc.io/YOUR_API_KEY

cURL

Basic Usage

Authentication

Common Operations

准备好在生产环境中调用了吗？

cURL

Basic Usage

Authentication

Common Operations