24h出来高—建玉—24h清算$1.36B24hロング/ショート—BTCドミナンス—ETHドミナンス—
アプリ
言語 ▾
¥ JPY ▾
/api/indicators/cycle-caps
GET利用可能

サイクル天井のバリュエーションバンド

サイクル天井のバリュエーションバンド（複数のキャップモデル）

GET/api/indicators/cycle-caps

リクエスト

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

リクエスト例

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

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
updated_atnumbermsこの行が最後に更新された時刻。
seriesobject—時系列。
series.pricearray—建値通貨での直近価格（特記がない限りUSDまたはUSDT）。
series.price[]array—建値通貨での直近価格（特記がない限りUSDまたはUSDT）。
series.price[][]number—建値通貨での直近価格（特記がない限りUSDまたはUSDT）。
series.topCaparray—BTCの日次Top Cap価格：35 × `avgPrice`。モデル推定値です。供給量は半減期スケジュールから導出しています。
series.topCap[]array—1日につき1つの`[timestamp, price]`ペア。
series.topCap[][]number—要素0は日のタイムスタンプ（Unix ms）、要素1は価格（USD）です。
series.avgPricearray—日次Average Cap価格：日次時価総額の累積平均 ÷ 推定供給量。モデル推定値です。
series.avgPrice[]array—1日につき1つの`[timestamp, price]`ペア。
series.avgPrice[][]number—要素0は日のタイムスタンプ（Unix ms）、要素1は価格（USD）です。
series.deltaToparray—日次Delta Top価格：7 × (実現価格 − `avgPrice`)。実現価格が正の日のみを含みます。モデル推定値です。
series.deltaTop[]array—1日につき1つの`[timestamp, price]`ペア。
series.deltaTop[][]number—要素0は日のタイムスタンプ（Unix ms）、要素1は価格（USD）です。

2026-11-11 23:01 UTCに1件の実レスポンスから生成。

レスポンス例

/api/indicators/cycle-caps · 実際のレスポンス（2026-11-13 03:53:33 UTCに取得）。 長い配列とマップは表示用に短縮しています：series.priceは5931件; series.topCapは5931件; series.avgPriceは5931件; series.deltaTopは1455件。

  • {
    • "success": true,
    • "updated_at": 1794541710712,
    • "series": {
      • "price": [ … 2 ],
      • "topCap": [ … 2 ],
      • "avgPrice": [ … 2 ],
      • "deltaTop": [ … 2 ]
      }
    }

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
30m
エッジマイクロキャッシュ
10s
更新頻度
日次データ。キャッシュはリクエスト時に遅延更新（多くても12時間に1回）
ウィンドウ
日次の全履歴（Delta Topは実現価格が利用可能な期間のみ。おおよそ直近4年間）
データソース
BTCの価格履歴と第三者の実現価格系列から自社で算出したサイクル天井価格モデルです。
取引所カバレッジ
BTCのみ。
ソート
日付の昇順
単位
USD
算出方法
Top Cap price = 35 x average cap / supply (average cap = cumulative mean of daily market cap); Delta Top = 7 x (realized price - average price).
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版

ライブステータス

利用可能2026-11-13 03:53:33 UTCにチェックHTTP 2003 msスキーマ一致最新データポイントは5m前

可用性（過去30日間）

407回のチェック中99.75%が合格

エラー

失敗した呼び出しは、すべてのエンドポイントで共通の形式で返されます。一覧はエラーページにあります。 エラーとレート制限 →

コード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/cycle-caps利用可能
パラメータ

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

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