Free Ethereum RPC endpoint and Chain ID

Ethereum uses chain ID 1; its keyless public RPC endpoint is https://api.blockvectra.com/v1/eth_mainnet/public (3 requests per second per IP), while eth_getLogs requires an API key.

Connect wallets and build applications with HTTP APIs for developers and AI Agents.

RPC endpoints and network parameters

Mainnet

https://api.blockvectra.com/v1/eth_mainnet/public

Try RPC without an API key

curl -sS 'https://api.blockvectra.com/v1/eth_mainnet/public' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Add a network to your wallet

Copy these values into your wallet’s custom network form.

{
  "networkName": "Ethereum",
  "rpcUrl": "https://api.blockvectra.com/v1/eth_mainnet/public",
  "chainId": 1,
  "currencySymbol": "ETH",
  "blockExplorerUrl": "https://etherscan.io"
}

etherscan.io

Incoming transfer Webhooks

Receive address activity at your HTTPS endpoint. Follow the guide to create a subscription, verify signatures and deduplicate deliveries.

Ethereum

Incoming transfer Webhooks

Integration tutorials

Endpoints

No API key required. Wallet methods only, rate-limited per IP. Check GET /v1/chains for current methods and limits.

Free public RPC endpoint

https://api.blockvectra.com/v1/eth_mainnet/public

curl -X POST 'https://api.blockvectra.com/v1/eth_mainnet/public' -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

Rate Limit: 3 req/s per IP, burst 20, batch max 10

Send Transaction Limit: 1 req/s per IP, burst 3

Public methods

eth_chainId
net_version
eth_blockNumber
eth_getBalance
eth_getTransactionCount
eth_getCode
eth_getStorageAt
eth_call
eth_estimateGas
eth_gasPrice
eth_maxPriorityFeePerGas
eth_feeHistory
eth_getBlockByNumber
eth_getBlockByHash
eth_getTransactionByHash
eth_getTransactionReceipt
eth_syncing
web3_clientVersion
eth_sendRawTransaction

All free public RPC endpoints

Public history: latest 1,000 blocks. Register for free to use free API credits for this chain’s supported methods.

JSON-RPC (Path Key)

https://api.blockvectra.com/v1/eth_mainnet/{api_key}

JSON-RPC (Header: x-api-key)

https://api.blockvectra.com/v1/eth_mainnet

x-api-key: {api_key}

Data API

https://api.blockvectra.com/v1/data/eth_mainnet

x-api-key: {api_key}

Get API Key Quickstart Try in Playground

WebSocket

WebSocket (Path Key)

wss://api.blockvectra.com/v1/eth_mainnet/{api_key}

WebSocket (Header: x-api-key or Authorization)

wss://api.blockvectra.com/v1/eth_mainnet

x-api-key: {api_key}
Authorization: Bearer {api_key}

Supported Subscription Types

newHeads
logs (filter must include address or topic0)

OpenAPI Subscription Reference WebSocket Subscriptions Guide

Network Parameters

Chain ID	1
Free public RPC endpoint	https://api.blockvectra.com/v1/eth_mainnet/public
Methods with an API key	38
Data API	Supported
WebSocket Support	Supported
Webhook push	Supported · Confirmations 1–82 (default 6) Webhook push guide
Send Transactions	Supported
Send Transactions (Keyless Public Endpoint)	Supported
State History Window	Historical state for the most recent 250,000 blocks
eth_getLogs Max Block Range	1,000 blocks
Data API Datasets	Blocks, Transactions, Address Transactions, Transfers, Token Metadata, Data Freshness
Supported Subscription Types	newHeads, logs
Related testnets	Unknown
Related guides	Unknown

Quick Example

curl -X POST https://api.blockvectra.com/v1/eth_mainnet \
  -H "Content-Type: application/json" \
  -H "x-api-key: {api_key}" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

Limits

State History Window	Historical state for the most recent 250,000 blocks
eth_getLogs Max Block Range	1,000 blocks
Method Policy	Allow: `debug_traceBlockByHash`, `debug_traceBlockByNumber`, `debug_traceCall`, `debug_traceTransaction`, `eth_blobBaseFee`, `eth_blockNumber`, `eth_call`, `eth_chainId`, `eth_createAccessList`, `eth_estimateGas`, `eth_feeHistory`, `eth_gasPrice`, `eth_getBalance`, `eth_getBlockByHash`, `eth_getBlockByNumber`, `eth_getBlockReceipts`, `eth_getBlockTransactionCountByHash`, `eth_getBlockTransactionCountByNumber`, `eth_getCode`, `eth_getLogs`, `eth_getProof`, `eth_getStorageAt`, `eth_getTransactionByBlockHashAndIndex`, `eth_getTransactionByBlockNumberAndIndex`, `eth_getTransactionByHash`, `eth_getTransactionCount`, `eth_getTransactionReceipt`, `eth_maxPriorityFeePerGas`, `eth_sendRawTransaction`, `eth_syncing`, `net_version`, `trace_block`, `trace_call`, `trace_get`, `trace_replayTransaction`, `trace_transaction`, `web3_clientVersion`, `web3_sha3` View Method Policy Documentation →

Data API

Blocks Transactions Address Transactions Transfers Token Metadata Data Freshness

Check the chain's data freshness

curl -s "https://api.blockvectra.com/v1/data/eth_mainnet/status/freshness" -H "x-api-key: {api_key}"

View Datasets Guide →

View Data API Documentation →

Choose a task

Monitor stablecoin transfers

Partially available

View solution

Developer and AI Agent integration

Available

View solution

Solutions for your onchain tasks

Next steps with an API key

eth_getLogs

set -eu
: "${BLOCKVECTRA_API_KEY:?BLOCKVECTRA_API_KEY is required}"
validate_response='import json,re,sys
response=json.load(sys.stdin)
if not (type(response) is dict and response.get("jsonrpc")=="2.0" and type(response.get("id")) is int and response["id"]==1 and "error" not in response and "result" in response):
    sys.exit("Invalid JSON-RPC response")
result=response["result"]
if sys.argv[1]=="head":
    if not (type(result) is str and re.fullmatch(r"0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)",result)):
        sys.exit("Invalid block quantity")
    print(result)
else:
    if not (type(result) is list and all(type(log) is dict for log in result)):
        sys.exit("Invalid logs result")
    print(json.dumps(response,indent=2))'
head_response=$(curl -fsS 'https://api.blockvectra.com/v1/eth_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}')
head=$(printf '%s' "$head_response" | python3 -c "$validate_response" head)
logs_response=$(curl -fsS 'https://api.blockvectra.com/v1/eth_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$head\",\"toBlock\":\"$head\"}]}")
printf '%s' "$logs_response" | python3 -c "$validate_response" logs

eth_getLogs

Data API

curl -fsS 'https://api.blockvectra.com/v1/data/eth_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"

Data API

WebSocket

echo '{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}' | websocat --no-close -H="x-api-key: $BLOCKVECTRA_API_KEY" 'wss://api.blockvectra.com/v1/eth_mainnet'

WebSocket

Create a Webhook subscription Create a Webhook subscription Usage and CU Top up

Frequently Asked Questions

What are the Ethereum RPC endpoint and Chain ID?

Ethereum uses chain ID 1; its keyless public RPC endpoint is https://api.blockvectra.com/v1/eth_mainnet/public (3 requests per second per IP), while eth_getLogs requires an API key.

Can I try Ethereum RPC without an API key?

Yes. Call eth_chainId at the public endpoints above without a key. Current methods and per-IP limits are listed in GET /v1/chains.

Does Ethereum RPC support WebSocket?

Ethereum RPC supports WebSocket connections. Supported subscription types: newHeads, logs.

Does Ethereum RPC support trace and debug methods?

Ethereum RPC supports trace and debug methods, including: debug_traceBlockByHash, debug_traceBlockByNumber, debug_traceCall, debug_traceTransaction, trace_block, trace_call, trace_get, trace_replayTransaction, trace_transaction.

Can I broadcast transactions through Ethereum RPC?

Ethereum: Supported.

How much historical state can I query on Ethereum?

Ethereum: Historical state for the most recent 250,000 blocks.

What is the eth_getLogs block-range limit for Ethereum?

Ethereum: 1,000 blocks, while eth_getLogs requires an API key.

Which Data API datasets are available on Ethereum?

Ethereum: Blocks, Transactions, Address Transactions, Transfers, Token Metadata, Data Freshness.

Pricing

Get 30,000,000 CU on sign-up, refilled every 30 days (balances and rate limits are pooled across chains; no credit card required); priced per million calls: eth_blockNumber $0.10, eth_call $1.50, eth_getLogs $3.00.

View Pricing Plans →