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

銘柄詳細の概要

銘柄詳細の概要（価格、時価総額、供給量、デリバティブのサマリー）

GET/api/currency/overview

リクエスト

クエリパラメータ

名前型必須デフォルト指定可能な値説明
coinstring必須——ベース銘柄のシンボル（大文字。例：BTC）。 例: BTC

リクエスト例

curl -s "https://www.coinboss.com/api/currency/overview?coin=BTC"

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
dataobject—ペイロード。
data.coinstring—銘柄シンボル（大文字。例：BTC）。
data.supplyobject—供給量（コイン数）。
data.supply.price_usdstring(decimal)USD価格。
data.supply.market_cap_usdstring(decimal)USD時価総額。
data.supply.mcap_ranknumber—時価総額による順位。
data.supply.vol_24h_usdstring(decimal)USD24h出来高。
data.supply.circulatingstring(decimal)—循環供給量（コイン数）。
data.supply.total_supplystring(decimal)—総供給量（コイン数）。
data.supply.max_supplystring(decimal)|null—最大供給量（コイン数）。無制限または不明の場合はnull。
data.supply.change_24h_pctstring(decimal)%24hの変化率（%）。
data.supply.image_urlstring—CoinBossが配信する同一オリジンのアイコンパス。検証済みのアイコンがない場合はnull。
data.supply.website_urlstring—プロジェクトの公式Webサイト（銘柄メタデータに基づく）。
data.supply.reddit_urlstring|null—プロジェクトのサブレディット。掲載がない場合はnull。
data.supply.github_urlstring|null—プロジェクトの主要なソースコードリポジトリ。掲載がない場合はnull。
data.supply.whitepaper_urlstring—プロジェクトのホワイトペーパーへのリンク。
data.supply.explorer_urlstring—その銘柄のブロックエクスプローラーへのリンク。
data.supply.categorystring—カテゴリ。
data.supply.asofnumberms使用した最新データの時刻。
data.supply.staleboolean—鮮度ウィンドウより古いデータの行、またはそのフラグ。
data.supply.spot_vol_usdnumberUSDCoinBossが自社で収集している現物取引所における、銘柄の24h現物出来高の合計（最新スナップショット）。収集していない場合はnull。
data.supply.futures_vol_usdnumberUSDティッカーが1時間以内に更新されている全取引所の24h先物出来高の合計。`futures_vol.total_usd`と同じ値です。自社データがない場合はnull。
data.supply.oi_total_usdnumberUSD全取引所・全契約種別を通じた銘柄の集計建玉。`oi.total_usd`と同じ値です。自社データがない場合はnull。
data.supply.high_24hstring(decimal)—24h高値。
data.supply.low_24hstring(decimal)—24h安値。
data.futures_vol_chg_pctnumber%先物出来高の24h変化：現在と約24時間前の1時間ごとのスナップショットの両方に存在する取引所を対象に、(Σ 現在 − Σ 前回) ÷ Σ 前回で算出します。
data.oi_chg_pctnumber%現在と、24時間前に最も近い1時間ごとのスナップショットの両方に存在する契約を対象に算出した、建玉の24h変化。
data.oiobject—建玉。
data.oi.total_usdnumberUSD合計。
data.oi.local_usdnumberUSDCoinBoss自社の取引所別収集データから合計した建玉。`oi.total_usd`と同一です。
data.oi.by_exchangearray—取引所別の内訳。
data.oi.by_exchange[]object—取引所別の内訳。
data.oi.by_exchange[].exchangestring—取引所ID（小文字。例：`binance`）。
data.oi.by_exchange[].oi_usdnumberUSDUSD建て想定元本での建玉。
data.oi.n_exchangesnumber—集計に寄与した取引所の数。
data.oi.asofnumberms使用した最新データの時刻。
data.oi.chg_basisobject—`oi_chg_pct`の入力値：対応付けた現在と前回の合計（`cur`、`prev`）、一致した取引所の数、基準時刻、値が動かないため除外された契約。
data.oi.chg_basis.curnumber—現在値。
data.oi.chg_basis.prevnumber—前回値（基準値）。
data.oi.chg_basis.n_matchednumber—比較の両端に存在する項目。
data.oi.chg_basis.prev_hour_tsnumberms直前の1時間バケットの開始時刻。
data.oi.chg_basis.frozen_excludedobject—ソースの値が動かなかったために除外された行。
data.oi.chg_basis.frozen_excluded.n_baselinenumber—基準スナップショット内の項目。
data.oi.chg_basis.frozen_excluded.n_currentnumber—現在のスナップショット内の項目。
data.oi.chg_basis.frozen_excluded.cur_usdnumberUSD現在値。
data.oi.chg_basis.frozen_excluded.prev_usdnumberUSD基準値。
data.futures_volobject—先物出来高。
data.futures_vol.total_usdnumberUSD合計。
data.futures_vol.n_exchangesnumber—集計に寄与した取引所の数。
data.futures_vol.chg_basisobject—`futures_vol_chg_pct`の入力値：対応付けた現在と前回の出来高合計（`cur`、`prev`）、一致した取引所の数、基準時刻。
data.futures_vol.chg_basis.curnumber—現在値。
data.futures_vol.chg_basis.prevnumber—前回値（基準値）。
data.futures_vol.chg_basis.n_matchednumber—比較の両端に存在する項目。
data.futures_vol.chg_basis.prev_hour_tsnumberms直前の1時間バケットの開始時刻。
data.fundingnumber—資金調達率のブロックまたは値。
data.funding_detailobject—`funding`の内訳：8h正規化レートの単純平均と建玉加重平均、年率換算レート、取引所数、取引所ごとのエントリー。
data.funding_detail.basisstring—先物価格から現物価格を引いた値、またはベーシスのブロック。
data.funding_detail.avg_8hnumber—8h正規化レートの平均値。
data.funding_detail.oi_weighted_8hnumber—8h正規化レートの建玉加重平均。
data.funding_detail.apr_pctnumber% per year年率換算のパーセント値。
data.funding_detail.n_exchangesnumber—集計に寄与した取引所の数。
data.funding_detail.n_normalizednumber—8hに正規化された取引所。
data.funding_detail.n_unknown_intervalnumber—資金調達間隔が不明な取引所。
data.funding_detail.by_exchangearray—取引所別の内訳。
data.funding_detail.by_exchange[]object—取引所別の内訳。
data.funding_detail.by_exchange[].exchangestring—取引所ID（小文字。例：`binance`）。
data.funding_detail.by_exchange[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
data.funding_detail.by_exchange[].ratenumber—レート。
data.funding_detail.by_exchange[].interval_hnumberh間隔。
data.funding_detail.by_exchange[].rate_8hnumber—8時間に正規化したレート。
data.funding_detail.by_exchange[].next_funding_timenumber|nullmsタイムスタンプ。
data.long_shortobject—ロング/ショートのブロック。
data.long_short.longnumber—ロング側の値。
data.long_short.shortnumber—ショート側の値。
data.long_short.rationumber—比率。
data.long_short.typestring—種別。
data.long_short.n_exchangesnumber—集計に寄与した取引所の数。
data.derivedobject—銘柄について定期的に再計算される指標（RSI、ベーシス、集計建玉、平均資金調達率、ロング/ショートの割合、24hの清算）。未計算の場合はnull。
data.derived.rsi_1hstring(decimal)—1h足のRSI(14)。
data.derived.rsi_4hstring(decimal)—4h足のRSI(14)。
data.derived.rsi_1dstring(decimal)—日足のRSI(14)。
data.derived.basis_pctstring(decimal)|null%(futures − spot) / spot × 100。
data.derived.basis_annual_pctnull% per year満期日までの日数で年率換算したベーシス。
data.derived.oi_usd_aggstring(decimal)USD直近の指標更新時点における、全取引所・全契約種別を通じた集計建玉。`oi.total_usd`よりわずかに遅れることがあります。
data.derived.funding_avgstring(decimal)—取引所横断の平均資金調達率。
data.derived.ls_accountstring(decimal)—アカウントベースのロング/ショート比率。
data.derived.ls_takerstring(decimal)|null—テイカー買い/売り比率。
data.derived.liq_24h_usdstring(decimal)USD24h清算。
data.liquidationobject—清算のブロック。 動的キー: 1h,4h,12h,24h
data.liquidation.{*}object—清算のブロック。
data.liquidation.{*}.winstring—エントリーのウィンドウラベル。キーと同じ値です（`1h`、`4h`、`12h`、`24h`のいずれか）。
data.liquidation.{*}.long_usdnumberUSDロング側。
data.liquidation.{*}.short_usdnumberUSDショート側。
data.liquidation.{*}.total_usdnumberUSD合計。
data.liquidation.{*}.cntnumber—件数。

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

レスポンス例

/api/currency/overview?coin=BTC · 実際のレスポンス（2026-11-13 03:57:31 UTCに取得）。 長い配列とマップは表示用に短縮しています：data.liquidationは4件; data.oi.by_exchangeは22件; data.funding_detail.by_exchangeは23件。

  • {
    • "success": true,
    • "data": {
      • "coin": "BTC",
      • "supply": { … 22 },
      • "futures_vol_chg_pct": 67.76,
      • "oi_chg_pct": -3.65,
      • "oi": { … 6 },
      • "futures_vol": { … 3 },
      • "funding": 0.000057831612725940206,
      • "funding_detail": { … 8 },
      • "long_short": { … 5 },
      • "derived": { … 10 },
      • "liquidation": { … 2 }
      }
    }

検証済みサンプル

上の例に加えて、プローブは以下のパラメータでもこのエンドポイントを呼び出し、毎回スキーマを検証しています。

パラメータHTTPレイテンシ結果
coin=ETH20086 ms合格
coin=SOL20081 ms合格
coin=ARKM20079 ms合格

2026-11-13 03:57:31 UTCにチェック

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
30s
エッジマイクロキャッシュ
10s
更新頻度
第三者のマーケットデータアグリゲーターは10分ごと。ティッカーは1 minごと。OI/資金調達率/ロング/ショートは5 minごと（主要銘柄は1 minごと）。現物出来高は10 minごと。インメモリキャッシュ30 s
ウィンドウ
出来高/清算は24hローリング。OI/資金調達率/ロング/ショートは最新スナップショット
データソース
供給量、時価総額、順位は第三者のマーケットデータアグリゲーターから取得しています。価格、建玉、資金調達率、ロング/ショート、先物および現物の出来高は取引所の公開APIから自社で集計し、清算は取引所の清算ストリームから取得しています。
取引所カバレッジ
第三者のマーケットデータアグリゲーターに基づくテーブルに含まれる銘柄、またはデリバティブ契約が上場している銘柄
ページネーション
なし
単位
USD; rates as decimals; changes in percent
算出方法
OI = SUM(oi_usd) over fresh contracts incl. multiplier contracts (3h; CME 120h); funding = OI-weighted mean of rate normalized to 8h (rate * 8 / interval_hours)
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版

ライブステータス

利用可能2026-11-13 03:57:31 UTCにチェックHTTP 20095 msスキーマ一致最新データポイントは20s前

可用性（過去30日間）

411回のチェック中99.76%が合格

エラー

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

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

string — Base coin symbol (uppercase, e.g. BTC).

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