GET利用可能ベータ
サイト全体のセクションサマリー
サイト全体のセクションサマリー(コンテンツページ用)
GET
/api/content/summaryリクエスト
このエンドポイントにパラメータはありません。
リクエスト例
curl -s "https://www.coinboss.com/api/content/summary"レスポンスフィールド
フィールド表は実際のレスポンスから生成しているため、エンドポイントが返す内容をそのまま反映しています。パスでは、配列の要素をa[]、銘柄や取引所などの動的な名前をキーとするオブジェクトを{*}で表します。
| フィールド | 型 | 単位 | 説明 |
|---|---|---|---|
| success | boolean | — | リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。 |
| now | number | ms | レスポンスを生成した時点のサーバー時刻。 |
| exchanges | object | — | 取引所。 |
| exchanges.count | number | — | 項目数。 |
| exchanges.total_vol | number | USD | 全取引所を合計した24h先物出来高(株式連動契約を除く)。 |
| exchanges.total_oi | number | — | 建玉の合計。 |
| exchanges.total_contracts | number | count | 全取引所の先物契約ティッカーの数(株式連動契約を除く)。 |
| exchanges.top3 | array | — | 上位3件のエントリー。 |
| exchanges.top3[] | object | — | 上位3件のエントリー。 |
| exchanges.top3[].name | string | — | 名前。 |
| exchanges.top3[].vol | number | — | 出来高。 |
| exchanges.top3[].share_pct | number | % | 合計に占める割合。 |
| exchanges.dex_share_vol_pct | number | % | `total_vol`のうち、分散型の無期限先物取引所で取引された割合。 |
| exchanges.dex_share_oi_pct | number | % | `total_oi`のうち、分散型の無期限先物取引所で保有されている割合。 |
| exchanges.stock_vol_excluded | number | USD | `total_vol`から除外された株式連動契約の24h出来高。 |
| funding | object | — | 資金調達率のブロックまたは値。 |
| funding.weighted_pct | number | % | 暗号資産のUSDT無期限先物の現在の資金調達率を建玉で加重した値。資金調達間隔あたりのパーセントです(レートは8時間に正規化していません)。 |
| funding.top_pos | array | — | 建玉が300,000 USD以上のUSDT無期限先物のうち、現在の資金調達率が最も高い3件。 |
| funding.top_pos[] | object | — | 1契約分:`base`(銘柄)、`ex`(取引所の表示名)、`rate_pct`。 |
| funding.top_pos[].base | string | — | ベース資産のシンボル。 |
| funding.top_pos[].ex | string | — | 取引所ID(小文字)。 |
| funding.top_pos[].rate_pct | number | % | その契約の現在の資金調達率(パーセント)。その契約自身の資金調達間隔あたりの値です。 |
| funding.top_neg | array | — | 建玉が300,000 USD以上のUSDT無期限先物のうち、現在の資金調達率が最も低い(最もマイナスの)3件。 |
| funding.top_neg[] | object | — | 1契約分:`base`(銘柄)、`ex`(取引所の表示名)、`rate_pct`。 |
| funding.top_neg[].base | string | — | ベース資産のシンボル。 |
| funding.top_neg[].ex | string | — | 取引所ID(小文字)。 |
| funding.top_neg[].rate_pct | number | % | その契約の現在の資金調達率(パーセント)。その契約自身の資金調達間隔あたりの値です。 |
| funding.intervals | object | — | 間隔。 |
| funding.intervals.h1_pct | number | % | 直近24時間に資金調達の決済が16回以上あった契約の割合(1時間ごとに分類)。 |
| funding.intervals.h4_pct | number | % | 直近24時間に資金調達の決済が5〜15回あった契約の割合(4時間ごとに分類)。 |
| funding.intervals.h8_pct | number | % | 直近24時間に資金調達の決済が5回未満だった契約の割合(8時間ごとに分類)。 |
| oi | object | — | 建玉。 |
| oi.total | number | — | 合計。 |
| oi.chg24_pct | number | % | 約24時間前の1時間ごとのスナップショットに対する建玉合計の変化。両方に存在する契約が対象です。スナップショットがない場合はnull。 |
| oi.gainers | array | — | 上昇率上位。 |
| oi.gainers[] | object | — | 上昇率上位。 |
| oi.gainers[].base | string | — | ベース資産のシンボル。 |
| oi.gainers[].oi | number | — | 建玉。 |
| oi.gainers[].chg_pct | number | % | 変化率(%)。 |
| oi.losers | array | — | 下落率上位。 |
| oi.losers[] | object | — | 下落率上位。 |
| oi.losers[].base | string | — | ベース資産のシンボル。 |
| oi.losers[].oi | number | — | 建玉。 |
| oi.losers[].chg_pct | number | % | 変化率(%)。 |
| oi.top_ex | array | — | 建玉が最も大きい3取引所。 |
| oi.top_ex[] | object | — | 1取引所分:`name`、`oi`(USD)、`share_pct`(`oi.total`に対する%)。 |
| oi.top_ex[].name | string | — | 名前。 |
| oi.top_ex[].oi | number | — | 建玉。 |
| oi.top_ex[].share_pct | number | % | 合計に占める割合。 |
| market | object | — | 市場。 |
| market.total_oi | number | — | 建玉の合計。 |
| market.liq_total | number | USD | 直近24時間のロング清算とショート清算の合計(株式連動契約を除く)。 |
| market.liq_long | number | — | 清算されたロング。 |
| market.liq_short | number | — | 清算されたショート。 |
| market.up_cnt | number | count | 時価総額上位500銘柄のうち、24h価格変化がプラスの銘柄数。 |
| market.down_cnt | number | count | 時価総額上位500銘柄のうち、24h価格変化がマイナスの銘柄数。 |
| market.btc_dom_pct | number | % | BTCの時価総額 ÷ 追跡対象銘柄の時価総額合計 × 100。時価総額スナップショットが利用できない場合はnull。 |
| stocks | object | — | 直近12時間以内のティッカーがある株式連動の無期限先物契約:原資産数、契約数、取引所数、24h出来高、上位3つの原資産。 |
| stocks.underlyings | number | — | 原資産シンボル。 |
| stocks.contracts | number | — | 契約ごとの行。 |
| stocks.vol | number | — | 出来高。 |
| stocks.exchanges | number | — | 取引所。 |
| stocks.top3 | array | — | 上位3件のエントリー。 |
| stocks.top3[] | object | — | 上位3件のエントリー。 |
| stocks.top3[].u | string | — | 原資産となる株式またはETFのティッカー。 |
| stocks.top3[].vol | number | — | 出来高。 |
| preipo | object | — | 株式連動契約のうちプレIPO(合成)の原資産:件数、24h出来高、最高価格、最大の価格スプレッド。 |
| preipo.underlyings | number | — | 原資産シンボル。 |
| preipo.vol | number | — | 出来高。 |
| preipo.top_price | object | — | 出来高加重の契約価格が最も高いプレIPO原資産(`u`、`price`)。取引されているものがない場合はnull。 |
| preipo.top_price.u | string | — | その原資産の名称。 |
| preipo.top_price.price | number | — | 建値通貨での直近価格(特記がない限りUSDまたはUSDT)。 |
| preipo.max_spread | object | — | 契約間の価格差が最も大きいプレIPO原資産(`u`、`spread_pct`、`pmin`、`pmax`)。契約が2つ以上ある原資産がない場合はnull。 |
| preipo.max_spread.u | string | — | その原資産の名称。 |
| preipo.max_spread.spread_pct | number | % | (`pmax` − `pmin`) ÷ `pmin` × 100。 |
| preipo.max_spread.pmin | number | USD | 各取引所を通じた、その原資産の現在の契約価格の最安値。 |
| preipo.max_spread.pmax | number | USD | 各取引所を通じた、その原資産の現在の契約価格の最高値。 |
2026-11-11 23:01 UTCに1件の実レスポンスから生成。
レスポンス例
/api/content/summary · 実際のレスポンス(2026-11-13 03:59:32 UTCに取得)。 長い配列とマップは表示用に短縮しています:oi.losersは3件; oi.top_exは3件; oi.gainersは3件; stocks.top3は3件; exchanges.top3は3件; funding.top_negは3件。
- "success"true
- "now"1794542372009
- "exchanges"
- "count"25
- "total_vol"176285468302.16
- "total_oi"107132161363.71
- "total_contracts"10843
- "top3"
- "dex_share_vol_pct"8.3
- "dex_share_oi_pct"11.3
- "stock_vol_excluded"41399911752.17
- "funding"
- "weighted_pct"0.0045
- "top_pos"
- "top_neg"
- "intervals"
- "oi"
- "total"107132161363.71
- "chg24_pct"-3.93
- "gainers"
- "losers"
- "top_ex"
- "market"
- "total_oi"107132161363.71
- "liq_total"1363492414.84
- "liq_long"1267532610.54
- "liq_short"95959804.3
- "up_cnt"150
- "down_cnt"327
- "btc_dom_pct"57.4
- "stocks"
- "underlyings"648
- "contracts"2338
- "vol"41305485625.189865
- "exchanges"18
- "top3"
- "preipo"
- "underlyings"3
- "vol"2217117745.7
- "top_price"
- "max_spread"
詳細
- 認証
- 不要。公開エンドポイントです。
- レート制限
- IPごとに毎分1200リクエスト
- サーバーキャッシュ
- 10m
- エッジマイクロキャッシュ
- 10s
- 更新頻度
- ティッカーは1 minごと。OI/資金調達率は5 minごと。APIキャッシュ600 s
- ウィンドウ
- 24h
- データソース
- 取引所データから自社で集計したサイト全体のサマリー数値(取引所別の出来高シェアとOIシェア、資金調達率の極値、OI変動上位、清算、トークン化株式およびプレIPO契約の統計)です。BTCドミナンスと上昇/下落銘柄数は第三者のマーケットデータアグリゲーターに基づきます。
- 取引所カバレッジ
- 収集対象のすべてのデリバティブ取引所。トークン化株式の契約は暗号資産の合計から除外
- ページネーション
- なし
- 単位
- USD; percentages
- 算出方法
- funding.weighted_pct = SUM(rate * oi) / SUM(oi) * 100 over USDT perpetuals refreshed within 3h (not normalized to 8h); oi.chg24_pct compares contracts present both now and 24h ago
- タイムスタンプ
- フィールドの説明に別途記載がない限り、Unixエポックミリ秒(UTC)
- レスポンス形式
- json
- 安定性
- ベータ
ライブステータス
利用可能2026-11-13 03:59:32 UTCにチェックHTTP 200342 msスキーマ一致
可用性(過去30日間)
408回のチェック中99.75%が合格
エラー
失敗した呼び出しは、すべてのエンドポイントで共通の形式で返されます。一覧はエラーページにあります。 エラーとレート制限 →
| コード | 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/content/summary利用可能パラメータ
パラメータはありません。
リクエストURL
https://www.coinboss.com/api/content/summaryエンドポイントを選択して「リクエストを送信」を押してください。レスポンス、ヘッダー、所要時間がここに表示されます。
このカテゴリの他のエンドポイント
- データ品質マトリックス(コレクター視点) /api/sd/quality
- APIカタログ /api/meta/catalog
- 変更履歴とバージョニングポリシー /api/meta/changelog
- エンドポイントドキュメント /api/meta/endpoint
- OpenAPIドキュメント /api/meta/openapi
- データ品質マトリックス /api/meta/quality
- サービスステータス /api/meta/status
- 銘柄シンボルがプラットフォームに登録されているかの確認 /api/coin-exists
- 銘柄シンボルとローカルホストのアイコンパスの対応表 /api/coin-icons
- 銘柄ページの集約サマリー /api/content/coin
- サイト全体のセクションサマリー /api/content/summary
- 法定通貨の為替レート表 /api/currency/fx
- 取引所IDとローカルホストのアイコンパスの対応表 /api/exchange-icons
- 死活チェック /api/health
- リサーチページの統計 /api/research/stats