Обозреватель
API CoinVertus для обозревателей: сети, последний блок, состояние индекса, блоки, транзакции и адреса.
Содержание
Адрес API: https://api.coinvertus.net/v1
Обозреватель
Вызовы обозревателя принимают GET (и POST): параметры — в строке запроса, тело пустое. С ключом подписывается тот же путь со строкой запроса, а в строке подписи вместо POST стоит GET. {CHAIN} — код сети из chains: короткий (без -mainnet) или полный. CVC может открыть эти вызовы и без ключа, лимит тогда считается по IP-адресу. Данные берутся из индекса CVC, а не напрямую из ноды. Сети без обозревателя — 404 A026.
Списки идут страницами по 100: page — от 1, в ответе — page и pages. Суммы — строками в единицах монеты сети.
ping
GET или POST /v1/ping без ключа и без лимитов — для мониторинга доступности. Ответ: {"code": 200, "message": "ok"}
chains
Список сетей с публичным индексом: chain — короткий код для пути, network — полный код, name, coin и status — статус синхронизации, как в lastblock.
chains/{CHAIN}/lastblock
node_height — последний известный блок сети, indexed — последний блок в индексе (высота, хеш, время), lag_blocks — отставание индекса в блоках, progress — доля пройденной цепи в процентах. stale: true — индекс сейчас недоступен и ответ взят из кэша. Индекс недоступен и кэша нет — 503 A009 с Retry-After.
{
"chain": "dash",
"network": "dash-mainnet",
"name": "Dash",
"node_height": 2371204,
"indexed": {
"height": 2371204,
"hash": "0000000000000017a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3",
"time": "2026-09-17T12:10:00Z"
},
"lag_blocks": 0,
"progress": "100.00",
"status": "synced",
"stale": false
}| Статус | Описание |
|---|---|
synced | Индекс догнал сеть (отставание не больше 2 блоков). |
indexing | Индекс догоняет сеть. |
reorg | Индекс разбирает реорганизацию цепи. |
error | Индексатор остановился с ошибкой, данные могут отставать. |
unavailable | Нет доступной копии индекса. |
chains/{CHAIN}/info
Сводка сети из данных CVC, без обращения к ноде. Времена — UTC, неизвестное значение — null.
{
"chain": "dash",
"network": "dash-mainnet",
"name": "Dash",
"coin": {
"coin": "DASH",
"id": "dash",
"name": "Dash",
"usd": "24.31",
"eur": "22.48",
"rub": "1951.6",
"cny": "173.2",
"inr": "2041.9",
"updated_at": "2026-09-17T12:08:00Z"
},
"blockchain": {
"height": 2371204,
"size_bytes": 52431212544,
"size_observed_at": "2026-09-17T12:06:00Z"
},
"index": {
"status": "synced",
"synced": true,
"height": 2371204,
"lag_blocks": 0,
"progress": "100.00",
"blocks_per_second": 0.01,
"eta_seconds": 0,
"updated_at": "2026-09-17T12:09:30Z",
"size_bytes": 184352129024,
"archive_bytes": 121877454848,
"addresses_bytes": 62474674176
},
"donor": {
"status": "healthy",
"synced": true,
"height": 2371204,
"lag_blocks": 0,
"latency_ms": 18,
"checked_at": "2026-09-17T12:09:45Z"
}
}| Поле | Описание |
|---|---|
coin | Монета сети и её курс — те же поля, что у rates, updated_at — время курса. |
blockchain | height — последний известный блок сети, size_bytes — размер цепи на диске ноды как есть (size_on_disk), size_observed_at — время замера (обновляется примерно раз в 15 минут). |
index | Индексатор: status и synced, как в lastblock, height — последний обработанный блок, lag_blocks, progress, blocks_per_second — скорость за последние минуты, eta_seconds — оценка времени до догона сети (0 — догнал, null — неизвестно), updated_at — последний успешный шаг индексатора. |
size_bytes, archive_bytes, addresses_bytes | Сколько занимает индекс сети: archive_bytes — архив блоков и транзакций (точно), addresses_bytes — доля базы адресов узла, общей для его сетей, пропорционально числу адресов (оценка), size_bytes — их сумма. |
donor | Нода, с которой индексатор берёт блоки: status — её здоровье по проверке, synced — не отстаёт от сети больше допустимого, height, lag_blocks, latency_ms и checked_at — время проверки. Адрес и имя ноды не раскрываются. |
chains/{CHAIN}/blocks
Блоки от вершины индекса вниз: height, hash, time, tx_count, size. С новыми блоками страницы сдвигаются.
chains/{CHAIN}/block/{BLOCK}
{BLOCK} — высота или хеш блока. Заголовок блока, confirmations от высоты сети и транзакции страницами: txid, position, size, fee, total_output, coinbase. Блока нет в индексе — 404 A027.
{
"chain": "dash",
"network": "dash-mainnet",
"name": "Dash",
"height": 2371204,
"hash": "0000000000000017a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3a3",
"previous_hash": "000000000000000c5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e",
"next_hash": null,
"time": "2026-09-17T12:10:00Z",
"median_time": "2026-09-17T11:59:20Z",
"confirmations": 1,
"version": 536870912,
"nonce": 1843201977,
"bits": "1925f0a7",
"difficulty": 118235441.73,
"merkle_root": "4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f4f",
"size": 2711,
"stripped_size": 2711,
"weight": 10844,
"tx_count": 1,
"txs": [
{
"txid": "d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1",
"position": 0,
"size": 2711,
"fee": "0",
"total_output": "1.82634702",
"coinbase": true
}
],
"page": 1,
"pages": 1,
"stale": false
}chains/{CHAIN}/tx/{TXID}
Транзакция из блока индекса: блок, confirmations, комиссия, размеры, входы (адрес и сумма потраченного выхода) и выходы (адрес, сумма, тип скрипта, какой транзакцией и на какой высоте потрачен) страницами. Транзакции мемпула и неизвестные — 404 A027.
{
"chain": "dash",
"network": "dash-mainnet",
"name": "Dash",
"txid": "e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7",
"block_height": 2371203,
"block_hash": "0000000000000011c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4c4",
"block_time": "2026-09-17T12:07:30Z",
"confirmations": 2,
"position": 3,
"version": 2,
"lock_time": 0,
"size": 226,
"vsize": 226,
"weight": 904,
"fee": "0.00000226",
"total_output": "1.24990774",
"coinbase": false,
"inputs": [
{
"index": 0,
"previous_txid": "a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8a8",
"previous_index": 1,
"coinbase": false,
"address": "XcF5mKwWsiv3k394GBQNpYAuk3CVJ48Xnp",
"value": "1.25"
}
],
"outputs": [
{
"index": 0,
"address": "XdoKhQE8njcWL8gXfUVXnYf2ejpHSdUeQa",
"value": "1",
"script_type": "pubkeyhash",
"spent_by_txid": null,
"spent_height": null
},
{
"index": 1,
"address": "XcF5mKwWsiv3k394GBQNpYAuk3CVJ48Xnp",
"value": "0.24990774",
"script_type": "pubkeyhash",
"spent_by_txid": null,
"spent_height": null
}
],
"inputs_total": 1,
"outputs_total": 2,
"page": 1,
"pages": 1,
"stale": false
}chains/{CHAIN}/address/{ADDRESS}
Баланс по индексу (balance, received, spent, utxo_count, первый и последний блок) и история событий страницами: block_height, time, txid, direction (in — поступление, out — трата), index — номер выхода или входа, value. Параметр direction — in или out — оставляет одно направление. Адрес верного формата, которого не было в сети, — нули; неверный формат — 400 A002.
{
"chain": "dash",
"network": "dash-mainnet",
"name": "Dash",
"address": "XcF5mKwWsiv3k394GBQNpYAuk3CVJ48Xnp",
"script_type": "pubkeyhash",
"balance": "0.24990774",
"received": "1.49990774",
"spent": "1.25",
"utxo_count": 1,
"first_seen_height": 2369877,
"last_height": 2371203,
"events": [
{
"block_height": 2371203,
"time": "2026-09-17T12:07:30Z",
"txid": "e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7",
"direction": "in",
"index": 1,
"value": "0.24990774"
},
{
"block_height": 2371203,
"time": "2026-09-17T12:07:30Z",
"txid": "e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7e7",
"direction": "out",
"index": 0,
"value": "1.25"
}
],
"page": 1,
"pages": 1,
"stale": false
}