Free Unichain RPC endpoint — no API key

EVM-compatible

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/unichain_mainnet/public

curl -X POST 'https://api.blockvectra.com/v1/unichain_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/unichain_mainnet/{api_key}

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

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

x-api-key: {api_key}

Get API Key Quickstart Try in Playground

WebSocket

WebSocket (Path Key)

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

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

wss://api.blockvectra.com/v1/unichain_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	130
Free public RPC endpoint	https://api.blockvectra.com/v1/unichain_mainnet/public
Methods with an API key	39
Data API	Not supported
WebSocket Support	Supported
Webhook push	Not supported
Send Transactions	Supported
Send Transactions (Keyless Public Endpoint)	Supported
State History Window	Historical state for the most recent 85,500 blocks
eth_getLogs Max Block Range	1,000 blocks
Data API Datasets	Not supported
Supported Subscription Types	newHeads, logs
Related testnets	Unknown
Related guides	Unknown

Quick Example

curl -X POST https://api.blockvectra.com/v1/unichain_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 85,500 blocks
eth_getLogs Max Block Range	1,000 blocks
Method Policy	Allow: `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_getHeaderByHash`, `eth_getHeaderByNumber`, `eth_getLogs`, `eth_getProof`, `eth_getRawTransactionByBlockHashAndIndex`, `eth_getRawTransactionByBlockNumberAndIndex`, `eth_getRawTransactionByHash`, `eth_getStorageAt`, `eth_getTransactionByBlockHashAndIndex`, `eth_getTransactionByBlockNumberAndIndex`, `eth_getTransactionByHash`, `eth_getTransactionCount`, `eth_getTransactionReceipt`, `eth_getUncleByBlockHashAndIndex`, `eth_getUncleByBlockNumberAndIndex`, `eth_getUncleCountByBlockHash`, `eth_getUncleCountByBlockNumber`, `eth_maxPriorityFeePerGas`, `eth_sendRawTransaction`, `eth_simulateV1`, `eth_syncing`, `net_version`, `web3_clientVersion`, `web3_sha3` View Method Policy 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
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/unichain_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/unichain_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"

eth_getLogs

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/unichain_mainnet'

WebSocket

Usage and CU Top up

Frequently Asked Questions

Does Unichain RPC support WebSocket?

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

Does Unichain RPC support trace and debug methods?

Trace and debug methods are not supported for Unichain RPC.

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 →