/api/indicators/halving
GET一部

ビットコイン半減期のカウントダウンと履歴

ビットコイン半減期のカウントダウンと履歴

GET/api/indicators/halving
部分的なカバレッジ. ブロック高はライブの値です。`current_difficulty`には、ネットワークの難易度とそのタイムスタンプおよびソースが含まれます。`difficulty`(難易度調整の進捗)は、そのソースが利用できない間`null`になります。

リクエスト

このエンドポイントにパラメータはありません。

リクエスト例

curl -s "https://www.coinboss.com/api/indicators/halving"

レスポンスフィールド

フィールド表は実際のレスポンスから生成しているため、エンドポイントが返す内容をそのまま反映しています。パスでは、配列の要素をa[]、銘柄や取引所などの動的な名前をキーとするオブジェクトを{*}で表します。

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
fetched_atnumbermsCoinBossがソースからデータを取得した時刻。
heightnumber—ブロック高。
halvingobject—現在のブロック高から算出した、ビットコイン半減期のカウントダウン。
halving.epochnumbercountすでに発生した半減期の回数:floor(ブロック高 ÷ 210,000)。
halving.last_halving_heightnumberblocks直近の半減期のブロック高。
halving.next_halving_heightnumberblocks次回の半減期が発生するブロック高。
halving.remaining_blocksnumberblocks次回の半減期までの残りブロック数。
halving.progress_pctnumber%現在の210,000ブロックのエポックにおける進捗:(ブロック高 − `last_halving_height`) ÷ 210,000 × 100。
halving.avg_block_msnumberms公開のブロックチェーンデータソースに基づく直近の平均ブロック間隔。利用できない場合は600000を使用します。
halving.eta_msnumberms次回の半減期の推定時刻:現在時刻 + `remaining_blocks` × `avg_block_ms`。ブロック間隔に応じて変動する推定値です。
halving.current_rewardnumberBTC現在のブロック補助金:50 ÷ 2^`epoch`。
halving.next_rewardnumberBTC次回の半減期後のブロック補助金:`current_reward`の半分。
halving.historyarray—履歴データポイント。特記がない限り古い順。
halving.history[]object—履歴データポイント。特記がない限り古い順。
halving.history[].heightnumber—ブロック高。
halving.history[].datestring—暦日(UTC)。
halving.history[].rewardnumberBTCその半減期以降に適用されたブロック補助金。
difficultynull—常にnull:次回の難易度調整の推定値は提供していません。
current_difficultyobject—ビットコインの現在のマイニング難易度と、その読み取り時刻。
current_difficulty.valuenumber—値。
current_difficulty.as_ofnumberms難易度を読み取った時刻。
current_difficulty.sourcestring—値の取得元。
sourcesobject—データソース。
sources.heightstring—ブロック高。
sources.block_intervalstring—`avg_block_ms`のソース名。デフォルトの10分を使用した場合はnull。
sources.current_difficultystring—難易度の値の取得元。

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": [ … 2 ]
      },
    • "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_PARAM400必須パラメータが不足しているか、値が受け付けられません。該当するパラメータが特定できる場合は、`param`にその名前が入ります。そのまま再試行せず、リクエストを修正してください。
UNAUTHORIZED401`CB-API-KEY`ヘッダーが送信されましたが、キーが不明か失効済みです。公開データにキーは不要です。ヘッダーを外すか、有効なキーを使用してください。そのまま再試行しないでください。
FORBIDDEN403このルートは公開APIに含まれません(内部用またはアカウント専用)。再試行しないでください。
NOT_FOUND404不明なルートであるか、リクエストされた銘柄 / 取引所 / ファンドが存在しません。再試行せず、パスと識別子をカタログと照合してください。
RATE_LIMITED429リクエスト数が1分あたりの上限を超えました。`Retry-After`に待機すべき秒数が示されます。`Retry-After`で示された時間だけ待ってから、バックオフ付きで再試行してください。
INTERNAL500予期しないサーバーエラーです。メッセージは意図的に汎用的な内容にしています。報告の際は`request_id`を引用してください。数秒後に1回だけ再試行してください。解消しない場合は、リクエストIDを添えて報告してください。
UPSTREAM_FAILED503このエンドポイントの背後にあるデータソースが時間内に応答しませんでした。鮮度切れの数値や代替の数値を代わりに返すことはありません。バックオフ付きで再試行し、ステータスページを確認してください。
UNAVAILABLE501 / 503データセットが一時的に準備できていない(キャッシュのウォームアップ中)か、このエンドポイントに適法な公開ソースがまだありません。時間をおいて再試行してください。仕様上利用できないエンドポイントは、カタログに明示されています。
REQUEST_FAILED200一部の古いエンドポイントは、HTTP 200で`success: false`を返します。HTTPステータスだけでなく、必ず`success`を確認してください。メッセージによって異なります。失敗したリクエストとして扱ってください。

試してみる

GET/api/indicators/halving一部
パラメータ

パラメータはありません。

リクエストURLhttps://www.coinboss.com/api/indicators/halving
エンドポイントを選択して「リクエストを送信」を押してください。レスポンス、ヘッダー、所要時間がここに表示されます。