Bitcoin · UTXO

gettxoutsetinfo

Возвращает агрегированные данные по всему UTXO-набору на текущей высоте: число выходов и суммарный объём монет в обращении (total_amount). Тяжёлый метод — расчёт хеша набора требует полного прохода; на pruned-нодах может быть недоступен.

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

Параметры

ИмяТипОбязателенОписание
hash_typeSTRINGнетТип агрегированного хеша набора: hash_serialized_3, muhash или none

Возвращает

OBJECT — статистика UTXO-набора

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

{
  "jsonrpc": "2.0",
  "method": "gettxoutsetinfo",
  "params": [
    "none"
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "result": {
    "height": 872341,
    "bestblock": "00000000000000000001a2b3...",
    "txouts": 187234512,
    "total_amount": 19812734.51234
  },
  "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":"gettxoutsetinfo","params":["none"],"id":1}'