Redes compatíveis
Redes blockchain compatíveis, Chain IDs, estruturas de URL e disponibilidade de recursos. Consulte endpoints, métodos e cobertura dos conjuntos de dados por rede.
BlockVectra é um provedor de dados de blockchain multichain: JSON-RPC em todas as redes compatíveis e Data API onde ela está disponível.
Uma API key, todas as redes
- API key universal: a mesma API key funciona em todas as redes blockchain compatíveis com a BlockVectra — sem chaves separadas por rede.
- Rede na URL: cada requisição identifica explicitamente a rede no segmento
{chain}do caminho. - Uso agregado: saldo da conta, buckets de limite de Compute Units (CU) e limites de requisições por segundo do plano gratuito são compartilhados entre todas as redes.
- Preços: consulte Preços.
Teste sem uma API key
Escolha um endpoint RPC público gratuito para usar métodos de carteira sem uma API key. Os métodos públicos e limites por IP estão listados por rede; consulte Início rápido para um exemplo de chamada.
Templates de URL
Estruturas de URL padrão para chamadas JSON-RPC e Data API:
| Serviço | Modo | Template de URL | Observações |
|---|---|---|---|
| JSON-RPC | API key no caminho | POST /v1/{chain}/{api_key} | Forma mais simples; recomendada para curl e clientes HTTP |
| JSON-RPC | API key em um cabeçalho | POST /v1/{chain} | Envie a API key no cabeçalho de requisição x-api-key: {api_key} |
| Data API | Endpoints REST | GET /v1/data/{chain}/… | Envie a API key no cabeçalho de requisição x-api-key |
| Status | Status público | GET /v1/status | Não exige API key; retorna o status e o bloco mais recente de cada rede pública |
Observação: uma requisição sem o segmento da rede (por exemplo,
POST /v1ouPOST /v1/) retorna HTTP 404 com corpo vazio. Consulte Início rápido para detalhes de configuração.
Matriz de redes compatíveis
As redes blockchain atualmente disponíveis na BlockVectra e os recursos de seus serviços:
Endpoints, métodos com API key, assinaturas, envio de transações, limites de estado e logs, conjuntos de dados, testnets relacionadas e guias são apresentados por rede. Informações desconhecidas permanecem desconhecidas. Expanda uma rede abaixo da matriz para ver requisições compatíveis com ela.
| Rede | {chain} | Chain ID | Tracing | Endpoint público | WebSocket | Data API | Métodos com chave API | Notificações Webhook | Enviar transações | Enviar transações (endpoint público sem key) | Janela de histórico de estado | Intervalo máximo de blocos para eth_getLogs | Conjuntos de dados da Data API | Redes de teste relacionadas | Guias relacionados |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| RPC e Data API de arb_mainnet | arb_mainnet | 42161 | ✓ | https://api.blockvectra.com/v1/arb_mainnet/public | Compatível (newHeads, logs) | Disponível | 43 | Compatível · Confirmações 1–120 (padrão 120) Guia de notificações Webhook | Compatível | Compatível | Estado histórico para os 5,000 blocos mais recentes | 1,000 blocos | Blocos, Transações, Transações de endereços, Transferências, Metadados de tokens, Atualidade dos dados | Desconhecida | Desconhecida |
| RPC de arc_mainnet | arc_mainnet | 5042 | — | https://api.blockvectra.com/v1/arc_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Desconhecida | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC de avax_mainnet | avax_mainnet | 43114 | ✓ | https://api.blockvectra.com/v1/avax_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 41 | Não compatível | Compatível | Compatível | Estado histórico para os 128 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC e Data API de base_mainnet | base_mainnet | 8453 | — | https://api.blockvectra.com/v1/base_mainnet/public | Compatível (newHeads, logs) | Disponível | 39 | Compatível · Confirmações 1–519 (padrão 1) Guia de notificações Webhook | Compatível | Compatível | Estado histórico para os 10,000 blocos mais recentes | 1,000 blocos | Blocos, Transações, Transações de endereços, Transferências, Metadados de tokens, Atualidade dos dados | Desconhecida | Base |
| RPC de berachain_mainnet | berachain_mainnet | 80094 | — | https://api.blockvectra.com/v1/berachain_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 9,000 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC de boba_mainnet | boba_mainnet | 288 | — | https://api.blockvectra.com/v1/boba_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 80,000 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC e Data API de bsc_mainnet | bsc_mainnet | 56 | — | https://api.blockvectra.com/v1/bsc_mainnet/public | Compatível (newHeads, logs) | Disponível | 25 | Compatível · Confirmações 1–2 (padrão 1) Guia de notificações Webhook | Compatível | Compatível | Estado histórico para os 100 blocos mais recentes | 1,000 blocos | Blocos, Transações, Transações de endereços, Transferências, Metadados de tokens, Atualidade dos dados | Desconhecida | Desconhecida |
| RPC de celo_mainnet | celo_mainnet | 42220 | — | https://api.blockvectra.com/v1/celo_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 864,000 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC e Data API de Ethereum | eth_mainnet | 1 | ✓ | https://api.blockvectra.com/v1/eth_mainnet/public | Compatível (newHeads, logs) | Disponível | 38 | Compatível · Confirmações 1–82 (padrão 6) Guia de notificações Webhook | Compatível | Compatível | Estado histórico para os 250,000 blocos mais recentes | 1,000 blocos | Blocos, Transações, Transações de endereços, Transferências, Metadados de tokens, Atualidade dos dados | Desconhecida | Desconhecida |
| RPC e Data API de eth_sepolia | eth_sepolia | 11155111 | — | https://api.blockvectra.com/v1/eth_sepolia/public | Compatível (newHeads, logs) | Disponível | 29 | Compatível · Confirmações 1–67 (padrão 6) Guia de notificações Webhook | Compatível | Compatível | Desconhecida | 1,000 blocos | Blocos, Transações, Transações de endereços, Transferências, Metadados de tokens, Atualidade dos dados | Desconhecida | Desconhecida |
| RPC de fraxtal_mainnet | fraxtal_mainnet | 252 | — | https://api.blockvectra.com/v1/fraxtal_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 10,000 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC e Data API de gnosis_mainnet | gnosis_mainnet | 100 | — | https://api.blockvectra.com/v1/gnosis_mainnet/public | Compatível (newHeads, logs) | Disponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 262,000 blocos mais recentes | 1,000 blocos | Blocos, Transações, Transações de endereços, Transferências, Metadados de tokens, Atualidade dos dados | Desconhecida | Desconhecida |
| RPC e Data API de HyperEVM | hyperevm_mainnet | 999 | — | https://api.blockvectra.com/v1/hyperevm_mainnet/public | Compatível (newHeads, logs) | Disponível | 25 | Compatível · Confirmações 1–1 (padrão 1) Guia de notificações Webhook | Compatível | Não compatível | Desconhecida | 1,000 blocos | Blocos, Transações, Transações de endereços, Transferências, Metadados de tokens, Atualidade dos dados | Desconhecida | Recuperação e polling na HyperEVM |
| RPC de ink_mainnet | ink_mainnet | 57073 | — | https://api.blockvectra.com/v1/ink_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 9,000 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Ink pool discovery |
| RPC de katana_mainnet | katana_mainnet | 747474 | — | https://api.blockvectra.com/v1/katana_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 86,400 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC de linea_mainnet | linea_mainnet | 59144 | — | https://api.blockvectra.com/v1/linea_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 128 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC de metall2_mainnet | metall2_mainnet | 1750 | — | https://api.blockvectra.com/v1/metall2_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 10,000 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC de mode_mainnet | mode_mainnet | 34443 | — | https://api.blockvectra.com/v1/mode_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 10,000 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC e Data API de op_mainnet | op_mainnet | 10 | — | https://api.blockvectra.com/v1/op_mainnet/public | Compatível (newHeads, logs) | Disponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 1,296,000 blocos mais recentes | 1,000 blocos | Blocos, Transações, Transações de endereços, Transferências, Metadados de tokens, Atualidade dos dados | Desconhecida | Desconhecida |
| RPC e Data API de polygon_mainnet | polygon_mainnet | 137 | ✓ | https://api.blockvectra.com/v1/polygon_mainnet/public | Compatível (newHeads, logs) | Disponível | 43 | Compatível · Confirmações 1–200 (padrão 200) Guia de notificações Webhook | Compatível | Compatível | Estado histórico para os 126 blocos mais recentes | 1,000 blocos | Blocos, Transações, Transações de endereços, Transferências, Metadados de tokens, Atualidade dos dados | Desconhecida | Desconhecida |
| RPC e Data API de Robinhood Chain | robinhood_mainnet | 4663 | ✓ | https://api.blockvectra.com/v1/robinhood_mainnet/public | Compatível (newHeads, logs) | Disponível | 43 | Compatível · Confirmações 1–1 (padrão 1) Guia de notificações Webhook | Compatível | Compatível | Estado histórico para os 900 blocos mais recentes | 1,000 blocos | Blocos, Transações, Transações de endereços, Transferências, Metadados de tokens, Swaps de DEX, Ações tokenizadas, Traces, Atualidade dos dados | Desconhecida | HoodFi name records Robinhood Chain Multiplicador de tokens de ações Ações tokenizadas |
| RPC de robinhood_testnet | robinhood_testnet | 46630 | ✓ | https://api.blockvectra.com/v1/robinhood_testnet/public | Compatível (newHeads, logs) | Ainda indisponível | 43 | Compatível · Confirmações 1–1 (padrão 1) Guia de notificações Webhook | Compatível | Compatível | Estado histórico para os 1,023 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Faucet da testnet Início rápido na Robinhood Chain Testnet |
| RPC de rootstock_mainnet | rootstock_mainnet | 30 | — | https://api.blockvectra.com/v1/rootstock_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 27 | Não compatível | Compatível | Compatível | Estado histórico para os 6,000 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC de soneium_mainnet | soneium_mainnet | 1868 | — | https://api.blockvectra.com/v1/soneium_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 9,000 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC de sonic_mainnet | sonic_mainnet | 146 | ✓ | https://api.blockvectra.com/v1/sonic_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 43 | Não compatível | Compatível | Compatível | Estado histórico para os 11,000 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC de unichain_mainnet | unichain_mainnet | 130 | — | https://api.blockvectra.com/v1/unichain_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 85,500 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC de world_mainnet | world_mainnet | 480 | — | https://api.blockvectra.com/v1/world_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 30,000 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC de xlayer_mainnet | xlayer_mainnet | 196 | ✓ | https://api.blockvectra.com/v1/xlayer_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 43 | Não compatível | Compatível | Compatível | Estado histórico para os 250,000 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
| RPC de zora_mainnet | zora_mainnet | 7777777 | — | https://api.blockvectra.com/v1/zora_mainnet/public | Compatível (newHeads, logs) | Ainda indisponível | 39 | Não compatível | Compatível | Compatível | Estado histórico para os 10,000 blocos mais recentes | 1,000 blocos | Não compatível | Desconhecida | Desconhecida |
Próximos passos com uma chave API
arb_mainnet
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/arb_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/arb_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" logseth_getLogsData API
curl -fsS 'https://api.blockvectra.com/v1/data/arb_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"Data APIWebSocket
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/arb_mainnet'WebSocketCriar uma assinatura Webhook · Criar uma assinatura Webhook · Uso e CU · Recarregar
arc_mainnet
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/arc_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/arc_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" logseth_getLogsWebSocket
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/arc_mainnet'WebSocketavax_mainnet
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/avax_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/avax_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" logseth_getLogsWebSocket
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/avax_mainnet'WebSocketbase_mainnet
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/base_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/base_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" logseth_getLogsData API
curl -fsS 'https://api.blockvectra.com/v1/data/base_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"Data APIWebSocket
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/base_mainnet'WebSocketCriar uma assinatura Webhook · Criar uma assinatura Webhook · Uso e CU · Recarregar
berachain_mainnet
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/berachain_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/berachain_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" logseth_getLogsWebSocket
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/berachain_mainnet'WebSocketboba_mainnet
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/boba_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/boba_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" logseth_getLogsWebSocket
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/boba_mainnet'WebSocketbsc_mainnet
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/bsc_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/bsc_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" logseth_getLogsData API
curl -fsS 'https://api.blockvectra.com/v1/data/bsc_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"Data APIWebSocket
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/bsc_mainnet'WebSocketCriar uma assinatura Webhook · Criar uma assinatura Webhook · Uso e CU · Recarregar
celo_mainnet
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/celo_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/celo_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" logseth_getLogsWebSocket
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/celo_mainnet'WebSocketEthereum
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" logseth_getLogsData API
curl -fsS 'https://api.blockvectra.com/v1/data/eth_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"Data APIWebSocket
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'WebSocketCriar uma assinatura Webhook · Criar uma assinatura Webhook · Uso e CU · Recarregar
eth_sepolia
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_sepolia' -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_sepolia' -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" logseth_getLogsData API
curl -fsS 'https://api.blockvectra.com/v1/data/eth_sepolia/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"Data APIWebSocket
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_sepolia'WebSocketCriar uma assinatura Webhook · Criar uma assinatura Webhook · Uso e CU · Recarregar
fraxtal_mainnet
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/fraxtal_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/fraxtal_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" logseth_getLogsWebSocket
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/fraxtal_mainnet'WebSocketgnosis_mainnet
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/gnosis_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/gnosis_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" logseth_getLogsData API
curl -fsS 'https://api.blockvectra.com/v1/data/gnosis_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"Data APIWebSocket
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/gnosis_mainnet'WebSocketHyperEVM
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/hyperevm_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/hyperevm_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" logseth_getLogsData API
curl -fsS 'https://api.blockvectra.com/v1/data/hyperevm_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"Data APIWebSocket
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/hyperevm_mainnet'WebSocketCriar uma assinatura Webhook · Criar uma assinatura Webhook · Uso e CU · Recarregar
ink_mainnet
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/ink_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/ink_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" logseth_getLogsWebSocket
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/ink_mainnet'WebSocketkatana_mainnet
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/katana_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/katana_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" logseth_getLogsWebSocket
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/katana_mainnet'WebSocketlinea_mainnet
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/linea_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/linea_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" logseth_getLogsWebSocket
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/linea_mainnet'WebSocketmetall2_mainnet
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/metall2_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/metall2_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" logseth_getLogsWebSocket
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/metall2_mainnet'WebSocketmode_mainnet
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/mode_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/mode_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" logseth_getLogsWebSocket
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/mode_mainnet'WebSocketop_mainnet
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/op_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/op_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" logseth_getLogsData API
curl -fsS 'https://api.blockvectra.com/v1/data/op_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"Data APIWebSocket
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/op_mainnet'WebSocketpolygon_mainnet
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/polygon_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/polygon_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" logseth_getLogsData API
curl -fsS 'https://api.blockvectra.com/v1/data/polygon_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"Data APIWebSocket
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/polygon_mainnet'WebSocketCriar uma assinatura Webhook · Criar uma assinatura Webhook · Uso e CU · Recarregar
Robinhood Chain
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/robinhood_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/robinhood_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" logseth_getLogsData API
curl -fsS 'https://api.blockvectra.com/v1/data/robinhood_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"Data APIWebSocket
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/robinhood_mainnet'WebSocketCriar uma assinatura Webhook · Criar uma assinatura Webhook · Uso e CU · Recarregar
robinhood_testnet
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/robinhood_testnet' -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/robinhood_testnet' -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" logseth_getLogsWebSocket
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/robinhood_testnet'WebSocketCriar uma assinatura Webhook · Criar uma assinatura Webhook · Uso e CU · Recarregar
rootstock_mainnet
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/rootstock_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/rootstock_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" logseth_getLogsWebSocket
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/rootstock_mainnet'WebSocketsoneium_mainnet
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/soneium_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/soneium_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" logseth_getLogsWebSocket
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/soneium_mainnet'WebSocketsonic_mainnet
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/sonic_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/sonic_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" logseth_getLogsWebSocket
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/sonic_mainnet'WebSocketunichain_mainnet
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/unichain_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/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\":\"$head\",\"toBlock\":\"$head\"}]}")
printf '%s' "$logs_response" | python3 -c "$validate_response" logseth_getLogsWebSocket
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'WebSocketworld_mainnet
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/world_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/world_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" logseth_getLogsWebSocket
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/world_mainnet'WebSocketxlayer_mainnet
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/xlayer_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/xlayer_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" logseth_getLogsWebSocket
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/xlayer_mainnet'WebSocketzora_mainnet
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/zora_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/zora_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" logseth_getLogsWebSocket
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/zora_mainnet'WebSocketHyperEVM
Os blocos da HyperEVM incluem transações do sistema HyperCore (do endereço 0x2222…2222 ou 0x20…, gasPrice 0).
Precisa de outra rede? Fale conosco →
Ethereum
- Chain ID:
1 - Nome da rede (
{chain}nas URLs):eth_mainnet, por exemplo,POST /v1/eth_mainnet/{api_key}ouGET /v1/data/eth_mainnet/….
JSON-RPC
- Métodos: os métodos disponíveis por rede são definidos por
methods.allow/denyemGET /v1/chains(consulte Política de métodos); métodos fora desse escopo retornam-32601. - Apenas dados recentes: a janela de estado histórico é definida por
state_window_blocksemGET /v1/chains. Consultas de estado histórico fora da janela retornam-32011(sem cobrança); consultas de blocos, recibos e logs fora da janela retornam-32000 old data not available due to pruning(sem cobrança); uma transação consultada por hash fora da janela retornaresult: null. eth_getLogs: o intervalo máximo de blocos por requisição émax_logs_block_rangeemGET /v1/chains.
Data API
- Apenas dados recentes: a cobertura de dados da Ethereum é definida por
coverage.from_blockemGET /v1/data/chains. Um número de bloco ou uma janela abaixo do início retorna422 no_coverage; o hash de uma transação que saiu da janela retorna404. - Quando
from_blockénull: o início está temporariamente desconhecido. Não o trate como0ou como histórico completo e não envie requisições históricas (por número de bloco, janela ou hash) para Ethereum até que ele volte a ser um inteiro; elas retornam503 unavailable. 503 gateway_overloaded: tente novamente com backoff (Retry-After: 1).- Conjuntos de dados: os conjuntos de dados disponíveis para Ethereum estão listados em
featuresdeGET /v1/data/chains; os demais retornam422 no_coverage(sem cobrança). Transações e transferências de endereços cobrem apenas a janela: uma resposta que ultrapassa seu início é marcada commeta.coverage: "partial".
Descobrir redes de forma programática
Use estes endpoints públicos para descobrir as redes compatíveis e seu status:
1. Status do serviço (GET /v1/status)
Um endpoint público que não exige API key (CORS *). Lista apenas as redes disponíveis publicamente e retorna seu status e o bloco mais recente indexado:
curl -s "https://api.blockvectra.com/v1/status"Exemplo de resposta:
{
"checked_at": "2026-09-28T07:40:00Z",
"gateway": { "status": "ok" },
"chains": [
{
"chain": "robinhood_mainnet",
"name": "Robinhood Chain",
"chain_id": 4663,
"jsonrpc": true,
"data": true,
"status": "ok",
"data_status": "ok",
"sync": { "stage": "synced", "node_block": 74600000, "target_block": null },
"head": {
"block": 74600000,
"time": "2026-09-28T07:39:58Z",
"lag_seconds": 3
}
},
{
"chain": "eth_mainnet",
"name": "Ethereum",
"chain_id": 1,
"jsonrpc": true,
"data": true,
"status": "ok",
"data_status": "ok",
"sync": { "stage": "synced", "node_block": 26010000, "target_block": null },
"head": {
"block": 26010000,
"time": "2026-09-28T07:39:59Z",
"lag_seconds": 1
}
}
]
}O campo name de cada entrada é sempre o nome de exibição da rede em inglês. jsonrpc e data indicam se a rede está disponível para JSON-RPC e Data API, respectivamente; status é "ok" ou "unavailable". Se uma rede estiver sincronizando, chamadas para ela retornam -32010. Em /v1/status, status informa se o JSON-RPC está funcionando e data_status informa se a Data API está funcionando ("ok", "syncing" ou "unavailable"); em /v1/data/chains, coverage.has_data igual a false significa que a rede ainda não tem dados indexados.
2. Redes da Data API (GET /v1/data/chains)
Exige API key no cabeçalho x-api-key (com cobrança). Retorna as redes públicas atendidas pela Data API, cada uma com os recursos disponíveis (features), os blocos cobertos (coverage), os marcadores de consenso safe/finalized do nó e seu status (finality) e os limites por requisição (limits):
curl -s "https://api.blockvectra.com/v1/data/chains" \
-H "x-api-key: $BLOCKVECTRA_API_KEY"Exemplo de resposta:
{
"data": [
{
"chain": "robinhood_mainnet",
"chain_slug": "ROBINHOOD_MAINNET",
"name": "Robinhood Chain",
"chain_id": 4663,
"chain_external_id": "eip155:4663",
"features": [
"blocks", "transactions", "address_transactions", "transfers", "token_metadata",
"balances", "holders", "nfts", "dex_swaps", "dex_prices", "stocks", "traces", "freshness"
],
"coverage": { "from_block": 0, "traces_from_block": 1000000, "has_data": true },
"finality": { "model": "node_tags", "status": "ok", "safe_block": 74599400, "finalized_block": 74598900 },
"limits": { "max_page_size": 500, "max_window_blocks": 100000, "max_pools_for_token": 200, "max_batch_addresses": 100 }
},
{
"chain": "eth_mainnet",
"chain_slug": "ETH_MAINNET",
"name": "Ethereum",
"chain_id": 1,
"chain_external_id": "eip155:1",
"features": ["blocks", "transactions", "address_transactions", "transfers", "token_metadata", "freshness"],
"coverage": { "from_block": 1000000, "traces_from_block": null, "has_data": true },
"finality": { "model": "node_tags", "status": "stale", "safe_block": 26009950, "finalized_block": 26009900 },
"limits": { "max_page_size": 500, "max_window_blocks": 100000, "max_pools_for_token": 200, "max_batch_addresses": 100 }
}
]
}finality informa os marcadores de consenso do nó (model é "node_tags"), o estado dos marcadores (status é "ok", "stale" ou "unavailable") e os valores atuais de safe_block e finalized_block (safe_block >= finalized_block, e ambos são null apenas quando o status é "unavailable").
coverage.from_block é o menor bloco indexado, consultado em tempo real. É 0 quando o histórico da rede chega ao bloco gênese. Pode ser null apenas quando a rede ainda não tem nenhum bloco indexado (has_data = false) ou quando não é possível determinar o início: trate null como desconhecido — não como histórico completo nem como 0 — e requisições históricas nesse caso retornam 503 unavailable. Sempre consulte esse endpoint em tempo de execução, em vez de fixar o valor no código. coverage.traces_from_block é o primeiro bloco com dados de trace; uma requisição de trace anterior a ele ou dentro de uma lacuna retorna 422 no_coverage (sem cobrança).
Chamar /v1/data/{chain}/… com uma rede desconhecida ou não pública retorna HTTP 404 com error.code not_found (sem cobrança; o nome da rede deve ser o slug exato em letras minúsculas).
Última atualização:
Visão geral
Documentação de JSON-RPC multichain e Data API. Use uma única API key nas redes compatíveis para começar, consultar APIs e conjuntos de dados e entender a cobrança.
Referência de erros
Códigos de erro BlockVectra, cobrança e orientações de novas tentativas para JSON-RPC, Data API, Push Webhooks, console e faucet, incluindo intervalos de blocos de eth_getLogs e erros de replay de Webhook.