Testnet5 explorer API
A free, public JSON API for the Testnet5 blockchain and the Testnet5.com pool. No key and no sign-up. It's the same data that powers the Testnet5 explorer and the pool stats pages.
Testnet5 is still a proposal (Bitcoin Core PR #35861) and hasn't been merged into Bitcoin Core. The chain could be reset or might never launch officially. [BIP 95, Draft]
The basics
- Explorer base URL:
https://api.testnet5.com/explorer/v1 - Pool base URL:
https://api.testnet5.com/api/pools/testnet5 - Read only. Every endpoint is a plain HTTPS
GETthat returns JSON. - Use it from a web page. Responses allow requests from any origin, so a browser app can call the API directly.
- Units. Explorer amounts are in satoshis (1 tBTC5 = 100,000,000 sats) and explorer times are Unix seconds. Pool amounts are in whole tBTC5 and pool times are ISO 8601 in UTC.
- Test coins only. Testnet5 coins have no value. The pool API labels the coin "BTC" and its info links point to a mainnet explorer, so ignore those links and look things up here instead.
Fair use and rate limits
The API is free for people, scripts and bots. To keep it fast for everyone, requests are rate limited per IP address. Exact limits can change without notice.
- Keep it to about one request per second for steady polling. New blocks arrive every few minutes on average, so polling
/statsevery 10 to 30 seconds is plenty. - Responses carry a short
Cache-Controllifetime. Cache on your side and reuse responses instead of asking again right away. - If you get HTTP
429(too many requests) or503(busy), back off and retry after a few seconds, with a longer wait each time. - For a full copy of the chain, run your own node instead of crawling every block. See Run a Testnet5 node.
Traffic that hurts the service can be blocked. The API comes with no uptime guarantee, and the Testnet5 chain itself could be reset.
Errors
Explorer errors come back as JSON with an HTTP status code: 400 for a malformed request (for example, an invalid address) and 404 when nothing matches.
{"error": "not a valid Testnet5 address"}
Explorer endpoints
All paths below are relative to 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
Chain summary: height, best block hash, difficulty, estimated network hashrate, average block time, next retarget, coins issued, the mempool summary and the latest blocks and transactions.
No parameters.
Example request
curl -s 'https://api.testnet5.com/explorer/v1/stats'Sample response (live data, trimmed)
{
"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
Network health: hashrate over several windows (12, 144 and 1,008 blocks, and since the last retarget), mempool fee data, and which pools found recent blocks, by coinbase tag.
No parameters.
Example request
curl -s 'https://api.testnet5.com/explorer/v1/network'Sample response (live data, trimmed)
{
"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
Recent blocks, newest first.
| Parameter | Where | What it does |
|---|---|---|
limit | query | How many blocks to return, 1 to 50. Default 25. |
before | query | Only return blocks below this height. Use it to page back through the chain. |
Example request
curl -s 'https://api.testnet5.com/explorer/v1/blocks?limit=2'Sample response (live data, trimmed)
{
"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}
One block by height or 64-character hash: header fields, coinbase details (including BIP 34 height and BIP 54 checks) and its transactions, 25 per page.
| Parameter | Where | What it does |
|---|---|---|
height or hash | path | A block height like 5117, or a block hash. |
page | query | Transaction page, starting at 0. |
Example request
curl -s 'https://api.testnet5.com/explorer/v1/block/5117'Sample response (live data, trimmed)
{
"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}
One transaction, confirmed or still in the mempool: inputs with their previous outputs, outputs with spent status, fee, fee rate and confirmation status.
| Parameter | Where | What it does |
|---|---|---|
txid | path | A 64-character transaction id. |
Example request
curl -s 'https://api.testnet5.com/explorer/v1/tx/fc21f67d10bd9418aa3249e8491d1565971cb14d86d77c09496f152784034f97'Sample response (live data, trimmed)
{
"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}
Balance and history for a Testnet5 address: confirmed balance, total received and sent, unconfirmed changes, and its transactions, newest first, 25 per page.
| Parameter | Where | What it does |
|---|---|---|
address | path | A Testnet5 address (tb1q..., tb1p..., or legacy). |
page | query | History page, starting at 0. |
Example request
curl -s 'https://api.testnet5.com/explorer/v1/address/tb1qs6qdr9p7actxvr74ygjgrkrsymg373ynca32v9'Sample response (live data, trimmed)
{
"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
Unspent confirmed outputs for an address, newest first, up to 200.
| Parameter | Where | What it does |
|---|---|---|
address | path | A Testnet5 address. |
Example request
curl -s 'https://api.testnet5.com/explorer/v1/address/tb1q6pt2vtrfx4d7g7rkqzm3ca9xvcedfp99ax955r/utxo'Sample response (live data, trimmed)
{
"address": "tb1q6pt2vtrfx4d7g7rkqzm3ca9xvcedfp99ax955r",
"utxos": [
{
"txid": "8187c413c5634fde15cb714420a055afb8e14650cc6a97bd2fb13ca3024329c2",
"n": 0,
"value": 5000000000,
"height": 5123
},
{
"txid": "e68ffefb9aa84e816a2158b0f78b2cf940180e47a6484e9e5a5c9c0ecb74959d",
"n": 0,
"value": 5000000000,
"height": 5122
}
]
}GET /search
Works out what a string is. It returns the type (block, tx or address) and the id to look up next, or a 404 if nothing matches.
| Parameter | Where | What it does |
|---|---|---|
q | query | A block height, block hash, txid or address. Required. |
Example request
curl -s 'https://api.testnet5.com/explorer/v1/search?q=5117'Sample response (live data, trimmed)
{
"type": "block",
"id": 5117
}GET /mempool
Mempool summary plus up to 50 of the newest unconfirmed transactions.
No parameters.
Example request
curl -s 'https://api.testnet5.com/explorer/v1/mempool'Sample response (live data, trimmed)
{
"info": {
"count": 0,
"vbytes": 0,
"total_fee": 0,
"min_fee_rate": 0.09999999999999999
},
"txs": []
}GET /richlist
The 50 addresses with the largest confirmed unspent balance. Updated about once a minute.
No parameters.
Example request
curl -s 'https://api.testnet5.com/explorer/v1/richlist'Sample response (live data, trimmed)
{
"addresses": [
{
"address": "tb1qrg00se0gauwh5cra3gmvsxcufvldwzj8hnztm5",
"balance": 6413762317833,
"utxos": 1791
},
{
"address": "tb1pcmxl8ac44rpu8rknffkuszczl5lfnt55ju74jqeygjyz0jw094asxv49ez",
"balance": 4619286658360,
"utxos": 1041
}
]
}GET /faucet
Read-only status of the Testnet5 faucet: balance, amount per claim, limits, cooldown and recent payouts. Claiming coins is only possible on the faucet page.
No parameters.
Example request
curl -s 'https://api.testnet5.com/explorer/v1/faucet'Sample response (live data, trimmed)
{
"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"
}
]
}Pool endpoints
These cover the Testnet5.com mining pool. Paths are relative to https://api.testnet5.com/api/pools/testnet5. Want to mine? See Start mining.
GET /api/pools/testnet5
Pool summary: fee, payout scheme, minimum payout, stratum port difficulties, pool and network hashrate, block counts, total paid and the current top miners. This one is the base URL itself, so call it without adding a path.
No parameters.
Example request
curl -s 'https://api.testnet5.com/api/pools/testnet5'Sample response (live data, trimmed)
{
"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.01,
"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
Blocks found by the Testnet5.com pool, newest first, with status (pending, confirmed or orphaned), confirmation progress and the address that found each one.
| Parameter | Where | What it does |
|---|---|---|
page | query | Page, starting at 0. |
pageSize | query | Items per page. |
Example request
curl -s 'https://api.testnet5.com/api/pools/testnet5/blocks?pageSize=1'Sample response (live data, trimmed)
[
{
"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
Payouts sent by the pool, newest first.
| Parameter | Where | What it does |
|---|---|---|
page | query | Page, starting at 0. |
pageSize | query | Items per page. |
Example request
curl -s 'https://api.testnet5.com/api/pools/testnet5/payments?pageSize=1'Sample response (live data, trimmed)
[
{
"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
Miners active on the pool right now, with their current hashrate.
| Parameter | Where | What it does |
|---|---|---|
page | query | Page, starting at 0. |
pageSize | query | Items per page. |
Example request
curl -s 'https://api.testnet5.com/api/pools/testnet5/miners?pageSize=2'Sample response (live data, trimmed)
[
{
"miner": "tb1q7e3cusesz3t9z7k8flvknwe2qdh9duam2nskve",
"hashrate": 334802191325056.7,
"sharesPerSecond": 0.068
},
{
"miner": "tb1qakc7jq9qxu2tyep3sd5m5ya75gym5269pn7cq6",
"hashrate": 268424128573518.66,
"sharesPerSecond": 0.177
}
]GET /miners/{address}
One miner's stats: pending balance, total paid, last payment and hourly hashrate samples per worker.
| Parameter | Where | What it does |
|---|---|---|
address | path | The tb1 address the miner mines to. |
Example request
curl -s 'https://api.testnet5.com/api/pools/testnet5/miners/tb1q7e3cusesz3t9z7k8flvknwe2qdh9duam2nskve'Sample response (live data, trimmed)
{
"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
Hourly pool hashrate, connected miners and network difficulty for about the last day.
No parameters.
Example request
curl -s 'https://api.testnet5.com/api/pools/testnet5/performance'Sample response (live data, trimmed)
{
"stats": [
{
"poolHashrate": 97378756469736.14,
"connectedMiners": 2,
"validSharesPerSecond": 0,
"networkHashrate": 960180178855915.6,
"networkDifficulty": 16777216,
"created": "2026-11-17T16:00:00Z"
}
]
}Quick example
Print the current Testnet5 height and difficulty from the command line:
curl -s https://api.testnet5.com/explorer/v1/stats | jq '{height, difficulty}'
Or from a web page:
const r = await fetch('https://api.testnet5.com/explorer/v1/stats');
const s = await r.json();
console.log(s.height, s.difficulty);
Questions about the API, or something broken? Check the FAQ.