24h出来高—建玉—24h清算$1.36B24hロング/ショート—BTCドミナンス—ETHドミナンス—
アプリ
言語 ▾
¥ JPY ▾
/api/sd/basis
GET低下STALE

先物ベーシス（全取引所）

無期限先物のベーシス（マーク価格対インデックス価格）、同一取引所における無期限先物対現物のベーシス、限月先物のベーシスと年率換算レートを契約ごとに返します。OI加重、出来高加重、中央値の集計値も含まれます。

GET/api/sd/basis
低下. エンドポイントが報告するデータ品質はSTALEです

リクエスト

クエリパラメータ

名前型必須デフォルト指定可能な値説明
coinstring必須——銘柄シンボル。大文字と小文字は区別しません（例：`BTC`）。値が未指定または不正な場合は400を返します。 例: BTC

リクエスト例

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

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
schemastring—このレスポンスのスキーマID。既存フィールドの意味または型が変わった場合にのみ変更されます。
nownumbermsレスポンスを生成した時点のサーバー時刻。
coinstring—銘柄シンボル（大文字）。
perpobject—無期限先物のベーシス：同じ取引所のインデックス価格に対するマーク価格。
perp.unitstring—ベーシス値の単位（パーセント）。
perp.aggregateobject—このセクションの取引所横断の集計値。
perp.aggregate.oi_weighted_pctnumber%建玉で加重したベーシス。OIウェイトのない行は除外されます。
perp.aggregate.oi_weight_usdnumberUSD使用した建玉ウェイトの合計。
perp.aggregate.n_oi_weightednumber—OIウェイトを持っていた行。
perp.aggregate.vol_weighted_pctnumber%24hの想定元本ベースの出来高で加重したベーシス。
perp.aggregate.vol_weight_usdnumberUSD使用した出来高ウェイトの合計。
perp.aggregate.n_vol_weightednumber—出来高ウェイトを持っていた行。
perp.aggregate.median_pctnumber%取引所ごとに主要契約1つを対象としたベーシスの中央値。
perp.aggregate.mean_pctnumber%中央値と同じ集合を対象とした単純平均。
perp.aggregate.n_exchangesnumber—集計値に含まれる取引所。
perp.aggregate.n_contractsnumber—集計値に含まれる契約。
perp.aggregate.minobject—ベーシスが最も低い取引所と契約。
perp.aggregate.min.exchangestring—取引所ID（小文字）。
perp.aggregate.min.symbolstring—CoinBossの保存形式での契約シンボル。
perp.aggregate.min.basis_pctnumber%無期限先物と限月先物では(mark − index) ÷ index × 100。ランキングでは取引所横断の中央値。
perp.aggregate.maxobject—ベーシスが最も高い取引所と契約。
perp.aggregate.max.exchangestring—取引所ID（小文字）。
perp.aggregate.max.symbolstring—CoinBossの保存形式での契約シンボル。
perp.aggregate.max.basis_pctnumber%無期限先物と限月先物では(mark − index) ÷ index × 100。ランキングでは取引所横断の中央値。
perp.aggregate.median_last_pctnumber%直近価格ベーシスの中央値。
perp.aggregate.n_exchanges_lastnumber—直近価格の中央値に含まれる取引所。
perp.aggregate.weightsobject—ウェイトの出所、その鮮度ウィンドウ、および最も古いウェイトの経過時間。
perp.aggregate.weights.oiobject—建玉。
perp.aggregate.weights.oi.sourcestring—データの収集元である上流の公開エンドポイント。
perp.aggregate.weights.oi.fresh_window_snumbersこれより古いウェイトは使用されません。
perp.aggregate.weights.oi.oldest_age_snumbers使用したウェイトのうち最も古いものの経過時間。
perp.aggregate.weights.oi.sidestring—建玉ウェイトが片側ベースかどうか。
perp.aggregate.weights.volobject—出来高。
perp.aggregate.weights.vol.sourcestring—データの収集元である上流の公開エンドポイント。
perp.aggregate.weights.vol.fresh_window_snumbersこれより古いウェイトは使用されません。
perp.aggregate.weights.vol.oldest_age_snumbers使用したウェイトのうち最も古いものの経過時間。
perp.contractsarray—契約ごとに1行。
perp.contracts[]object—契約ごとに1行。
perp.contracts[].exchangestring—取引所ID（小文字）。
perp.contracts[].symbolstring—CoinBossの保存形式での契約シンボル。
perp.contracts[].native_symbolstring—取引所の表記どおりの契約シンボル。
perp.contracts[].quotestring—契約の建値通貨。
perp.contracts[].margin_typestring—契約の証拠金タイプ（例：USDT建て、コイン証拠金型）。
perp.contracts[].multipliernumber—建値1単位あたりのコイン数（`1000PEPE`型の契約では1000）。ベーシスには影響しません。
perp.contracts[].mark_pricenumber|null—取引所が公表するマーク価格。
perp.contracts[].index_pricenumber|null—取引所が公表するインデックス価格。
perp.contracts[].last_pricenumber|null—直近の約定価格。
perp.contracts[].index_kindstring|null—インデックスの種類：`exchange_index`、`oracle`、または表示はされるが集計には含まれないその他の種類。
perp.contracts[].basis_pctnumber|null%無期限先物と限月先物では(mark − index) ÷ index × 100。ランキングでは取引所横断の中央値。
perp.contracts[].basis_absnumber|null—mark − index（建値通貨建て）。
perp.contracts[].basis_last_pctnumber|null%(last − index) ÷ index × 100。直近の約定がない場合は`null`。
perp.contracts[].basis_last_reasonstring|null—`basis_last_pct`がnullである理由。
perp.contracts[].index_lag_snumber|nulls行のマーク価格のタイムスタンプとインデックス価格のタイムスタンプの差（秒）。
perp.contracts[].oi_usdnumber|nullUSD契約の建玉（片側）。ウェイトとして使用します。
perp.contracts[].vol_usd_24hnumber|nullUSD契約の24h想定元本ベースの出来高。ウェイトとして使用します。
perp.contracts[].primaryboolean—中央値と平均において取引所を代表する契約の場合はtrue。
perp.contracts[].in_aggregateboolean—行が算入ルールを満たした場合はtrue。
perp.contracts[].excluded_reasonstring|null—行が集計値に含まれない理由。
perp.contracts[].last_tsnumber|nullms直近の約定時刻。
perp.contracts[].observed_atnumber|nullmsソースがデータに付与したタイムスタンプ。
perp.contracts[].received_atnumbermsCoinBossのコレクターがデータを受信した時刻。
perp.contracts[].age_snumbers行を受信してからの経過秒数。
spot_perpobject—同じ取引所の現物価格に対する無期限先物価格。
spot_perp.unitstring—ベーシス値の単位（パーセント）。
spot_perp.aggregateobject—このセクションの取引所横断の集計値。
spot_perp.aggregate.oi_weighted_pctnumber%建玉で加重したベーシス。OIウェイトのない行は除外されます。
spot_perp.aggregate.oi_weight_usdnumberUSD使用した建玉ウェイトの合計。
spot_perp.aggregate.n_oi_weightednumber—OIウェイトを持っていた行。
spot_perp.aggregate.vol_weighted_pctnumber%24hの想定元本ベースの出来高で加重したベーシス。
spot_perp.aggregate.vol_weight_usdnumberUSD使用した出来高ウェイトの合計。
spot_perp.aggregate.n_vol_weightednumber—出来高ウェイトを持っていた行。
spot_perp.aggregate.median_pctnumber%取引所ごとに主要契約1つを対象としたベーシスの中央値。
spot_perp.aggregate.mean_pctnumber%中央値と同じ集合を対象とした単純平均。
spot_perp.aggregate.n_exchangesnumber—集計値に含まれる取引所。
spot_perp.aggregate.n_contractsnumber—集計値に含まれる契約。
spot_perp.aggregate.minobject—ベーシスが最も低い取引所と契約。
spot_perp.aggregate.min.exchangestring—取引所ID（小文字）。
spot_perp.aggregate.min.symbolstring—CoinBossの保存形式での契約シンボル。
spot_perp.aggregate.min.basis_pctnumber%無期限先物と限月先物では(mark − index) ÷ index × 100。ランキングでは取引所横断の中央値。
spot_perp.aggregate.maxobject—ベーシスが最も高い取引所と契約。
spot_perp.aggregate.max.exchangestring—取引所ID（小文字）。
spot_perp.aggregate.max.symbolstring—CoinBossの保存形式での契約シンボル。
spot_perp.aggregate.max.basis_pctnumber%無期限先物と限月先物では(mark − index) ÷ index × 100。ランキングでは取引所横断の中央値。
spot_perp.pairsarray—同じ取引所の無期限先物 / 現物のペアごとに1行。
spot_perp.pairs[]object—同じ取引所の無期限先物 / 現物のペアごとに1行。
spot_perp.pairs[].exchangestring—取引所ID（小文字）。
spot_perp.pairs[].symbolstring—CoinBossの保存形式での契約シンボル。
spot_perp.pairs[].spot_symbolstring—現物レグとして使用した現物市場。
spot_perp.pairs[].quotestring—契約の建値通貨。
spot_perp.pairs[].spot_multnumber—両方のレグが同じ数量に対する価格になるよう、現物価格に適用する係数。
spot_perp.pairs[].futures_pricenumber|null—使用した無期限先物価格。`price_kind`を参照してください。
spot_perp.pairs[].price_kindstring|null—使用した無期限先物価格の種類：`last`または`mark`。
spot_perp.pairs[].spot_pricenumber—現物の直近価格（`spot_mult`適用後）。
spot_perp.pairs[].basis_pctnumber|null%無期限先物と限月先物では(mark − index) ÷ index × 100。ランキングでは取引所横断の中央値。
spot_perp.pairs[].basis_last_pctnumber|null%(last − index) ÷ index × 100。直近の約定がない場合は`null`。
spot_perp.pairs[].basis_mark_pctnumber|null%(mark − spot) ÷ spot × 100。
spot_perp.pairs[].leg_gap_snumbers2つのレグのタイムスタンプの差（秒）。
spot_perp.pairs[].spot_time_kindstring—現物のタイムスタンプの種類（約定時刻または受信時刻）。
spot_perp.pairs[].spot_vol_24hnumber|null—現物市場の24h売買代金（建値通貨建て）。
spot_perp.pairs[].oi_usdnumber|nullUSD契約の建玉（片側）。ウェイトとして使用します。
spot_perp.pairs[].vol_usd_24hnumber|nullUSD契約の24h想定元本ベースの出来高。ウェイトとして使用します。
spot_perp.pairs[].primaryboolean—中央値と平均において取引所を代表する契約の場合はtrue。
spot_perp.pairs[].in_aggregateboolean—行が算入ルールを満たした場合はtrue。
spot_perp.pairs[].excluded_reasonstring|null—行が集計値に含まれない理由。
spot_perp.pairs[].received_atnumbermsCoinBossのコレクターがデータを受信した時刻。
spot_perp.pairs[].spot_received_atnumberms現物レグを受信した時刻。
deliveryobject—限月先物（デリバリー）のベーシス。
delivery.unitstring—ベーシス値の単位（パーセント）。
delivery.contractsarray—契約ごとに1行。
delivery.contracts[]object—契約ごとに1行。
delivery.contracts[].exchangestring—取引所ID（小文字）。
delivery.contracts[].symbolstring—CoinBossの保存形式での契約シンボル。
delivery.contracts[].native_symbolstring—取引所の表記どおりの契約シンボル。
delivery.contracts[].quotestring—契約の建値通貨。
delivery.contracts[].margin_typestring—契約の証拠金タイプ（例：USDT建て、コイン証拠金型）。
delivery.contracts[].expiry_tsnumberms限月契約の満期時刻。
delivery.contracts[].days_to_expirynumberdays満期までの日数。
delivery.contracts[].mark_pricenumber—取引所が公表するマーク価格。
delivery.contracts[].last_pricenumber|null—直近の約定価格。
delivery.contracts[].index_pricenumber—取引所が公表するインデックス価格。
delivery.contracts[].index_kindstring—インデックスの種類：`exchange_index`、`oracle`、または表示はされるが集計には含まれないその他の種類。
delivery.contracts[].basis_pctnumber%無期限先物と限月先物では(mark − index) ÷ index × 100。ランキングでは取引所横断の中央値。
delivery.contracts[].annualized_pctnumber|null% per yearbasis_pct × 365 ÷ 満期までの日数（単利）。満期まで1日未満の場合は`null`。
delivery.contracts[].basis_reasonnull—`basis_pct`がnullである理由。
delivery.contracts[].index_lag_snumbers行のマーク価格のタイムスタンプとインデックス価格のタイムスタンプの差（秒）。
delivery.contracts[].basis_last_pctnumber|null%(last − index) ÷ index × 100。直近の約定がない場合は`null`。
delivery.contracts[].annualized_last_pctnumber|null% per year直近の約定価格を用いた年率換算ベーシス。
delivery.contracts[].spot_symbolstring|null—現物レグとして使用した現物市場。
delivery.contracts[].spot_pricenumber|null—現物の直近価格（`spot_mult`適用後）。
delivery.contracts[].spot_price_kindstring|null—現物と比較した先物価格の種類。
delivery.contracts[].basis_spot_pctnumber|null%(先物 − 同一取引所の現物) ÷ 現物 × 100。
delivery.contracts[].annualized_spot_pctnumber|null% per year同一取引所の現物に対する年率換算ベーシス。
delivery.contracts[].annualized_reasonstring|null—年率換算値がnullである理由（例：`expiry_lt_1d`）。
delivery.contracts[].oi_usdnumber|nullUSD契約の建玉（片側）。ウェイトとして使用します。
delivery.contracts[].vol_usd_24hnumber|nullUSD契約の24h想定元本ベースの出来高。ウェイトとして使用します。
delivery.contracts[].last_tsnumber|nullms直近の約定時刻。
delivery.contracts[].observed_atnumber|nullmsソースがデータに付与したタイムスタンプ。
delivery.contracts[].received_atnumbermsCoinBossのコレクターがデータを受信した時刻。
delivery.contracts[].age_snumbers行を受信してからの経過秒数。
coverageobject—数値に含まれるものと含まれないもの。他のソースと合計値を比較する前に、まずこの内容を比較してください。
coverage.included_exchangesarray—鮮度内のデータが算入されているソース。
coverage.included_exchanges[]string—鮮度内のデータが算入されているソース。
coverage.unavailablearray—算入できなかったソース。それぞれ理由が付きます。0としてカウントされることはありません。
coverage.unavailable[]object—算入できなかったソース。それぞれ理由が付きます。0としてカウントされることはありません。
coverage.unavailable[].exchangestring—取引所ID（小文字）。
coverage.unavailable[].reasonstring—機械可読な理由コード。
coverage.unavailable[].detailstring—人が読める形式での理由の説明。
coverage.stale_excludedarray—最終更新が鮮度ウィンドウの外にあるため除外された行。 この表の生成に使用したサンプルでは空
coverage.missing_fieldsarray—いずれかの価格を公表していない取引所。
coverage.excluded_from_aggregatearray—表示はされるが集計値から除外された行。それぞれ理由が付きます。
coverage.excluded_from_aggregate[]object—表示はされるが集計値から除外された行。それぞれ理由が付きます。
coverage.excluded_from_aggregate[].exchangestring—取引所ID（小文字）。
coverage.excluded_from_aggregate[].symbolstring—CoinBossの保存形式での契約シンボル。
coverage.excluded_from_aggregate[].sectionstring—行が属するセクション。
coverage.excluded_from_aggregate[].reasonstring—機械可読な理由コード。
coverage.stock_excludedarray—ティッカーが同じであるため除外された株式無期限先物。 この表の生成に使用したサンプルでは空
coverage.dropped_delisted_rowsnumber—契約の更新が止まったため除外された行。
coverage.delivery_unavailablearray—限月契約を収集していない取引所。
coverage.delivery_unavailable[]object—限月契約を収集していない取引所。
coverage.delivery_unavailable[].exchangestring—取引所ID（小文字）。
coverage.delivery_unavailable[].reasonstring—機械可読な理由コード。
coverage.delivery_unavailable[].detailstring—人が読める形式での理由の説明。
methodobject—このレスポンスで使用した計算式を平文で記述したもの。フィールドごとに1エントリー。
method.perp.basis_pctstring—`perp.basis_pct`の計算式に関する注記（平文）。
method.perp.basis_last_pctstring—`perp.basis_last_pct`の計算式に関する注記（平文）。
method.perp.aggregate.oi_weighted_pctstring—`perp.aggregate.oi_weighted_pct`の計算式に関する注記（平文）。
method.perp.aggregate.vol_weighted_pctstring—`perp.aggregate.vol_weighted_pct`の計算式に関する注記（平文）。
method.perp.aggregate.median_pctstring—`perp.aggregate.median_pct`の計算式に関する注記（平文）。
method.perp.aggregate.inclusionstring—`perp.aggregate.inclusion`の計算式に関する注記（平文）。
method.spot_perp.basis_pctstring—`spot_perp.basis_pct`の計算式に関する注記（平文）。
method.spot_perp.aggregate.inclusionstring—`spot_perp.aggregate.inclusion`の計算式に関する注記（平文）。
method.delivery.basis_pctstring—`delivery.basis_pct`の計算式に関する注記（平文）。
method.delivery.annualized_pctstring—`delivery.annualized_pct`の計算式に関する注記（平文）。
method.index_lag_sstring—`index_lag_s`の計算式に関する注記（平文）。
method.multiplierstring—`multiplier`の計算式に関する注記（平文）。
metaobject—このレスポンスのデータリネージと鮮度。
meta.schemastring—このレスポンスのスキーマID。既存フィールドの意味または型が変わった場合にのみ変更されます。
meta.sourcearray—データの収集元である上流の公開エンドポイント。
meta.source[]object—データの収集元である上流の公開エンドポイント。
meta.source[].exchangestring—取引所ID（小文字）。
meta.source[].endpointstring—コレクターが読み取るソースの公開エンドポイント（データリネージのために表示。クライアントが呼び出すことはありません）。
meta.observed_atnumbermsソースがデータに付与したタイムスタンプ。
meta.received_atnumbermsCoinBossのコレクターがデータを受信した時刻。
meta.fetched_atnumbermsこのレスポンスが組み立てられた時刻。
meta.windowstring—数値が対象とする時間ウィンドウ。
meta.qualitystring—FRESH、PARTIAL、STALE、BROKEN、UNAVAILABLEのいずれか。データのタイムスタンプとカバレッジから判定します。
meta.is_staleboolean—データが鮮度ウィンドウより古い場合はtrue。
meta.cache_ttl_snumbersこのレスポンスのキャッシュ有効期間。
meta.fallbackstring—コレクターまたはソースに障害が発生した場合にエンドポイントが返す内容。
meta.collector_heartbeat_age_snumbersコレクターが稼働中であることを最後に報告してからの経過秒数。
coverage.missing_fields[]object—いずれかの価格を公表していない取引所。
coverage.missing_fields[].exchangestring—取引所ID（小文字）。
coverage.missing_fields[].symbolstring—CoinBossの保存形式での契約シンボル。
coverage.missing_fields[].missingstring—取引所が公表していない価格（`mark`または`index`）。

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

レスポンス例

/api/sd/basis?coin=BTC · 実際のレスポンス（2026-11-13 03:52:48 UTCに取得）。 長い配列とマップは表示用に短縮しています：meta.sourceは20件; perp.contractsは37件; spot_perp.pairsは22件; delivery.contractsは53件; coverage.unavailableは4件; coverage.included_exchangesは20件。

  • {
    • "success": true,
    • "schema": "coinboss.sd.basis/1",
    • "now": 1794541956692,
    • "coin": "BTC",
    • "perp": {
      • "unit": "percent",
      • "aggregate": { … 15 },
      • "contracts": [ … 1 ]
      },
    • "spot_perp": {
      • "unit": "percent",
      • "aggregate": { … 12 },
      • "pairs": [ … 1 ]
      },
    • "delivery": {
      • "unit": "percent",
      • "contracts": [ … 1 ]
      },
    • "coverage": {
      • "included_exchanges": [ … 8 ],
      • "unavailable": [ … 1 ],
      • "stale_excluded": [],
      • "missing_fields": [],
      • "excluded_from_aggregate": [ … 1 ],
      • "stock_excluded": [],
      • "dropped_delisted_rows": 0,
      • "delivery_unavailable": [ … 1 ]
      },
    • "method": {
      • "perp.basis_pct": "(mark_price - index_price) / index_price * 100, percent; mark and index are both published by the same exchange for that…",
      • "perp.basis_last_pct": "(last_price - index_price) / index_price * 100; null when the exchange gives no last-trade price or the last trade is mo…",
      • "perp.aggregate.oi_weighted_pct": "sum(basis_pct * oi_usd) / sum(oi_usd) over all included perpetual contracts that have an open-interest weight; oi_usd fr…",
      • "perp.aggregate.vol_weighted_pct": "same with 24h notional volume (market_tickers.volume_usd / sd_contract_latest.vol_usd_24h, <= 1 h old) as weight",
      • "perp.aggregate.median_pct": "median of basis_pct over one primary contract per exchange (largest OI, then volume, then USDT-margined); mean_pct is th…",
      • "perp.aggregate.inclusion": "row is fresh (<= 180 s), basis_pct is not null, index_kind is exchange_index or oracle, the contract traded within 24 h …",
      • "spot_perp.basis_pct": "(perp last_price, or mark_price when last is unusable - spot last price * spot_mult) / (spot last price * spot_mult) * 1…",
      • "spot_perp.aggregate.inclusion": "as perp, plus spot 24h turnover >= 10000 (quote currency) when the exchange reports it",
      • "delivery.basis_pct": "(F - S) / S * 100 with F = mark_price and S = the exchange index price of the underlying; basis_last_pct uses F = last_p…",
      • "delivery.annualized_pct": "basis_pct * 365 / days_to_expiry, simple (not compounded); null when days_to_expiry < 1; days_to_expiry = (expiry_ts - p…",
      • "index_lag_s": "seconds between the mark timestamp and the index timestamp of the row; 0 when the exchange returns both in one response;…",
      • "multiplier": "contract units per coin (1000PEPE, kPEPE = 1000); mark and index carry the same multiplier so basis_pct is unaffected; s…"
      },
    • "meta": {
      • "schema": "coinboss.sd.basis/1",
      • "source": [ … 1 ],
      • "observed_at": 1794539247345,
      • "received_at": 1794539247425,
      • "fetched_at": 1794541956692,
      • "window": "latest",
      • "quality": "STALE",
      • "is_stale": true,
      • "cache_ttl_s": 20,
      • "fallback": "rows older than 180 s are excluded; if no exchange is fresh the last stored rows (<= 1 h old) are served with is_stale=t…",
      • "collector_heartbeat_age_s": 2759
      }
    }

検証済みサンプル

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

パラメータHTTPレイテンシ結果
coin=ETH20028 ms合格 STALE
coin=SOL20026 ms合格 STALE
coin=PEPE20026 ms合格 STALE
—4002 ms合格 想定どおりのエラーを返す

2026-11-13 03:28:06 UTCにチェック

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
20s
エッジマイクロキャッシュ
10s
更新頻度
コレクターは60秒ごとに巡回します。行は180秒間、鮮度内と見なされます。履歴には1時間ごとのスナップショットが使われます。
ウィンドウ
契約ごとの最新値。
データソース
21のデリバティブ取引所が公表するマーク価格、インデックス価格、直近価格と、同じ取引所の現物価格を、CoinBossが収集・保存しています（sd_px_latest、sd_px_hourly）。
取引所カバレッジ
21取引所。インデックス価格またはマーク価格を公表していない取引所は`coverage.unavailable`に記載されます。2つの価格レグの時刻が60秒を超えて離れている行は`null`を返します。集計値から除外された行は、理由とともに`coverage.excluded_from_aggregate`に記載されます。
ページネーション
ページングはありません。
ソート
建玉の大きい契約が先頭。
単位
All basis values in percent. Prices in the quote currency of the contract (USDT / USDC / USD). `oi_usd` single-sided.
算出方法
Perpetual: basis_pct = (mark − index) ÷ index × 100. Spot-perp: (perpetual price − spot price) ÷ spot price × 100, same exchange and quote currency. Delivery: basis_pct = (futures − index) ÷ index × 100; annualized_pct = basis_pct × 365 ÷ days to expiry (simple interest; `null` inside the last day). Aggregates use one primary contract per exchange; a row enters only if it is fresh, traded within 24 hours and |basis| ≤ 10 %.
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版
提供開始
2026-11-11

ライブステータス

低下2026-11-13 03:52:48 UTCにチェックHTTP 2001 msスキーマ一致最新データポイントは45m前

エンドポイントが報告するデータ品質はSTALEです

可用性（過去30日間）

406回のチェック中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/sd/basis低下
パラメータ

string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.

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