Testnet5エクスプローラー API
Testnet5 ブロックチェーンと Testnet5.com プール向けの、無料の公開 JSON API です。キーも登録も不要です。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 - 読み取り専用。 すべてのエンドポイントは、JSON を返す通常の HTTPS
GETです。 - ウェブページから使えます。 応答はどのオリジンからのリクエストも許可するので、ブラウザアプリから API を直接呼べます。
- 単位。 エクスプローラーの金額はサトシ(1 tBTC5 = 100,000,000 sats)、時刻は Unix 秒です。プールの金額は整数の tBTC5、プールの時刻は UTC の ISO 8601 です。
- テストコインのみ。 Testnet5 のコインに価値はありません。プール API はコインを "BTC" と表示し、情報リンクはメインネットのエクスプローラーを指すので、それらのリンクは無視して、こちらで調べてください。
公正な利用とレート制限
この API は人、スクリプト、ボットに無料で公開されています。皆が速く使えるよう、リクエストは IP アドレスごとにレート制限されます。正確な上限は予告なく変わることがあります。
- 定常的なポーリングは、おおよそ1秒に1リクエスト程度にしてください。新しいブロックは平均して数分ごとに来るので、
/statsを10〜30秒ごとに取るだけで十分です。 - 応答には短い
Cache-Controlの有効期間が付きます。すぐ再取得するのではなく、手元でキャッシュして使い回してください。 - HTTP
429(リクエスト過多)または503(混雑)を受けたら、数秒待って再試行し、そのたびに待ち時間を長くしてください。 - チェーンの完全なコピーが必要なら、すべてのブロックをクロールするのではなく、自分のノードを動かしてください。Testnet5 ノードを動かす をご覧ください。
サービスを損なうトラフィックは遮断されることがあります。API に稼働保証はなく、Testnet5 チェーン自体がリセットされる可能性もあります。
エラー
エクスプローラーのエラーは、HTTP ステータスコード付きの JSON で返されます。不正なリクエスト(無効なアドレスなど)は 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文字のハッシュで1つのブロック。ヘッダー項目、coinbase の詳細(BIP 34 の高さと BIP 54 の検査を含む)、トランザクション(1ページあたり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}
確認済み、またはまだメモリプールにある1件のトランザクション。以前の出力付きの入力、使用状況付きの出力、手数料、手数料率、確認状態。
| パラメータ | 場所 | 役割 |
|---|---|---|
txid | path | 64文字のトランザクション ID。 |
リクエストの例
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 アドレスの残高と履歴。確認済み残高、受取合計と送付合計、未確認の増減、トランザクション(新しい順、1ページあたり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)と次に調べる ID を返すか、一致がなければ 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アドレス。約1分ごとに更新されます。
パラメータはありません。
リクエストの例
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 フォーセットの読み取り専用の状態。残高、1回あたりの金額、上限、待機時間、最近の支払い。コインの受け取りは フォーセットのページ でのみ行えます。
パラメータはありません。
リクエストの例
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 | 1ページあたりの件数。 |
リクエストの例
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 | 1ページあたりの件数。 |
リクエストの例
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 | 1ページあたりの件数。 |
リクエストの例
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}
1人のマイナーの統計。保留中の残高、支払済み合計、前回の支払い、ワーカーごとの1時間ごとのハッシュレート標本。
| パラメータ | 場所 | 役割 |
|---|---|---|
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
おおよそ過去1日分の、1時間ごとのプールハッシュレート、接続中のマイナー数、ネットワーク難易度。
パラメータはありません。
リクエストの例
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 をご確認ください。