Быстрый старт Bitcoin RPC | ERPC

Быстрый старт Bitcoin RPC

Это руководство проведёт вас от нуля до первого ответа Bitcoin JSON-RPC с ERPC.

1. Получите ваш API key

Получить и проверить ваш API key можно на ERPC Web Dashboard: ERPC Web Dashboard
Уже используете ERPC для Solana, Ethereum или Avalanche? Вы можете использовать тот же RPC key.

2. Отправьте ваш первый запрос

Отправьте запрос JSON-RPC как HTTP POST, указав ваш API key в параметре api-key:
bash
curl 'https://edge.erpc.global/bitcoin?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"1.0","id":1,
  "method":"getblockcount",
  "params":[]
}'
Ответ возвращает текущее количество блоков в поле result.
Bitcoin принимает jsonrpc со значением 1.0 или 2.0 либо без этого поля, и у каждого вызова должен быть id.
На тарифе Free ваш аккаунт может отправлять один запрос в 10 секунд, и запрос к другой сети тоже может засчитываться в этот лимит. Подождите 10 секунд перед отправкой следующего запроса.
Вы можете проверить, какую сеть обслуживает endpoint, с помощью getblockchaininfo:
bash
curl 'https://edge.erpc.global/bitcoin?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"1.0","id":1,
  "method":"getblockchaininfo",
  "params":[]
}'
API key также можно передать как Authorization: Bearer <YOUR_API_KEY>. Если указаны оба варианта, используется параметр запроса.

3. Batch-запросы

В одном HTTP-запросе можно отправить от 1 до 100 вызовов JSON-RPC. У каждого вызова должен быть свой id, и значения id внутри одного batch не должны повторяться. Каждый вызов в batch тарифицируется как отдельный вызов. На тарифе Free отправляйте один вызов в запросе: на запрос с двумя или более вызовами возвращается HTTP 429.

Следующие шаги