Skip to main content
POST
/
v1
/
evm
/
rpc
JSON-RPC Overview
curl --request POST \
  --url https://api.blockdb.io/v1/evm/rpc \
  --header 'Authorization: Bearer <token>'

Documentation Index

Fetch the complete documentation index at: https://docs.blockdb.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

BlockDB exposes a drop-in compatible Ethereum JSON-RPC endpoint for EVM networks. Use it when you want to connect existing tooling (web3 libraries, indexers, bots) without rewriting to BlockDB’s REST endpoint format. This page documents the BlockDB entrypoint and the key conventions you need to call Ethereum JSON-RPC successfully.

​
Endpoint

POST https://api.blockdb.io/v1/evm/rpc?chain_id=<chain_id>

​
Authentication

Send your API key on every request: 
Authorization: Bearer <YOUR_API_KEY>

​
Pricing

JSON-RPC access is included in all BlockDB plans.
  • Basic Plan: Shared infrastructure, standard rate limits.
  • Standard & Platinum Plans: High-throughput access with dedicated support options.
For more details, see Pricing.

​
Method Compatibility

We support the classic Ethereum execution-client JSON-RPC method families, including:
  • eth_*
  • net_*
For the canonical method list and parameter conventions, see the Ethereum JSON-RPC reference:

​
Conventions (important)

​
Hex encoding

Ethereum JSON-RPC uses hex encoding with specific rules:
  • Quantities (block numbers, integers): hex with 0x prefix, most compact form (0x0 for zero)
  • Byte arrays (hashes, addresses, calldata): hex with 0x prefix, two hex digits per byte

​
Block parameter

Many methods accept a “block parameter”. Common values include:
  • "earliest", "latest", "safe", "finalized", "pending"
  • A specific block number encoded as a hex quantity (e.g., "0x12A05F").

​
Examples

​
Example: eth_getBlockByNumber

curl -X POST "https://api.blockdb.io/v1/evm/rpc?chain_id=1" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_getBlockByNumber",
    "params": ["latest", false]
  }'

​
Example: eth_call

curl -X POST "https://api.blockdb.io/v1/evm/rpc?chain_id=1" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "eth_call",
    "params": [
      {
        "to": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "data": "0x313ce567"
      },
      "latest"
    ]
  }'

​
See also

Last modified on March 21, 2026