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 − same-exchange 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 纪元毫秒(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