GET一部
ビットコイン半減期のカウントダウンと履歴
ビットコイン半減期のカウントダウンと履歴
GET
/api/indicators/halving部分的なカバレッジ. ブロック高はライブの値です。`current_difficulty`には、ネットワークの難易度とそのタイムスタンプおよびソースが含まれます。`difficulty`(難易度調整の進捗)は、そのソースが利用できない間`null`になります。
リクエスト
このエンドポイントにパラメータはありません。
リクエスト例
curl -s "https://www.coinboss.com/api/indicators/halving"レスポンスフィールド
フィールド表は実際のレスポンスから生成しているため、エンドポイントが返す内容をそのまま反映しています。パスでは、配列の要素をa[]、銘柄や取引所などの動的な名前をキーとするオブジェクトを{*}で表します。
| フィールド | 型 | 単位 | 説明 |
|---|---|---|---|
| success | boolean | — | リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。 |
| fetched_at | number | ms | CoinBossがソースからデータを取得した時刻。 |
| height | number | — | ブロック高。 |
| halving | object | — | 現在のブロック高から算出した、ビットコイン半減期のカウントダウン。 |
| halving.epoch | number | count | すでに発生した半減期の回数:floor(ブロック高 ÷ 210,000)。 |
| halving.last_halving_height | number | blocks | 直近の半減期のブロック高。 |
| halving.next_halving_height | number | blocks | 次回の半減期が発生するブロック高。 |
| halving.remaining_blocks | number | blocks | 次回の半減期までの残りブロック数。 |
| halving.progress_pct | number | % | 現在の210,000ブロックのエポックにおける進捗:(ブロック高 − `last_halving_height`) ÷ 210,000 × 100。 |
| halving.avg_block_ms | number | ms | 公開のブロックチェーンデータソースに基づく直近の平均ブロック間隔。利用できない場合は600000を使用します。 |
| halving.eta_ms | number | ms | 次回の半減期の推定時刻:現在時刻 + `remaining_blocks` × `avg_block_ms`。ブロック間隔に応じて変動する推定値です。 |
| halving.current_reward | number | BTC | 現在のブロック補助金:50 ÷ 2^`epoch`。 |
| halving.next_reward | number | BTC | 次回の半減期後のブロック補助金:`current_reward`の半分。 |
| halving.history | array | — | 履歴データポイント。特記がない限り古い順。 |
| halving.history[] | object | — | 履歴データポイント。特記がない限り古い順。 |
| halving.history[].height | number | — | ブロック高。 |
| halving.history[].date | string | — | 暦日(UTC)。 |
| halving.history[].reward | number | BTC | その半減期以降に適用されたブロック補助金。 |
| difficulty | null | — | 常にnull:次回の難易度調整の推定値は提供していません。 |
| current_difficulty | object | — | ビットコインの現在のマイニング難易度と、その読み取り時刻。 |
| current_difficulty.value | number | — | 値。 |
| current_difficulty.as_of | number | ms | 難易度を読み取った時刻。 |
| current_difficulty.source | string | — | 値の取得元。 |
| sources | object | — | データソース。 |
| sources.height | string | — | ブロック高。 |
| sources.block_interval | string | — | `avg_block_ms`のソース名。デフォルトの10分を使用した場合はnull。 |
| sources.current_difficulty | string | — | 難易度の値の取得元。 |
2026-11-11 23:01 UTCに1件の実レスポンスから生成。
レスポンス例
/api/indicators/halving · 実際のレスポンス(2026-11-13 03:53:39 UTCに取得)。 長い配列とマップは表示用に短縮しています:halving.historyは4件。
- "success"true
- "fetched_at"1794542020750
- "height"975627
- "halving"
- "epoch"4
- "last_halving_height"840000
- "next_halving_height"1050000
- "remaining_blocks"74373
- "progress_pct"64.58
- "avg_block_ms"776283
- "eta_ms"1852276516309
- "current_reward"3.125
- "next_reward"1.5625
- "history"
- "difficulty"null
- "current_difficulty"
- "value"148364561003867
- "as_of"1794542020750
- "source""blockchain.info"
- "sources"
- "height""blockchain.info"
- "block_interval""blockchain.info"
- "current_difficulty""blockchain.info"
詳細
- 認証
- 不要。公開エンドポイントです。
- レート制限
- IPごとに毎分1200リクエスト
- サーバーキャッシュ
- 2m
- エッジマイクロキャッシュ
- 10s
- 更新頻度
- リクエスト時に取得し、2分間キャッシュ
- ウィンドウ
- 最新スナップショット
- データソース
- 公開のブロックチェーンAPIが報告する現在のブロック高から自社で算出した、ビットコイン半減期のカウントダウンです。
- 取引所カバレッジ
- ビットコインのみ。`difficulty`は常にnullです。
- 単位
- blocks; milliseconds (avg_block_ms, eta_ms); BTC (block reward); percent (progress)
- 算出方法
- Next halving height = (epoch + 1) x 210000; ETA = now + remaining blocks x average block interval (600 s fallback); reward = 50 / 2^epoch.
- タイムスタンプ
- フィールドの説明に別途記載がない限り、Unixエポックミリ秒(UTC)
- レスポンス形式
- json
- 安定性
- 安定版
ライブステータス
一部2026-11-13 03:53:39 UTCにチェックHTTP 2001461 msスキーマ一致
ブロック高はライブの値です。`current_difficulty`には、ネットワークの難易度とそのタイムスタンプおよびソースが含まれます。`difficulty`(難易度調整の進捗)は、そのソースが利用できない間`null`になります。
可用性(過去30日間)
407回のチェック中100%が合格
エラー
失敗した呼び出しは、すべてのエンドポイントで共通の形式で返されます。一覧はエラーページにあります。 エラーとレート制限 →
| コード | HTTP | 意味 | 対処方法 |
|---|---|---|---|
| INVALID_PARAM | 400 | 必須パラメータが不足しているか、値が受け付けられません。該当するパラメータが特定できる場合は、`param`にその名前が入ります。 | そのまま再試行せず、リクエストを修正してください。 |
| UNAUTHORIZED | 401 | `CB-API-KEY`ヘッダーが送信されましたが、キーが不明か失効済みです。公開データにキーは不要です。ヘッダーを外すか、有効なキーを使用してください。 | そのまま再試行しないでください。 |
| FORBIDDEN | 403 | このルートは公開APIに含まれません(内部用またはアカウント専用)。 | 再試行しないでください。 |
| NOT_FOUND | 404 | 不明なルートであるか、リクエストされた銘柄 / 取引所 / ファンドが存在しません。 | 再試行せず、パスと識別子をカタログと照合してください。 |
| RATE_LIMITED | 429 | リクエスト数が1分あたりの上限を超えました。`Retry-After`に待機すべき秒数が示されます。 | `Retry-After`で示された時間だけ待ってから、バックオフ付きで再試行してください。 |
| INTERNAL | 500 | 予期しないサーバーエラーです。メッセージは意図的に汎用的な内容にしています。報告の際は`request_id`を引用してください。 | 数秒後に1回だけ再試行してください。解消しない場合は、リクエストIDを添えて報告してください。 |
| UPSTREAM_FAILED | 503 | このエンドポイントの背後にあるデータソースが時間内に応答しませんでした。鮮度切れの数値や代替の数値を代わりに返すことはありません。 | バックオフ付きで再試行し、ステータスページを確認してください。 |
| UNAVAILABLE | 501 / 503 | データセットが一時的に準備できていない(キャッシュのウォームアップ中)か、このエンドポイントに適法な公開ソースがまだありません。 | 時間をおいて再試行してください。仕様上利用できないエンドポイントは、カタログに明示されています。 |
| REQUEST_FAILED | 200 | 一部の古いエンドポイントは、HTTP 200で`success: false`を返します。HTTPステータスだけでなく、必ず`success`を確認してください。 | メッセージによって異なります。失敗したリクエストとして扱ってください。 |
試してみる
GET
/api/indicators/halving一部パラメータ
パラメータはありません。
リクエストURL
https://www.coinboss.com/api/indicators/halvingエンドポイントを選択して「リクエストを送信」を押してください。レスポンス、ヘッダー、所要時間がここに表示されます。
このカテゴリの他のエンドポイント
- マルチチェーンのアドレス照会 /api/browser/:chain/address/:addr
- マルチチェーンのブロック照会 /api/browser/:chain/block/:hashOrHeight
- マルチチェーンのトランザクション照会 /api/browser/:chain/tx/:txid
- アドレスがアクティブなEVMチェーンの検出 /api/browser/detect
- BTCリッチリストアドレスの残高変化 /api/btc/rich-flow
- BTCリッチリスト /api/btc/rich-list
- BTCリッチリスト統計 /api/btc/rich-stat
- BTCリッチリストの保有量推移 /api/btc/rich-trend
- ビットコインアドレスのサマリー /api/explorer/address/:addr
- ビットコインアドレスのトランザクション /api/explorer/address/:addr/txs
- ビットコインブロックの詳細 /api/explorer/block/:hashOrHeight
- ビットコインチェーンの先端 /api/explorer/tip
- ビットコイントランザクションの詳細 /api/explorer/tx/:txid
- しきい値を超えるBTCを保有するアドレス数 /api/indicators/addr-above/:tier
- BTCオンチェーンバリュエーション指標の系列 /api/indicators/bdc/:name
- ビットコインの到達可能ノード数と分布 /api/indicators/bitnodes
- BTC保有者の比較系列 /api/indicators/btccmp/:pair
- BTCオンチェーンチャート系列 /api/indicators/chain
- 取引所のBTC流入/流出履歴 /api/indicators/cm/exchange-flows
- 取引所が保有するBTC供給量 /api/indicators/cm/exchange-supply
- BTC非ゼロアドレス数の履歴 /api/indicators/cm/nonzero-addresses
- 各国政府のBTC保有量 /api/indicators/gov-treasuries
- ビットコイン半減期のカウントダウンと履歴 /api/indicators/halving
- N年を超えて動いていないBTC供給量の割合 /api/indicators/hodl-wave-above/:years
- ビットコインマイニングプールのブロックシェア /api/indicators/mempool/pools
- StrategyのBTC取得原価と保有量の履歴 /api/indicators/mstr-cost
- 含み益状態にあるBTC供給量の割合 /api/indicators/supply-profit-pct
- WBTC準備金残高の履歴 /api/indicators/wbtc-balance
- マルチチェーンリッチリスト /api/rich-list/:chain
- マルチチェーンリッチリストの残高変化 /api/rich-list/:chain/flow
- マルチチェーンリッチリスト統計 /api/rich-list/:chain/stat
- マルチチェーンリッチリストの保有量推移 /api/rich-list/:chain/trend
- 上場企業/機関投資家の暗号資産保有状況 /api/treasuries/:coin