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

单只 ETF 详情

单只 ETF 详情（概况和资金流历史）

GET/api/etf/fund/:ticker

请求

查询参数

名称类型必填默认值可选值说明
ticker pathstring必填——基金代码（仅限字母，转为大写）；未知时返回 404。 示例: IBIT

标记为“path”的参数是 URL 的一部分。

请求示例

curl -s "https://www.coinboss.com/api/etf/fund/IBIT"

响应字段

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

字段类型单位说明
successboolean—请求成功时为 true。失败时响应体为 `{ success: false, code, error, request_id }`。
tickerstring—基金代码。
assetstring—资产代码。
issuerstring—基金发行商。
priceobject—以计价货币表示的最新价格（除非另有说明，为 USD 或 USDT）。
price.currencystring—货币 / 资产代码。
price.latestobject—最近一条记录。
price.latest.datestring—日历日期（UTC）。
price.latest.closenumber—该周期的收盘价。
price.latest.opennumber—周期开盘价。
price.latest.highnumber—周期最高价。
price.latest.lownumber—周期最低价。
price.latest.volumenumber—成交量。
price.change_absnumberUSD基金份额最新日线收盘价减去上一交易日收盘价。
price.change_pctnumber%涨跌幅（百分比）。
price.week52_highnumberUSD截至最新价格日期的 365 个自然日内，基金份额的最高日内高点。
price.week52_lownumberUSD截至最新价格日期的 365 个自然日内，基金份额的最低日内低点。
price.avg_volume_10dnumbershares该基金最近 10 个交易日的日均成交量，以份额计。
price.countnumber—条目数量。
price.dataarray—数据载荷。
price.data[]object—数据载荷。
price.data[].datestring—日历日期（UTC）。
price.data[].opennumber—周期开盘价。
price.data[].highnumber—周期最高价。
price.data[].lownumber—周期最低价。
price.data[].closenumber—该周期的收盘价。
price.data[].volumenumber—成交量。
fundobject—基金层面的快照值；每项均为最后已知的值，可能来自不同日期（见 `aum_as_of`）。
fund.aum_usd_millionnumbermillion USD该基金最近一个非空的资产管理规模，有效日期为 `aum_as_of`。
fund.aum_as_ofstring—`aum_usd_million` 对应的交易日（YYYY-MM-DD）。
fund.estimated_holdingsnumbercoin基金持币量的估算值：最后已知的 AUM ÷ 该资产当前现货价格；属于估算，并非发行商上报的持有量。
fund.fee_pctnumber%基金的年管理费率，单位为百分比（0.25 = 每年 0.25 %）；来自第三方数据源的最后已知值。
fund.mkt_share_pctnumber%基金 AUM 占标的币种总市值的百分比（并非其在 ETF 中的份额）；第三方数据源的最后已知值。
fund.volume_usd_millionnumbermillion USD第三方数据源最后一次上报当日的基金成交量。
fund.cum_inflow_official_millionnumbermillion USD第三方数据源公布的自上市以来的累计净流入（最后已知值）；可能与加总得到的 `flows.latest.cum_total` 不一致。
flowsobject—该基金的日度净流入历史及累计值；金额单位为百万 USD（`unit`）。
flows.unitstring—该对象中数值的单位。
flows.latestobject—最近一条记录。
flows.latest.datestring—日历日期（UTC）。
flows.latest.flownumber—当日的净申购 / 净赎回流量。
flows.latest.cum_totalnumber—累计合计。
flows.latest.sum_7dnumber—7 日合计。
flows.countnumber—条目数量。
flows.dataarray—数据载荷。
flows.data[]object—数据载荷。
flows.data[].datestring—日历日期（UTC）。
flows.data[].flownumber—当日的净申购 / 净赎回流量。
flows.data[].cumnumber—上市以来的累计净流入。
premiumobject—市价相对 NAV 的溢价（+）或折价（−）。
premium.unitstring—该对象中数值的单位。
premium.notestring—备注。
premium.countnumber—条目数量。
premium.dataarray—数据载荷。
premium.data[]object—数据载荷。
premium.data[].datestring—日历日期（UTC）。
premium.data[].premiumnumber—市价相对 NAV 的溢价（+）或折价（−）。

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

响应示例

/api/etf/fund/IBIT · 真实响应，采集于 2026-11-13 03:58:19 UTC。 为便于展示，较长的数组和映射已被截短：flows.data 原有 712 项; price.data 原有 713 项; premium.data 原有 64 项。

  • {
    • "success": true,
    • "ticker": "IBIT",
    • "asset": "BTC",
    • "issuer": "BlackRock",
    • "price": {
      • "currency": "USD",
      • "latest": { … 6 },
      • "change_abs": -1.88,
      • "change_pct": -4.4508,
      • "week52_high": 59.56,
      • "week52_low": 32.84,
      • "avg_volume_10d": 52099530,
      • "count": 713,
      • "data": [ … 2 ]
      },
    • "fund": {
      • "aum_usd_million": 62297.756,
      • "aum_as_of": "2026-11-11",
      • "estimated_holdings": 905689.4173,
      • "fee_pct": 0.25,
      • "mkt_share_pct": 3.995,
      • "volume_usd_million": 2604.817,
      • "cum_inflow_official_million": 65711.051
      },
    • "flows": {
      • "unit": "million_usd",
      • "latest": { … 4 },
      • "count": 712,
      • "data": [ … 2 ]
      },
    • "premium": {
      • "unit": "pct",
      • "note": "sparse_snapshot",
      • "count": 64,
      • "data": [ … 2 ]
      }
    }

详细信息

身份验证
无。公开端点。
速率限制
每个 IP 每分钟 1200 次请求
服务端缓存
5m
边缘微缓存
10s
更新频率
每小时（价格在第 20 分钟，资金流在第 15 分钟）；日线
时间窗口
已存储的每日价格和资金流历史；52 周最高/最低价和 10 日平均成交量
数据来源
单只基金的页面数据：每日基金价格来自公开的行情数据网站，资金流来自公开的 ETF 资金流跟踪网站。
交易所覆盖范围
36 个受跟踪的美国现货 ETF 代码（未知代码返回 404）。
排序
按日期升序
单位
USD (fund price), million USD (flows, AUM), percent (premium, fee), coins (estimated holdings)
计算方法
estimated_holdings = fund AUM in USD / latest coin price (an estimate, not issuer-reported holdings).
时间戳
除非字段说明另有注明，均为 Unix 纪元毫秒（UTC）
响应格式
json
稳定性
稳定

实时状态

可用检查于 2026-11-13 03:58:19 UTCHTTP 20015 ms结构一致最新数据点距今 28h

近 30 天可用性

410 次检查中 100% 通过

错误

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

错误码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/etf/fund/:ticker可用
参数

string — Fund ticker (letters only, upper-cased); 404 if unknown.

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