API обозревателя Testnet5
Бесплатный публичный JSON API блокчейна Testnet5 и пула Testnet5.com. Ключ и регистрация не нужны. Это те же данные, на которых работают обозреватель Testnet5 и страницы статистики пула.
Testnet5 пока остаётся предложением (Bitcoin Core PR #35861) и не влит в Bitcoin Core. Цепь могут сбросить, или она может так и не запуститься официально. [BIP 95, Draft]
Основные сведения
- Базовый URL обозревателя:
https://api.testnet5.com/explorer/v1 - Базовый URL пула:
https://api.testnet5.com/api/pools/testnet5 - Только чтение. Каждый метод — обычный HTTPS
GET, возвращающий JSON. - Можно вызывать с веб-страницы. Ответы разрешают запросы с любого источника, поэтому браузерное приложение может обращаться к API напрямую.
- Единицы. Суммы в обозревателе указаны в сатоши (1 tBTC5 = 100,000,000 sats), время в обозревателе — в Unix-секундах. Суммы пула указаны в целых tBTC5, время пула — в ISO 8601 по UTC.
- Только тестовые монеты. Монеты Testnet5 ничего не стоят. API пула помечает монету как «BTC», а ссылки в сведениях ведут на обозреватель основной сети, поэтому эти ссылки игнорируйте и смотрите данные здесь.
Добросовестное использование и лимиты
API бесплатен для людей, скриптов и ботов. Чтобы он оставался быстрым для всех, запросы ограничиваются по IP-адресу. Точные лимиты могут меняться без предупреждения.
- Для регулярного опроса держитесь примерно одного запроса в секунду. Новые блоки в среднем приходят каждые несколько минут, поэтому опрос
/statsкаждые 10–30 секунд более чем достаточен. - У ответов короткий срок жизни
Cache-Control. Кэшируйте их у себя и используйте повторно, вместо того чтобы сразу запрашивать снова. - Если получите HTTP
429(слишком много запросов) или503(занято), сделайте паузу и повторите через несколько секунд, каждый раз увеличивая ожидание. - Если нужна полная копия цепи, запустите свою ноду, а не перебирайте каждый блок. См. Запустить ноду Testnet5.
Наносящий вред сервису трафик может быть заблокирован. У API нет гарантии доступности, а сама цепь Testnet5 может быть сброшена.
Ошибки
Ошибки обозревателя возвращаются как JSON с кодом состояния HTTP: 400 при некорректном запросе (например, недействительный адрес) и 404, если совпадений нет.
{"error": "not a valid Testnet5 address"}
Методы обозревателя
Все пути ниже заданы относительно https://api.testnet5.com/explorer/v1.
/stats/network/blocks/block/{height or hash}/tx/{txid}/address/{address}/address/{address}/utxo/search/mempool/richlist/faucet
GET /stats
Сводка по цепи: высота, хеш лучшего блока, сложность, оценка хешрейта сети, среднее время блока, следующее переназначение сложности, эмиссия монет, сводка мемпула, а также последние блоки и транзакции.
Параметров нет.
Пример запроса
curl -s 'https://api.testnet5.com/explorer/v1/stats'Пример ответа (живые данные, сокращены)
{
"chain": "testnet5",
"height": 5125,
"best_hash": "00000000000000956b5ba02850c549024c87093f4b4aae9539660ea9668c7abf",
"difficulty": 16777216.0,
"bits": "1a00ffff",
"chainwork": "000000000000000000000000000000000000000000000006bc04cbe466024de0",
"median_time": 1794932504,
"time": 1794932585,
"size_on_disk": 3395094,
"hashrate": 1111730936996655.0,
"hashrate_144": 1004788600130917.0,
"avg_block_time": 71.71527777777777,
"next_retarget_height": 6048,
"blocks_to_retarget": 923,
"halving_height": 210000,
"subsidy": 5000000000,
"indexed_height": 5125,
"index_synced": true,
"tx_count": 5248,
"total_fees": 354697,
"circulating": 25630000000000,
"mempool": {
"count": 0,
"vbytes": 0,
"total_fee": 0,
"min_fee_rate": 0.09999999999999999
},
"latest_blocks": [
{
"height": 5125,
"hash": "00000000000000956b5ba02850c549024c87093f4b4aae9539660ea9668c7abf",
"time": 1794932585,
"tx_count": 1,
"size": 284,
"weight": 1028,
"total_out": 5000000000,
"fees": 0,
"subsidy": 5000000000,
"coinbase_tag": "Testnet5.com Pool",
"coinbase_address": "tb1qt6vrvd992zcprxdc2qc89283aay4440gcajapa",
"confirmations": 1
}
],
"latest_txs": [
{
"txid": "c86ea5d056cc2c47fef865bb078229f19093f4d2be6c939a0329331b2e0420ac",
"height": 5117,
"time": 1794932344,
"fee": 369,
"vsize": 369,
"inputs": 3,
"outputs": 5,
"total_out": 15000009433
}
],
"mempool_txs": []
}GET /network
Состояние сети: хешрейт за несколько окон (12, 144 и 1,008 блоков, а также с последнего переназначения), данные о комиссиях мемпула и то, какие пулы находили недавние блоки, по метке в coinbase.
Параметров нет.
Пример запроса
curl -s 'https://api.testnet5.com/explorer/v1/network'Пример ответа (живые данные, сокращены)
{
"chain": "testnet5",
"height": 5125,
"time": 1794932585,
"difficulty": 16777216.0,
"bits": "1a00ffff",
"next_retarget_height": 6048,
"blocks_to_retarget": 923,
"subsidy": 5000000000,
"hashrate": {
"12": 1879792006078257.0,
"144": 1004788600130917.0,
"1008": 349382206078346.2,
"since_retarget": 370678566612914.4
},
"mempool": {
"count": 0,
"vbytes": 0,
"total_fee": 0,
"min_fee_rate": 0.09999999999999999,
"fee_rates": null
},
"windows": {
"144": {
"blocks": 144,
"avg_interval": 77.90225563909775,
"avg_fullness": 0.03608298611111111,
"avg_tx_count": 1.0972222222222223,
"pools": [
{
"name": "ckpool",
"blocks": 82,
"share": 0.5694444444444444
},
{
"name": "plebhash",
"blocks": 28,
"share": 0.19444444444444445
}
]
}
}
}GET /blocks
Недавние блоки, сначала самые новые.
| Параметр | Где | Что делает |
|---|---|---|
limit | query | Сколько блоков вернуть, от 1 до 50. По умолчанию 25. |
before | query | Вернуть только блоки ниже этой высоты. Используйте, чтобы листать цепь назад. |
Пример запроса
curl -s 'https://api.testnet5.com/explorer/v1/blocks?limit=2'Пример ответа (живые данные, сокращены)
{
"tip": 5125,
"blocks": [
{
"height": 5125,
"hash": "00000000000000956b5ba02850c549024c87093f4b4aae9539660ea9668c7abf",
"time": 1794932585,
"tx_count": 1,
"size": 284,
"weight": 1028,
"total_out": 5000000000,
"fees": 0,
"subsidy": 5000000000,
"coinbase_tag": "Testnet5.com Pool",
"coinbase_address": "tb1qt6vrvd992zcprxdc2qc89283aay4440gcajapa",
"confirmations": 1
},
{
"height": 5124,
"hash": "00000000000000153617e01622fbbf3d0620338ff0e2177989b88f627736cd48",
"time": 1794932602,
"tx_count": 1,
"size": 336,
"weight": 1236,
"total_out": 5000000000,
"fees": 0,
"subsidy": 5000000000,
"coinbase_tag": "",
"coinbase_address": "tb1qsff602kddke6mc0yfg7u2265xtks9x2crnefx8",
"confirmations": 2
}
]
}GET /block/{height or hash}
Один блок по высоте или 64-символьному хешу: поля заголовка, сведения о coinbase (включая высоту по BIP 34 и проверки BIP 54) и его транзакции, по 25 на страницу.
| Параметр | Где | Что делает |
|---|---|---|
height or hash | path | Высота блока, например 5117, или хеш блока. |
page | query | Страница транзакций, начиная с 0. |
Пример запроса
curl -s 'https://api.testnet5.com/explorer/v1/block/5117'Пример ответа (живые данные, сокращены)
{
"height": 5117,
"hash": "00000000000000b7c44302f1acbe13ab9a8e2ef06f9e25e42b0c3e8277cbd2e3",
"time": 1794932344,
"tx_count": 2,
"size": 887,
"weight": 2471,
"total_out": 20000009802,
"fees": 369,
"subsidy": 5000000000,
"coinbase_tag": "ckpool",
"coinbase_address": "tb1q6pt2vtrfx4d7g7rkqzm3ca9xvcedfp99ax955r",
"confirmations": 9,
"version": 564043776,
"version_hex": "219ea000",
"merkle_root": "e939cc773f334d824bdf66078e0e88c3fe16e94490fed173522280164d0cdd75",
"bits": "1a00ffff",
"nonce": 1805387147,
"difficulty": 16777216.0,
"chainwork": "000000000000000000000000000000000000000000000006b404c3e45e0245e0",
"median_time": 1794932066,
"previous_hash": "000000000000003a2528a45dd5c1aed42daacfd517d244697c680ad184fd71de",
"next_hash": "000000000000002dd1f138ab9757f1c530f56d4391e7aef6db3fdba9265a64fe",
"stripped_size": null,
"txs": [
{
"txid": "fc21f67d10bd9418aa3249e8491d1565971cb14d86d77c09496f152784034f97",
"index": 0,
"fee": 0,
"vsize": 168,
"inputs": 1,
"outputs": 2,
"total_out": 5000000369,
"coinbase": true
}
],
"page": 0,
"page_size": 25,
"coinbase": {
"txid": "fc21f67d10bd9418aa3249e8491d1565971cb14d86d77c09496f152784034f97",
"script_hex": "02fd130004787efc6a04c85ad2180885f0f76a9b1400000a636b706f6f6c",
"script_ascii": "ckpool",
"bip34_height": 5117,
"bip54": {
"locktime": 5116,
"expected_locktime": 5116,
"locktime_ok": true,
"sequence": 4278190079,
"sequence_hex": "0xfeffffff",
"sequence_ok": true,
"compliant": true
},
"witness_commitment": true
},
"messages": []
}GET /tx/{txid}
Одна транзакция, подтверждённая или ещё в мемпуле: входы с предыдущими выходами, выходы со статусом потраченности, комиссия, ставка комиссии и статус подтверждения.
| Параметр | Где | Что делает |
|---|---|---|
txid | path | 64-символьный идентификатор транзакции. |
Пример запроса
curl -s 'https://api.testnet5.com/explorer/v1/tx/fc21f67d10bd9418aa3249e8491d1565971cb14d86d77c09496f152784034f97'Пример ответа (живые данные, сокращены)
{
"txid": "fc21f67d10bd9418aa3249e8491d1565971cb14d86d77c09496f152784034f97",
"wtxid": "38399ae66b5b65f5c72f6536f53d0ec7e9bb73024cb965501dc9b45ff725dd49",
"version": 1,
"locktime": 5116,
"size": 195,
"vsize": 168,
"weight": 672,
"fee": 0,
"fee_rate": 0.0,
"coinbase": true,
"total_in": 0,
"total_out": 5000000369,
"status": {
"confirmed": true,
"height": 5117,
"block_hash": "00000000000000b7c44302f1acbe13ab9a8e2ef06f9e25e42b0c3e8277cbd2e3",
"time": 1794932344,
"index": 0,
"confirmations": 9
},
"vin": [
{
"coinbase": true,
"script_hex": "02fd130004787efc6a04c85ad2180885f0f76a9b1400000a636b706f6f6c",
"script_ascii": "ckpool",
"sequence": 4278190079
}
],
"vout": [
{
"n": 0,
"address": "tb1q6pt2vtrfx4d7g7rkqzm3ca9xvcedfp99ax955r",
"value": 5000000369,
"script_type": "witness_v0_keyhash",
"script_asm": "0 d056a62c69355be4787600b71c74a66632d484a5",
"script_hex": "0014d056a62c69355be4787600b71c74a66632d484a5",
"op_return": null,
"spent": false,
"spent_txid": null,
"spent_vin": null,
"spent_height": null
}
],
"rbf": false,
"bip54": {
"locktime": 5116,
"expected_locktime": 5116,
"locktime_ok": true,
"sequence": 4278190079,
"sequence_hex": "0xfeffffff",
"sequence_ok": true,
"compliant": true
},
"bip34_height": 5117
}GET /address/{address}
Баланс и история адреса Testnet5: подтверждённый баланс, всего получено и отправлено, неподтверждённые изменения и транзакции, сначала самые новые, по 25 на страницу.
| Параметр | Где | Что делает |
|---|---|---|
address | path | Адрес Testnet5 (tb1q..., tb1p... или устаревший формат). |
page | query | Страница истории, начиная с 0. |
Пример запроса
curl -s 'https://api.testnet5.com/explorer/v1/address/tb1qs6qdr9p7actxvr74ygjgrkrsymg373ynca32v9'Пример ответа (живые данные, сокращены)
{
"address": "tb1qs6qdr9p7actxvr74ygjgrkrsymg373ynca32v9",
"script_type": "witness_v0",
"script_pubkey": "00148680d1943eee16660fd5222481d87026d11f4493",
"balance": 0,
"received": 5000000000,
"sent": 5000000000,
"tx_count": 2,
"utxo_count": 0,
"output_count": 1,
"coinbase_count": 0,
"first_seen_height": 5036,
"unconfirmed_balance": 0,
"unconfirmed": [],
"page": 0,
"page_size": 25,
"tip": 5125,
"txs": [
{
"txid": "7194ca0680af250459dc6e43be86234b0563356fda8fd29912117a0462514e37",
"height": 5039,
"time": 1794927194,
"delta": -5000000000,
"coinbase": false,
"confirmations": 87
}
]
}GET /address/{address}/utxo
Непотраченные подтверждённые выходы адреса, сначала самые новые, до 200.
| Параметр | Где | Что делает |
|---|---|---|
address | path | Адрес Testnet5. |
Пример запроса
curl -s 'https://api.testnet5.com/explorer/v1/address/tb1q6pt2vtrfx4d7g7rkqzm3ca9xvcedfp99ax955r/utxo'Пример ответа (живые данные, сокращены)
{
"address": "tb1q6pt2vtrfx4d7g7rkqzm3ca9xvcedfp99ax955r",
"utxos": [
{
"txid": "8187c413c5634fde15cb714420a055afb8e14650cc6a97bd2fb13ca3024329c2",
"n": 0,
"value": 5000000000,
"height": 5123
},
{
"txid": "e68ffefb9aa84e816a2158b0f78b2cf940180e47a6484e9e5a5c9c0ecb74959d",
"n": 0,
"value": 5000000000,
"height": 5122
}
]
}GET /search
Определяет, чем является строка. Возвращает тип (block, tx или address) и идентификатор для следующего запроса либо 404, если совпадений нет.
| Параметр | Где | Что делает |
|---|---|---|
q | query | Высота блока, хеш блока, txid или адрес. Обязательный параметр. |
Пример запроса
curl -s 'https://api.testnet5.com/explorer/v1/search?q=5117'Пример ответа (живые данные, сокращены)
{
"type": "block",
"id": 5117
}GET /mempool
Сводка мемпула плюс до 50 самых новых неподтверждённых транзакций.
Параметров нет.
Пример запроса
curl -s 'https://api.testnet5.com/explorer/v1/mempool'Пример ответа (живые данные, сокращены)
{
"info": {
"count": 0,
"vbytes": 0,
"total_fee": 0,
"min_fee_rate": 0.09999999999999999
},
"txs": []
}GET /richlist
50 адресов с наибольшим подтверждённым непотраченным балансом. Обновляется примерно раз в минуту.
Параметров нет.
Пример запроса
curl -s 'https://api.testnet5.com/explorer/v1/richlist'Пример ответа (живые данные, сокращены)
{
"addresses": [
{
"address": "tb1qrg00se0gauwh5cra3gmvsxcufvldwzj8hnztm5",
"balance": 6413762317833,
"utxos": 1791
},
{
"address": "tb1pcmxl8ac44rpu8rknffkuszczl5lfnt55ju74jqeygjyz0jw094asxv49ez",
"balance": 4619286658360,
"utxos": 1041
}
]
}GET /faucet
Статус крана Testnet5 только для чтения: баланс, сумма за запрос, лимиты, пауза и недавние выплаты. Получить монеты можно только на странице крана.
Параметров нет.
Пример запроса
curl -s 'https://api.testnet5.com/explorer/v1/faucet'Пример ответа (живые данные, сокращены)
{
"address": "tb1qs6qdr9p7actxvr74ygjgrkrsymg373ynca32v9",
"balance": 4998999718,
"pending": 0,
"amount": 1000000,
"available": true,
"empty": false,
"daily_cap": 200000000,
"paid_24h": 1000000,
"claims_24h": 1,
"address_hours": 24,
"ip_hours": 24,
"address_max_claims": 6,
"ip_max_claims": 6,
"cooldown_seconds": 600,
"fee_rate": 2,
"total_claims": 1,
"total_paid": 1000000,
"recent": [
{
"time": 1794927119,
"address": "tb1qgn0m…8xvwv0",
"amount": 1000000,
"txid": "7194ca0680af250459dc6e43be86234b0563356fda8fd29912117a0462514e37"
}
]
}Методы пула
Они относятся к майнинговому пулу Testnet5.com. Пути заданы относительно https://api.testnet5.com/api/pools/testnet5. Хотите майнить? См. Начать майнинг.
GET /api/pools/testnet5
Сводка пула: комиссия, схема выплат, минимальная выплата, сложности портов stratum, хешрейт пула и сети, число блоков, всего выплачено и текущие лидеры среди майнеров. Это сам базовый URL, поэтому вызывайте его, не добавляя путь.
Параметров нет.
Пример запроса
curl -s 'https://api.testnet5.com/api/pools/testnet5'Пример ответа (живые данные, сокращены)
{
"pool": {
"id": "testnet5",
"coin": {
"symbol": "BTC",
"name": "Bitcoin"
},
"ports": {
"3333": {
"name": "Standard (vardiff)",
"difficulty": 4096
},
"3334": {
"name": "High diff (rentals)",
"difficulty": 262144
}
},
"paymentProcessing": {
"minimumPayment": 0.0001,
"payoutScheme": "PROP"
},
"poolFeePercent": 10,
"address": "tb1qt6vrvd992zcprxdc2qc89283aay4440gcajapa",
"poolStats": {
"connectedMiners": 2,
"poolHashrate": 86327566480033.16
},
"networkStats": {
"blockHeight": 5236,
"networkDifficulty": 16777216,
"networkHashrate": 1589237865826132,
"lastNetworkBlockTime": "2026-11-17T17:48:04.4314108Z"
},
"topMiners": [
{
"miner": "tb1q7e3cusesz3t9z7k8flvknwe2qdh9duam2nskve",
"hashrate": 334802191325056.7,
"sharesPerSecond": 0.068
}
],
"totalPaid": 5579.9998,
"totalBlocks": 127,
"totalConfirmedBlocks": 124,
"totalPendingBlocks": 3,
"blockReward": 50,
"lastPoolBlockTime": "2026-11-17T17:27:03.440484Z",
"poolEffort": 1.662005753111382
}
}GET /blocks
Блоки, найденные пулом Testnet5.com, сначала самые новые, со статусом (ожидание, подтверждён или сиротский), ходом подтверждений и адресом, который нашёл каждый блок.
| Параметр | Где | Что делает |
|---|---|---|
page | query | Страница, начиная с 0. |
pageSize | query | Элементов на странице. |
Пример запроса
curl -s 'https://api.testnet5.com/api/pools/testnet5/blocks?pageSize=1'Пример ответа (живые данные, сокращены)
[
{
"poolId": "testnet5",
"blockHeight": 5125,
"networkDifficulty": 16777216,
"status": "pending",
"confirmationProgress": 0,
"transactionConfirmationData": "93fe6549929db3b7292629222be6995def6647141e693020e95dd1367ffa86e9",
"reward": 0.0,
"infoLink": "https://www.blockchain.com/btc/block/00000000000000956b5ba02850c549024c87093f4b4aae9539660ea9668c7abf",
"hash": "00000000000000956b5ba02850c549024c87093f4b4aae9539660ea9668c7abf",
"miner": "tb1q8rxrlkfzmy8qec6d8p40mzt6sapken7yws5fjn",
"source": "testnet5",
"created": "2026-11-17T16:23:03.177597Z",
"directRecipientOutputs": []
}
]GET /payments
Выплаты, отправленные пулом, сначала самые новые.
| Параметр | Где | Что делает |
|---|---|---|
page | query | Страница, начиная с 0. |
pageSize | query | Элементов на странице. |
Пример запроса
curl -s 'https://api.testnet5.com/api/pools/testnet5/payments?pageSize=1'Пример ответа (живые данные, сокращены)
[
{
"coin": "BTC",
"address": "tb1q8rxrlkfzmy8qec6d8p40mzt6sapken7yws5fjn",
"addressInfoLink": "https://www.blockchain.com/btc/address/tb1q8rxrlkfzmy8qec6d8p40mzt6sapken7yws5fjn",
"amount": 52.3921,
"transactionConfirmationData": "c86ea5d056cc2c47fef865bb078229f19093f4d2be6c939a0329331b2e0420ac",
"transactionInfoLink": "https://www.blockchain.com/btc/tx/c86ea5d056cc2c47fef865bb078229f19093f4d2be6c939a0329331b2e0420ac",
"created": "2026-11-17T16:17:53.04924Z"
}
]GET /miners
Майнеры, которые сейчас активны на пуле, с текущим хешрейтом.
| Параметр | Где | Что делает |
|---|---|---|
page | query | Страница, начиная с 0. |
pageSize | query | Элементов на странице. |
Пример запроса
curl -s 'https://api.testnet5.com/api/pools/testnet5/miners?pageSize=2'Пример ответа (живые данные, сокращены)
[
{
"miner": "tb1q7e3cusesz3t9z7k8flvknwe2qdh9duam2nskve",
"hashrate": 334802191325056.7,
"sharesPerSecond": 0.068
},
{
"miner": "tb1qakc7jq9qxu2tyep3sd5m5ya75gym5269pn7cq6",
"hashrate": 268424128573518.66,
"sharesPerSecond": 0.177
}
]GET /miners/{address}
Статистика одного майнера: ожидающий баланс, всего выплачено, последняя выплата и почасовые выборки хешрейта по каждому воркеру.
| Параметр | Где | Что делает |
|---|---|---|
address | path | Tb1-адрес, на который майнер добывает. |
Пример запроса
curl -s 'https://api.testnet5.com/api/pools/testnet5/miners/tb1q7e3cusesz3t9z7k8flvknwe2qdh9duam2nskve'Пример ответа (живые данные, сокращены)
{
"pendingShares": 0,
"pendingBalance": 1.9567696e-05,
"totalPaid": 2653.5928,
"todayPaid": 2653.5928,
"bestSessionShare": 0,
"bestShare": 0,
"minerEffort": 0,
"lastPayment": "2026-11-17T14:17:52.950996Z",
"lastPaymentLink": "https://www.blockchain.com/btc/tx/3d3709f764efb3dbeb22e177e6b5542c809b6e4721fc9bedb8476d5b9656d76b",
"performanceSamples": [
{
"created": "2026-11-17T04:00:00Z",
"workers": {
"": {
"hashrate": 181456217470982.28,
"sharesPerSecond": 0.0795294117647059,
"bestSessionShare": 0,
"bestShare": 0
}
}
}
],
"totalConfirmedBlocks": 55,
"totalPendingBlocks": 0
}GET /performance
Почасовой хешрейт пула, число подключённых майнеров и сложность сети примерно за последние сутки.
Параметров нет.
Пример запроса
curl -s 'https://api.testnet5.com/api/pools/testnet5/performance'Пример ответа (живые данные, сокращены)
{
"stats": [
{
"poolHashrate": 97378756469736.14,
"connectedMiners": 2,
"validSharesPerSecond": 0,
"networkHashrate": 960180178855915.6,
"networkDifficulty": 16777216,
"created": "2026-11-17T16:00:00Z"
}
]
}Короткий пример
Вывести текущую высоту и сложность Testnet5 из командной строки:
curl -s https://api.testnet5.com/explorer/v1/stats | jq '{height, difficulty}'
Или с веб-страницы:
const r = await fetch('https://api.testnet5.com/explorer/v1/stats');
const s = await r.json();
console.log(s.height, s.difficulty);
Вопросы по API или что-то не работает? Загляните в FAQ.