Bitcoin · Блоки

getblockstats

Возвращает агрегированную статистику по блоку: комиссии, число транзакций, объём, диапазон feerate. Первый аргумент — хеш блока или его высота.

Идемпотентен — повторяется на другом апстриме при сбое

Параметры

Имя	Тип	Обязателен	Описание
hash_or_height	STRING\|NUMBER	да	Хеш блока (hex) либо его высота
stats	ARRAY	нет	Список нужных полей — по умолчанию считаются все

Возвращает

OBJECT — статистика блока

Пример запроса

{
  "jsonrpc": "2.0",
  "method": "getblockstats",
  "params": [
    872341
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "result": {
    "height": 872341,
    "txs": 3120,
    "total_size": 1580342,
    "avgfeerate": 12,
    "subsidy": 312500000
  },
  "id": 1
}

Пример вызова

curl -X POST https://app.nodegate.ru/v1/{product_id} \
  -H "X-API-Key: ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"getblockstats","params":[872341],"id":1}'