Docs
ТарифыGitHubКабинет

Документация

Быстрый старт

Создайте эндпоинт в кабинете и отправляйте JSON-RPC на managed full node.

Получите первый вебхук

Следите за адресом в тестовой сети и получайте подписанное уведомление о входящем переводе.

Начните с перевода в тестовой сети

1. Создайте эндпоинт

Зарегистрируйтесь в RpcNode, выберите сеть и окружение — получите UUID эндпоинта.

Открыть кабинет

2. URL эндпоинта

HTTPS JSON-RPC URL строится из slug сети, окружения и UUID эндпоинта. Сеть и окружение — как в кабинете (например, ethereum + mainnet).

Шаблон

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

Пример

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

3. Первый запрос

Отправьте стандартный JSON-RPC 2.0 POST с Content-Type: application/json.

Пример 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": []
}'

Лимиты RPS

У каждого эндпоинта есть лимит запросов в секунду (RPS) из вашего тарифа. При превышении gateway отвечает HTTP 429 и JSON-RPC error code -32005.

Счётчик ведётся по эндпоинту и сбрасывается каждую Unix-секунду (фиксированное окно в 1 с). Лимит указан в кабинете и на странице тарифов.

Запросы, отклонённые по RPS, не списывают кредиты и не попадают в статистику использования.

Пример ответа

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

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

Гайды — Как получить блок, транзакцию и баланс на RpcNode — curl/fetch примеры по семействам сетей. Текст гайдов на английском.

Ошибки — Частые ответы gateway RpcNode: HTTP-статусы и JSON-RPC коды. Статьи на английском — как описания методов.

Public API — Подписанный HTTP API: платежи, тариф и расход, сети и цены, RPC-эндпоинты, наблюдение за адресами и транзакциями, вебхуки, события блоков и WebSocket. Текст статей на английском — как у гайдов.

Сети и методы

Слева — список сетей и RPC-методов. Кредиты берутся из API биллинга; описания параметров — из каталога документации.

Статус и latency

Публичная страница статуса tip-probe и таблица latency на сайте RpcNode — удобно проверить, что сети отвечают.