GET降級STALE
合約基差(所有交易所)
依合約提供永續合約基差(標記價格對指數價格)、同一交易所的永續對現貨基差,以及交割合約基差與年化率;另附 OI 加權、成交量加權與中位數彙總值。
GET
/api/sd/basis降級. 端點回報的資料品質為 STALE
請求
查詢參數
| 名稱 | 型別 | 必填 | 預設值 | 可用值 | 說明 |
|---|---|---|---|---|---|
| coin | string | 必填 | — | — | 幣種代號,不分大小寫(例如 `BTC`)。缺少或格式錯誤時回傳 400。 範例: BTC |
請求範例
curl -s "https://www.coinboss.com/api/sd/basis?coin=BTC"回應欄位
欄位表由真實回應產生,因此列出的正是端點實際回傳的內容。路徑中的 a[] 代表陣列元素,{*} 代表以動態名稱(例如幣種或交易所)為鍵的物件。
| 欄位 | 型別 | 單位 | 說明 |
|---|---|---|---|
| success | boolean | — | 請求成功時為 true。失敗時回應內容為 `{ success: false, code, error, request_id }`。 |
| schema | string | — | 此回應的結構描述 ID。只有在既有欄位的意義或型別改變時才會變更。 |
| now | number | ms | 建立回應時的伺服器時間。 |
| coin | string | — | 幣種代號(大寫)。 |
| perp | object | — | 永續合約基差:標記價格相對於同一交易所的指數價格。 |
| perp.unit | string | — | 基差數值的單位(百分比)。 |
| perp.aggregate | object | — | 此區段的跨交易所彙總值。 |
| perp.aggregate.oi_weighted_pct | number | % | 以持倉量加權的基差;沒有 OI 權重的資料列不計入。 |
| perp.aggregate.oi_weight_usd | number | USD | 所用持倉量權重的加總。 |
| perp.aggregate.n_oi_weighted | number | — | 帶有 OI 權重的資料列數。 |
| perp.aggregate.vol_weighted_pct | number | % | 以 24h 名義成交額加權的基差。 |
| perp.aggregate.vol_weight_usd | number | USD | 所用成交量權重的加總。 |
| perp.aggregate.n_vol_weighted | number | — | 帶有成交量權重的資料列數。 |
| perp.aggregate.median_pct | number | % | 每家交易所取一個主力合約所得的基差中位數。 |
| perp.aggregate.mean_pct | number | % | 與中位數相同集合的簡單平均值。 |
| perp.aggregate.n_exchanges | number | — | 計入彙總值的交易所。 |
| perp.aggregate.n_contracts | number | — | 計入彙總值的合約。 |
| perp.aggregate.min | object | — | 基差最低的交易所與合約。 |
| perp.aggregate.min.exchange | string | — | 交易所 ID(小寫)。 |
| perp.aggregate.min.symbol | string | — | CoinBoss 儲存格式的合約代號。 |
| perp.aggregate.min.basis_pct | number | % | 永續合約與交割合約為 (mark − index) ÷ index × 100;在排行中則為跨交易所中位數。 |
| perp.aggregate.max | object | — | 基差最高的交易所與合約。 |
| perp.aggregate.max.exchange | string | — | 交易所 ID(小寫)。 |
| perp.aggregate.max.symbol | string | — | CoinBoss 儲存格式的合約代號。 |
| perp.aggregate.max.basis_pct | number | % | 永續合約與交割合約為 (mark − index) ÷ index × 100;在排行中則為跨交易所中位數。 |
| perp.aggregate.median_last_pct | number | % | 最新成交價基差的中位數。 |
| perp.aggregate.n_exchanges_last | number | — | 計入最新成交價中位數的交易所。 |
| perp.aggregate.weights | object | — | 權重的來源、其新鮮視窗,以及最舊權重距今的時間。 |
| perp.aggregate.weights.oi | object | — | 持倉量。 |
| perp.aggregate.weights.oi.source | string | — | 資料採集所用的上游公開端點。 |
| perp.aggregate.weights.oi.fresh_window_s | number | s | 超過此時間的權重不予採用。 |
| perp.aggregate.weights.oi.oldest_age_s | number | s | 所用最舊權重距今的時間。 |
| perp.aggregate.weights.oi.side | string | — | 持倉量權重是否為單邊計算。 |
| perp.aggregate.weights.vol | object | — | 成交量。 |
| perp.aggregate.weights.vol.source | string | — | 資料採集所用的上游公開端點。 |
| perp.aggregate.weights.vol.fresh_window_s | number | s | 超過此時間的權重不予採用。 |
| perp.aggregate.weights.vol.oldest_age_s | number | s | 所用最舊權重距今的時間。 |
| perp.contracts | array | — | 每個合約一列。 |
| perp.contracts[] | object | — | 每個合約一列。 |
| perp.contracts[].exchange | string | — | 交易所 ID(小寫)。 |
| perp.contracts[].symbol | string | — | CoinBoss 儲存格式的合約代號。 |
| perp.contracts[].native_symbol | string | — | 交易所原始寫法的合約代號。 |
| perp.contracts[].quote | string | — | 合約的計價貨幣。 |
| perp.contracts[].margin_type | string | — | 合約的保證金類型(例如 USDT 本位、幣本位)。 |
| perp.contracts[].multiplier | number | — | 每個報價單位對應的幣數(`1000PEPE` 這類合約為 1000)。基差不受影響。 |
| perp.contracts[].mark_price | number|null | — | 交易所公布的標記價格。 |
| perp.contracts[].index_price | number|null | — | 交易所公布的指數價格。 |
| perp.contracts[].last_price | number|null | — | 最新成交價。 |
| perp.contracts[].index_kind | string|null | — | 指數的類型:`exchange_index`、`oracle`,或其他會顯示但不計入彙總的類型。 |
| perp.contracts[].basis_pct | number|null | % | 永續合約與交割合約為 (mark − index) ÷ index × 100;在排行中則為跨交易所中位數。 |
| perp.contracts[].basis_abs | number|null | — | mark − index,以計價貨幣表示。 |
| perp.contracts[].basis_last_pct | number|null | % | (last − index) ÷ index × 100;近期沒有成交時為 `null`。 |
| perp.contracts[].basis_last_reason | string|null | — | `basis_last_pct` 為 null 的原因。 |
| perp.contracts[].index_lag_s | number|null | s | 該列標記價格時間戳記與指數價格時間戳記相差的秒數。 |
| perp.contracts[].oi_usd | number|null | USD | 合約的持倉量(單邊);用作權重。 |
| perp.contracts[].vol_usd_24h | number|null | USD | 合約的 24h 名義成交額;用作權重。 |
| perp.contracts[].primary | boolean | — | 在中位數與平均值中代表其交易所的合約為 true。 |
| perp.contracts[].in_aggregate | boolean | — | 該列通過納入規則時為 true。 |
| perp.contracts[].excluded_reason | string|null | — | 該列未計入彙總值的原因。 |
| perp.contracts[].last_ts | number|null | ms | 最近一筆成交的時間。 |
| perp.contracts[].observed_at | number|null | ms | 來源為該資料提供的時間戳記。 |
| perp.contracts[].received_at | number | ms | CoinBoss 採集器收到資料的時間。 |
| perp.contracts[].age_s | number | s | 距收到該資料列的秒數。 |
| spot_perp | object | — | 永續合約價格相對於同一交易所的現貨價格。 |
| spot_perp.unit | string | — | 基差數值的單位(百分比)。 |
| spot_perp.aggregate | object | — | 此區段的跨交易所彙總值。 |
| spot_perp.aggregate.oi_weighted_pct | number | % | 以持倉量加權的基差;沒有 OI 權重的資料列不計入。 |
| spot_perp.aggregate.oi_weight_usd | number | USD | 所用持倉量權重的加總。 |
| spot_perp.aggregate.n_oi_weighted | number | — | 帶有 OI 權重的資料列數。 |
| spot_perp.aggregate.vol_weighted_pct | number | % | 以 24h 名義成交額加權的基差。 |
| spot_perp.aggregate.vol_weight_usd | number | USD | 所用成交量權重的加總。 |
| spot_perp.aggregate.n_vol_weighted | number | — | 帶有成交量權重的資料列數。 |
| spot_perp.aggregate.median_pct | number | % | 每家交易所取一個主力合約所得的基差中位數。 |
| spot_perp.aggregate.mean_pct | number | % | 與中位數相同集合的簡單平均值。 |
| spot_perp.aggregate.n_exchanges | number | — | 計入彙總值的交易所。 |
| spot_perp.aggregate.n_contracts | number | — | 計入彙總值的合約。 |
| spot_perp.aggregate.min | object | — | 基差最低的交易所與合約。 |
| spot_perp.aggregate.min.exchange | string | — | 交易所 ID(小寫)。 |
| spot_perp.aggregate.min.symbol | string | — | CoinBoss 儲存格式的合約代號。 |
| spot_perp.aggregate.min.basis_pct | number | % | 永續合約與交割合約為 (mark − index) ÷ index × 100;在排行中則為跨交易所中位數。 |
| spot_perp.aggregate.max | object | — | 基差最高的交易所與合約。 |
| spot_perp.aggregate.max.exchange | string | — | 交易所 ID(小寫)。 |
| spot_perp.aggregate.max.symbol | string | — | CoinBoss 儲存格式的合約代號。 |
| spot_perp.aggregate.max.basis_pct | number | % | 永續合約與交割合約為 (mark − index) ÷ index × 100;在排行中則為跨交易所中位數。 |
| spot_perp.pairs | array | — | 同一交易所的每組永續合約/現貨配對一列。 |
| spot_perp.pairs[] | object | — | 同一交易所的每組永續合約/現貨配對一列。 |
| spot_perp.pairs[].exchange | string | — | 交易所 ID(小寫)。 |
| spot_perp.pairs[].symbol | string | — | CoinBoss 儲存格式的合約代號。 |
| spot_perp.pairs[].spot_symbol | string | — | 作為現貨端的現貨市場。 |
| spot_perp.pairs[].quote | string | — | 合約的計價貨幣。 |
| spot_perp.pairs[].spot_mult | number | — | 套用於現貨價格的係數,使兩端以相同數量報價。 |
| spot_perp.pairs[].futures_price | number|null | — | 所用的永續合約價格;見 `price_kind`。 |
| spot_perp.pairs[].price_kind | string|null | — | 採用的是哪一種永續合約價格:`last` 或 `mark`。 |
| spot_perp.pairs[].spot_price | number | — | 套用 `spot_mult` 後的現貨最新成交價。 |
| spot_perp.pairs[].basis_pct | number|null | % | 永續合約與交割合約為 (mark − index) ÷ index × 100;在排行中則為跨交易所中位數。 |
| spot_perp.pairs[].basis_last_pct | number|null | % | (last − index) ÷ index × 100;近期沒有成交時為 `null`。 |
| spot_perp.pairs[].basis_mark_pct | number|null | % | (mark − spot) ÷ spot × 100。 |
| spot_perp.pairs[].leg_gap_s | number | s | 兩端時間戳記相差的秒數。 |
| spot_perp.pairs[].spot_time_kind | string | — | 現貨時間戳記的類型(成交時間或接收時間)。 |
| spot_perp.pairs[].spot_vol_24h | number|null | — | 現貨市場的 24h 成交額,以其計價貨幣表示。 |
| spot_perp.pairs[].oi_usd | number|null | USD | 合約的持倉量(單邊);用作權重。 |
| spot_perp.pairs[].vol_usd_24h | number|null | USD | 合約的 24h 名義成交額;用作權重。 |
| spot_perp.pairs[].primary | boolean | — | 在中位數與平均值中代表其交易所的合約為 true。 |
| spot_perp.pairs[].in_aggregate | boolean | — | 該列通過納入規則時為 true。 |
| spot_perp.pairs[].excluded_reason | string|null | — | 該列未計入彙總值的原因。 |
| spot_perp.pairs[].received_at | number | ms | CoinBoss 採集器收到資料的時間。 |
| spot_perp.pairs[].spot_received_at | number | ms | 收到現貨端資料的時間。 |
| delivery | object | — | 交割合約(定期期貨)基差。 |
| delivery.unit | string | — | 基差數值的單位(百分比)。 |
| delivery.contracts | array | — | 每個合約一列。 |
| delivery.contracts[] | object | — | 每個合約一列。 |
| delivery.contracts[].exchange | string | — | 交易所 ID(小寫)。 |
| delivery.contracts[].symbol | string | — | CoinBoss 儲存格式的合約代號。 |
| delivery.contracts[].native_symbol | string | — | 交易所原始寫法的合約代號。 |
| delivery.contracts[].quote | string | — | 合約的計價貨幣。 |
| delivery.contracts[].margin_type | string | — | 合約的保證金類型(例如 USDT 本位、幣本位)。 |
| delivery.contracts[].expiry_ts | number | ms | 交割合約的到期時間。 |
| delivery.contracts[].days_to_expiry | number | days | 距到期的天數。 |
| delivery.contracts[].mark_price | number | — | 交易所公布的標記價格。 |
| delivery.contracts[].last_price | number|null | — | 最新成交價。 |
| delivery.contracts[].index_price | number | — | 交易所公布的指數價格。 |
| delivery.contracts[].index_kind | string | — | 指數的類型:`exchange_index`、`oracle`,或其他會顯示但不計入彙總的類型。 |
| delivery.contracts[].basis_pct | number | % | 永續合約與交割合約為 (mark − index) ÷ index × 100;在排行中則為跨交易所中位數。 |
| delivery.contracts[].annualized_pct | number|null | % per year | basis_pct × 365 ÷ 距到期天數,單利計算;到期前最後一天內為 `null`。 |
| delivery.contracts[].basis_reason | null | — | `basis_pct` 為 null 的原因。 |
| delivery.contracts[].index_lag_s | number | s | 該列標記價格時間戳記與指數價格時間戳記相差的秒數。 |
| delivery.contracts[].basis_last_pct | number|null | % | (last − index) ÷ index × 100;近期沒有成交時為 `null`。 |
| delivery.contracts[].annualized_last_pct | number|null | % per year | 以最新成交價計算的年化基差。 |
| delivery.contracts[].spot_symbol | string|null | — | 作為現貨端的現貨市場。 |
| delivery.contracts[].spot_price | number|null | — | 套用 `spot_mult` 後的現貨最新成交價。 |
| delivery.contracts[].spot_price_kind | string|null | — | 與現貨比較的是哪一種期貨價格。 |
| delivery.contracts[].basis_spot_pct | number|null | % | (futures − 同交易所 spot) ÷ spot × 100。 |
| delivery.contracts[].annualized_spot_pct | number|null | % per year | 相對於同交易所現貨的年化基差。 |
| delivery.contracts[].annualized_reason | string|null | — | 年化值為 null 的原因(例如 `expiry_lt_1d`)。 |
| delivery.contracts[].oi_usd | number|null | USD | 合約的持倉量(單邊);用作權重。 |
| delivery.contracts[].vol_usd_24h | number|null | USD | 合約的 24h 名義成交額;用作權重。 |
| delivery.contracts[].last_ts | number|null | ms | 最近一筆成交的時間。 |
| delivery.contracts[].observed_at | number|null | ms | 來源為該資料提供的時間戳記。 |
| delivery.contracts[].received_at | number | ms | CoinBoss 採集器收到資料的時間。 |
| delivery.contracts[].age_s | number | s | 距收到該資料列的秒數。 |
| coverage | object | — | 數字中納入與未納入的內容。與其他來源比較合計值之前,請先比對這一項。 |
| coverage.included_exchanges | array | — | 新鮮資料已被納入的來源。 |
| coverage.included_exchanges[] | string | — | 新鮮資料已被納入的來源。 |
| coverage.unavailable | array | — | 無法納入的來源,各附原因。它們絕不會以 0 計入。 |
| coverage.unavailable[] | object | — | 無法納入的來源,各附原因。它們絕不會以 0 計入。 |
| coverage.unavailable[].exchange | string | — | 交易所 ID(小寫)。 |
| coverage.unavailable[].reason | string | — | 機器可讀的原因代碼。 |
| coverage.unavailable[].detail | string | — | 供人閱讀的原因說明。 |
| coverage.stale_excluded | array | — | 因最近一次更新超出新鮮視窗而被排除的資料列。 在產生此表所用的樣本中為空 |
| coverage.missing_fields | array | — | 未公布其中某一種價格的交易所。 |
| coverage.excluded_from_aggregate | array | — | 會顯示但不計入彙總值的資料列,各附原因。 |
| coverage.excluded_from_aggregate[] | object | — | 會顯示但不計入彙總值的資料列,各附原因。 |
| coverage.excluded_from_aggregate[].exchange | string | — | 交易所 ID(小寫)。 |
| coverage.excluded_from_aggregate[].symbol | string | — | CoinBoss 儲存格式的合約代號。 |
| coverage.excluded_from_aggregate[].section | string | — | 該列所屬的區段。 |
| coverage.excluded_from_aggregate[].reason | string | — | 機器可讀的原因代碼。 |
| coverage.stock_excluded | array | — | 因代號相同而被移除的股票永續合約。 在產生此表所用的樣本中為空 |
| coverage.dropped_delisted_rows | number | — | 因合約停止更新而被捨棄的資料列。 |
| coverage.delivery_unavailable | array | — | 未採集其交割合約的交易所。 |
| coverage.delivery_unavailable[] | object | — | 未採集其交割合約的交易所。 |
| coverage.delivery_unavailable[].exchange | string | — | 交易所 ID(小寫)。 |
| coverage.delivery_unavailable[].reason | string | — | 機器可讀的原因代碼。 |
| coverage.delivery_unavailable[].detail | string | — | 供人閱讀的原因說明。 |
| method | object | — | 此回應所用公式的純文字說明,每個欄位一項。 |
| method.perp.basis_pct | string | — | `perp.basis_pct` 的公式說明,純文字。 |
| method.perp.basis_last_pct | string | — | `perp.basis_last_pct` 的公式說明,純文字。 |
| method.perp.aggregate.oi_weighted_pct | string | — | `perp.aggregate.oi_weighted_pct` 的公式說明,純文字。 |
| method.perp.aggregate.vol_weighted_pct | string | — | `perp.aggregate.vol_weighted_pct` 的公式說明,純文字。 |
| method.perp.aggregate.median_pct | string | — | `perp.aggregate.median_pct` 的公式說明,純文字。 |
| method.perp.aggregate.inclusion | string | — | `perp.aggregate.inclusion` 的公式說明,純文字。 |
| method.spot_perp.basis_pct | string | — | `spot_perp.basis_pct` 的公式說明,純文字。 |
| method.spot_perp.aggregate.inclusion | string | — | `spot_perp.aggregate.inclusion` 的公式說明,純文字。 |
| method.delivery.basis_pct | string | — | `delivery.basis_pct` 的公式說明,純文字。 |
| method.delivery.annualized_pct | string | — | `delivery.annualized_pct` 的公式說明,純文字。 |
| method.index_lag_s | string | — | `index_lag_s` 的公式說明,純文字。 |
| method.multiplier | string | — | `multiplier` 的公式說明,純文字。 |
| meta | object | — | 此回應的資料歷程與新鮮度。 |
| meta.schema | string | — | 此回應的結構描述 ID。只有在既有欄位的意義或型別改變時才會變更。 |
| meta.source | array | — | 資料採集所用的上游公開端點。 |
| meta.source[] | object | — | 資料採集所用的上游公開端點。 |
| meta.source[].exchange | string | — | 交易所 ID(小寫)。 |
| meta.source[].endpoint | string | — | 採集器讀取的來源公開端點(僅供說明資料歷程;用戶端不會直接呼叫它)。 |
| meta.observed_at | number | ms | 來源為該資料提供的時間戳記。 |
| meta.received_at | number | ms | CoinBoss 採集器收到資料的時間。 |
| meta.fetched_at | number | ms | 此回應組裝完成的時間。 |
| meta.window | string | — | 數字涵蓋的時間視窗。 |
| meta.quality | string | — | FRESH、PARTIAL、STALE、BROKEN 或 UNAVAILABLE,依資料時間戳記與覆蓋範圍判定。 |
| meta.is_stale | boolean | — | 資料已超出其新鮮視窗時為 true。 |
| meta.cache_ttl_s | number | s | 此回應的快取存活時間。 |
| meta.fallback | string | — | 採集器或來源發生故障時,此端點回傳的內容。 |
| meta.collector_heartbeat_age_s | number | s | 距採集器上次回報仍在運作的秒數。 |
| coverage.missing_fields[] | object | — | 未公布其中某一種價格的交易所。 |
| coverage.missing_fields[].exchange | string | — | 交易所 ID(小寫)。 |
| coverage.missing_fields[].symbol | string | — | CoinBoss 儲存格式的合約代號。 |
| coverage.missing_fields[].missing | string | — | 交易所未公布的價格(`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"
- "contracts"
- "spot_perp"
- "unit""percent"
- "aggregate"
- "pairs"
- "delivery"
- "unit""percent"
- "contracts"
- "coverage"
- "included_exchanges"
- "unavailable"
- "stale_excluded"
- "missing_fields"
- "excluded_from_aggregate"
- "stock_excluded"
- "dropped_delisted_rows"0
- "delivery_unavailable"
- "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"
- "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=ETH | 200 | 28 ms | 通過 STALE |
| coin=SOL | 200 | 26 ms | 通過 STALE |
| coin=PEPE | 200 | 26 ms | 通過 STALE |
| — | 400 | 2 ms | 通過 回傳預期的錯誤 |
檢查於 2026-11-13 03:28:06 UTC
詳細資訊
- 身分驗證
- 無。公開端點。
- 速率限制
- 每個 IP 每分鐘 1200 次請求
- 伺服器快取
- 20s
- 邊緣微快取
- 10s
- 更新頻率
- 採集器每 60 秒執行一輪;資料列在 180 秒內視為新鮮。歷史資料由小時快照構成。
- 時間視窗
- 每個合約的最新值。
- 資料來源
- 21 家衍生品交易所公布的標記價格、指數價格與最新成交價,加上同一交易所的現貨價格,由 CoinBoss 採集並儲存(sd_px_latest、sd_px_hourly)。
- 交易所覆蓋範圍
- 21 家交易所。未公布指數價格或標記價格的交易所列於 `coverage.unavailable`;兩端價格的時間相差超過 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 epoch 毫秒(UTC),除非欄位說明另有註明
- 回應格式
- json
- 穩定性
- 穩定版
- 上線時間
- 2026-11-11
即時狀態
降級檢查於 2026-11-13 03:52:48 UTCHTTP 2001 ms結構描述相符最新資料點距今 45m
端點回報的資料品質為 STALE
近 30 天可用率
406 次檢查中有 100% 通過
錯誤
所有端點的失敗回應都採用同一種結構。完整清單請見錯誤頁面。 錯誤與速率限制 →
| 錯誤碼 | HTTP | 意義 | 處理方式 |
|---|---|---|---|
| INVALID_PARAM | 400 | 缺少必填參數,或某個值不被接受。已知時,`param` 會指出是哪個參數。 | 請勿原樣重試;請修正請求。 |
| UNAUTHORIZED | 401 | 已送出 `CB-API-KEY` 標頭,但金鑰未知或已撤銷。公開資料不需要金鑰——請移除該標頭或改用有效的金鑰。 | 請勿原樣重試。 |
| FORBIDDEN | 403 | 此路由不屬於公開 API(內部或僅限帳戶使用)。 | 請勿重試。 |
| NOT_FOUND | 404 | 未知的路由,或所請求的幣種/交易所/基金不存在。 | 請勿重試;請對照目錄檢查路徑與識別碼。 |
| RATE_LIMITED | 429 | 請求數超過每分鐘上限。`Retry-After` 會指出需等待的秒數。 | 等待 `Retry-After` 指定的時間後,再以退避策略重試。 |
| INTERNAL | 500 | 非預期的伺服器錯誤。訊息刻意保持籠統;回報時請附上 `request_id`。 | 幾秒後重試一次;若問題持續,請附上請求 ID 回報。 |
| UPSTREAM_FAILED | 503 | 此端點背後的資料來源未及時回應。不會以過期或替代的數字代替回傳。 | 以退避策略重試;並查看狀態頁面。 |
| UNAVAILABLE | 501 / 503 | 資料集暫時尚未就緒(快取預熱中),或此端點目前尚無合法的公開來源。 | 稍後重試;目錄會標示出設計上即無法使用的端點。 |
| REQUEST_FAILED | 200 | 部分舊版端點會以 HTTP 200 回應但帶有 `success: false`。請務必檢查 `success`,而不只是 HTTP 狀態碼。 | 視訊息而定;請當作失敗的請求處理。 |
試用
GET
/api/sd/basis降級參數
string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.
請求 URL
https://www.coinboss.com/api/sd/basis?coin=BTC選擇一個端點並按下「送出請求」。回應內容、標頭與耗時會顯示在這裡。
此分類的其他端點
- 合約基差(所有交易所) /api/sd/basis
- 基差歷史(小時級) /api/sd/basis/history
- 依基差排行的幣種 /api/sd/basis/rank
- 期現基差清單 /api/derivatives/basis
- Coinbase 與 Kraken 的 BTC 每日價差 /api/p3/cb-kr-spread
- Coinbase 比特幣溢價指數 /api/p3/coinbase-premium
- 永續合約溢價指數清單 /api/p3/premium-index
- 單一幣種的溢價指數歷史 /api/p3/premium-index/history
- 溢價指數 K 線 /api/p3/premium-index/klines
- USDT 場外價格相對法幣匯率的溢價 /api/usdt-premium
- 完整期現基差清單 /api/basis/list