Docs
PreçosGitHubPainel

Documentação

Primeiros passos

Crie um endpoint no painel e envie JSON-RPC para um nó completo gerenciado.

Receba seu primeiro webhook

Monitore um endereço em uma testnet e receba uma notificação assinada para uma transferência recebida.

Comece com uma transferência na testnet

1. Crie um endpoint

Cadastre-se na RpcNode, escolha uma rede e um ambiente — você recebe o UUID do endpoint.

Abrir painel

2. URL do endpoint

A URL HTTPS de JSON-RPC é formada pelo slug da rede, pelo ambiente e pelo UUID do endpoint — os mesmos valores do painel (por exemplo, ethereum + mainnet).

Padrão

https://{prefix}-{network}-{environment}.rpcnode.dev/{endpoint-uuid}

Exemplo

https://holy-burned-sky-ethereum-mainnet.rpcnode.dev/7c9e6679-7425-40de-944b-e07fc1f90ae7

3. Primeira requisição

Envie um POST JSON-RPC 2.0 padrão com Content-Type: application/json.

Exemplo com curl

curl https://holy-burned-sky-ethereum-mainnet.rpcnode.dev/7c9e6679-7425-40de-944b-e07fc1f90ae7 \
  -X POST \
  -H 'content-type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_blockNumber",
  "params": []
}'

Limites de requisições (RPS)

Cada endpoint tem um limite de requisições por segundo (RPS) definido pelo seu plano. Ao excedê-lo, o gateway retorna HTTP 429 com o código de erro JSON-RPC -32005.

O contador é por endpoint e é zerado a cada segundo Unix (janela fixa de 1 segundo). Seu limite aparece no painel e na página de preços.

As requisições rejeitadas por RPS não consomem créditos e não entram nas estatísticas de uso.

Exemplo de resposta

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": null,
  "error": {
    "code": -32005,
    "message": "rps limit exceeded"
  }
}

Guias — Receitas prontas para copiar: ler o topo da cadeia, buscar blocos e transações e consultar saldos em nós completos da RpcNode — todas as principais famílias do catálogo da documentação.

Erros — Respostas comuns do gateway da RpcNode: códigos de status HTTP e códigos de erro JSON-RPC para todas as famílias de rede do catálogo da documentação.

Public API — API HTTP assinada para pagamentos, plano e uso, redes e preços, endpoints RPC, monitoramento de endereços e transações, webhooks, eventos de blocos e WebSockets.

Redes e métodos

Use o menu à esquerda para redes e métodos RPC. Os créditos vêm da API de cobrança; a documentação dos parâmetros vem do catálogo de conteúdo.

Status e latência

Tabelas públicas de status e latência por sondagem do topo da cadeia no site da RpcNode — úteis para confirmar que as redes estão respondendo.