24h成交量—未平仓—24h爆仓$1.36B24h多空比—BTC市占—ETH市占—
App
语言 ▾
¥ CNY ▾
/api/content/summary
GET可用Beta

全站栏目摘要

全站栏目摘要（用于内容页面）

GET/api/content/summary

请求

该端点不接受任何参数。

请求示例

curl -s "https://www.coinboss.com/api/content/summary"

响应字段

字段表根据真实响应生成，因此所列内容与端点实际返回的完全一致。路径中 a[] 表示数组元素，{*} 表示以动态名称（如币种或交易所）为键的对象。

字段类型单位说明
successboolean—请求成功时为 true。失败时响应体为 `{ success: false, code, error, request_id }`。
nownumberms响应生成时的服务器时间。
exchangesobject—交易所。
exchanges.countnumber—条目数量。
exchanges.total_volnumberUSD所有交易所的 24h 合约成交量合计，不含股票挂钩合约。
exchanges.total_oinumber—总持仓量。
exchanges.total_contractsnumbercount所有交易所的合约行情数量，不含股票挂钩合约。
exchanges.top3array—前三个条目。
exchanges.top3[]object—前三个条目。
exchanges.top3[].namestring—名称。
exchanges.top3[].volnumber—成交量。
exchanges.top3[].share_pctnumber%占总量的比例。
exchanges.dex_share_vol_pctnumber%`total_vol` 中在去中心化永续合约交易所成交的份额。
exchanges.dex_share_oi_pctnumber%`total_oi` 中在去中心化永续合约交易所持有的份额。
exchanges.stock_vol_excludednumberUSD未计入 `total_vol` 的股票挂钩合约 24h 成交量。
fundingobject—资金费率数据块或数值。
funding.weighted_pctnumber%加密货币 USDT 永续合约按持仓量加权的当前资金费率，以每个资金费周期的百分比表示（费率未归一化到 8 小时）。
funding.top_posarray—持仓量不低于 300,000 USD 的 USDT 永续合约中，当前资金费率最高的三个。
funding.top_pos[]object—一个合约：`base`（币种）、`ex`（交易所显示名称）和 `rate_pct`。
funding.top_pos[].basestring—基础资产代码。
funding.top_pos[].exstring—交易所 ID，小写。
funding.top_pos[].rate_pctnumber%该合约的当前资金费率，以百分比表示，按其自身的资金费周期计。
funding.top_negarray—持仓量不低于 300,000 USD 的 USDT 永续合约中，当前资金费率最低（负值最大）的三个。
funding.top_neg[]object—一个合约：`base`（币种）、`ex`（交易所显示名称）和 `rate_pct`。
funding.top_neg[].basestring—基础资产代码。
funding.top_neg[].exstring—交易所 ID，小写。
funding.top_neg[].rate_pctnumber%该合约的当前资金费率，以百分比表示，按其自身的资金费周期计。
funding.intervalsobject—周期。
funding.intervals.h1_pctnumber%最近 24 小时内结算资金费 16 次及以上的合约占比（归为每小时结算）。
funding.intervals.h4_pctnumber%最近 24 小时内结算资金费 5 至 15 次的合约占比（归为每 4 小时结算）。
funding.intervals.h8_pctnumber%最近 24 小时内结算资金费少于 5 次的合约占比（归为每 8 小时结算）。
oiobject—持仓量。
oi.totalnumber—总数。
oi.chg24_pctnumber%持仓量合计相对约 24 小时前的小时快照的变化，仅统计两者中均存在的合约；没有快照时为 null。
oi.gainersarray—最大涨幅。
oi.gainers[]object—最大涨幅。
oi.gainers[].basestring—基础资产代码。
oi.gainers[].oinumber—持仓量。
oi.gainers[].chg_pctnumber%涨跌幅（百分比）。
oi.losersarray—最大跌幅。
oi.losers[]object—最大跌幅。
oi.losers[].basestring—基础资产代码。
oi.losers[].oinumber—持仓量。
oi.losers[].chg_pctnumber%涨跌幅（百分比）。
oi.top_exarray—持仓量最大的三家交易所。
oi.top_ex[]object—一家交易所：`name`、`oi`（USD）和 `share_pct`（占 `oi.total` 的百分比）。
oi.top_ex[].namestring—名称。
oi.top_ex[].oinumber—持仓量。
oi.top_ex[].share_pctnumber%占总量的比例。
marketobject—市场。
market.total_oinumber—总持仓量。
market.liq_totalnumberUSD最近 24 小时的多头与空头爆仓额合计，不含股票挂钩合约。
market.liq_longnumber—多头爆仓额。
market.liq_shortnumber—空头爆仓额。
market.up_cntnumbercount市值排名前 500 的币种中 24h 价格涨跌幅为正的数量。
market.down_cntnumbercount市值排名前 500 的币种中 24h 价格涨跌幅为负的数量。
market.btc_dom_pctnumber%BTC 市值 ÷ 受跟踪币种的总市值 × 100；市值快照不可用时为 null。
stocksobject—最近 12 小时内有行情的股票挂钩永续合约：标的数量、合约数量、交易所数量、24h 成交量以及排名前 3 的标的。
stocks.underlyingsnumber—标的代码。
stocks.contractsnumber—各合约的数据行。
stocks.volnumber—成交量。
stocks.exchangesnumber—交易所。
stocks.top3array—前三个条目。
stocks.top3[]object—前三个条目。
stocks.top3[].ustring—标的股票或 ETF 的代码。
stocks.top3[].volnumber—成交量。
preipoobject—股票挂钩合约中的 pre-IPO（合成）标的：数量、24h 成交量、最高价格和最大价差。
preipo.underlyingsnumber—标的代码。
preipo.volnumber—成交量。
preipo.top_priceobject—按成交量加权的合约价格最高的 pre-IPO 标的（`u`、`price`）；没有标的在交易时为 null。
preipo.top_price.ustring—该标的的名称。
preipo.top_price.pricenumber—以计价货币表示的最新价格（除非另有说明，为 USD 或 USDT）。
preipo.max_spreadobject—各合约之间价差最大的 pre-IPO 标的（`u`、`spread_pct`、`pmin`、`pmax`）；没有标的拥有两个合约时为 null。
preipo.max_spread.ustring—该标的的名称。
preipo.max_spread.spread_pctnumber%(`pmax` − `pmin`) ÷ `pmin` × 100。
preipo.max_spread.pminnumberUSD该标的在各交易所的当前合约价格中的最低值。
preipo.max_spread.pmaxnumberUSD该标的在各交易所的当前合约价格中的最高值。

生成于 2026-11-11 23:01 UTC，基于 1 个真实响应。

响应示例

/api/content/summary · 真实响应，采集于 2026-11-13 03:53:48 UTC。 为便于展示，较长的数组和映射已被截短：oi.losers 原有 3 项; oi.top_ex 原有 3 项; oi.gainers 原有 3 项; stocks.top3 原有 3 项; exchanges.top3 原有 3 项; funding.top_neg 原有 3 项。

  • {
    • "success": true,
    • "now": 1794541766928,
    • "exchanges": {
      • "count": 25,
      • "total_vol": 169675954910.26993,
      • "total_oi": 107737040199.58,
      • "total_contracts": 10843,
      • "top3": [ … 2 ],
      • "dex_share_vol_pct": 8.3,
      • "dex_share_oi_pct": 11.3,
      • "stock_vol_excluded": 41319457587.51
      },
    • "funding": {
      • "weighted_pct": 0.0047,
      • "top_pos": [ … 2 ],
      • "top_neg": [ … 2 ],
      • "intervals": { … 3 }
      },
    • "oi": {
      • "total": 107737040199.58,
      • "chg24_pct": -3.33,
      • "gainers": [ … 2 ],
      • "losers": [ … 2 ],
      • "top_ex": [ … 2 ]
      },
    • "market": {
      • "total_oi": 107737040199.58,
      • "liq_total": 1197925242.48,
      • "liq_long": 1104557190,
      • "liq_short": 93368052.48,
      • "up_cnt": 150,
      • "down_cnt": 327,
      • "btc_dom_pct": 57.4
      },
    • "stocks": {
      • "underlyings": 648,
      • "contracts": 2338,
      • "vol": 41225031460.52995,
      • "exchanges": 18,
      • "top3": [ … 2 ]
      },
    • "preipo": {
      • "underlyings": 3,
      • "vol": 2214168764.27,
      • "top_price": { … 2 },
      • "max_spread": { … 4 }
      }
    }

详细信息

身份验证
无。公开端点。
速率限制
每个 IP 每分钟 1200 次请求
服务端缓存
10m
边缘微缓存
10s
更新频率
行情每 1 分钟；OI/资金费率每 5 分钟；API 缓存 600 秒
时间窗口
24h
数据来源
全站汇总数据（各交易所成交量与持仓量份额、资金费率极值、持仓量异动、爆仓、代币化股票和 pre-IPO 合约统计），由 CoinBoss 根据交易所数据自行聚合；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
稳定性
Beta

实时状态

可用检查于 2026-11-13 03:53:48 UTCHTTP 2001 ms结构一致

近 30 天可用性

407 次检查中 99.75% 通过

错误

所有端点的失败响应格式一致。完整列表见错误页面。 错误与速率限制 →

错误码HTTP含义处理方式
INVALID_PARAM400缺少必填参数，或某个取值不被接受。已知是哪个参数时，`param` 会给出其名称。请勿原样重试；请修正请求。
UNAUTHORIZED401已发送 `CB-API-KEY` 请求头，但该密钥未知或已被吊销。公开数据无需密钥，请去掉该请求头或使用有效密钥。请勿原样重试。
FORBIDDEN403该路由不属于公开 API（内部或仅限账户使用）。请勿重试。
NOT_FOUND404未知路由，或所请求的币种 / 交易所 / 基金不存在。请勿重试；请对照目录检查路径和标识符。
RATE_LIMITED429请求数超过每分钟限额。`Retry-After` 给出需要等待的秒数。等待 `Retry-After` 指定的时间后，再以退避方式重试。
INTERNAL500意外的服务器错误。错误信息有意保持通用；报告问题时请附上 `request_id`。几秒后重试一次；若问题持续，请附上请求 ID 报告。
UPSTREAM_FAILED503该端点背后的数据源未及时响应。不会返回过期数据或替代数值来顶替。以退避方式重试；并查看状态页。
UNAVAILABLE501 / 503数据集暂时未就绪（缓存预热中），或该端点尚无合法的公开数据源。请稍后重试；目录会标出因设计原因而不可用的端点。
REQUEST_FAILED200部分较旧的端点会以 HTTP 200 返回 `success: false`。请务必检查 `success`，而不只是 HTTP 状态码。取决于具体信息；按请求失败处理。

试一试

GET/api/content/summary可用
参数

无参数。

请求 URLhttps://www.coinboss.com/api/content/summary
选择一个端点，然后点击“发送请求”。响应、响应头和耗时将显示在这里。