ETF 接口

WGO 提供美国现货 ETF 的币种汇总和单只基金数据。除非字段另有说明，当前金额字段以 美元计价。小数金额以 JSON 字符串返回，避免浮点精度损失。

ETF 总览

GET /api/wgo/v1/etf/{symbol}/overview

日报应优先使用这个接口。它只使用已结算的 ETF 观测值。

参数	类型	默认值	约束
symbol	路径字符串	—	BTC 或 ETH
window	查询整数	30	最近 2–365 个已结算观测日

curl --fail --silent --show-error \
  -H "Authorization: Bearer ${MOBIUSQUANT_TOKEN}" \
  "https://api.mobiusquant.ai/api/wgo/v1/etf/ETH/overview?window=30"

总览字段

字段	含义
as_of	最近一个已结算的美国 ETF 交易日；无数据时为 null
window_requested	请求的最大观测数量
observations	实际取得的已结算观测数量
latest.net_inflow	as_of 当日汇总净流入
latest.direction	inflow、outflow 或 flat
flow_streak.direction	最近观测日的方向
flow_streak.days	同方向连续观测日数量；最近为持平时是 0
period.net_inflow	窗口内日净流入合计
period.inflow_days	正流入观测日数量
period.outflow_days	负流入观测日数量
period.flat_days	零流入观测日数量
long_term_capital_proxy.direction	increased、decreased 或 flat
long_term_capital_proxy.cumulative_net_inflow_change	最新累计净流入减去窗口最早累计净流入
long_term_capital_proxy.total_net_assets_change	同期 AUM 变化，其中包含币价影响

没有已结算数据时，latest、period 和 long_term_capital_proxy 为 null， flow_streak.direction 为 none。

ETF 汇总日线

GET /api/wgo/v1/etf/{symbol}/daily

参数	类型	默认值	约束
symbol	路径字符串	—	BTC 或 ETH
start	查询日期	不传	包含边界，格式 YYYY-MM-DD
end	查询日期	不传	包含边界，格式 YYYY-MM-DD
limit	查询整数	90	1–1000

数据按 trade_date 倒序排列。这个接口可能包含 pending 行；正式日报应根据 settlement_status 过滤已结算数据。

{
  "symbol": "BTC",
  "count": 1,
  "data": [
    {
      "country_code": "US",
      "symbol": "BTC",
      "trade_date": "2026-08-21",
      "total_net_inflow": "307453306.12",
      "total_value_traded": "6371116431",
      "total_net_assets": "96069419933.81248",
      "cum_net_inflow": "53706123160.808",
      "settlement_status": "settled",
      "synced_at": "2026-08-23T14:46:53.392330+00:00"
    }
  ]
}

分基金明细

GET /api/wgo/v1/etf/{symbol}/funds

参数	类型	默认值	约束
symbol	路径字符串	—	BTC 或 ETH
trade_date	查询日期	最近已结算日期	YYYY-MM-DD

结果按 net_inflow 从高到低排列，缺失值排在最后。不传日期时选择最近一个存在已结算 分基金数据的交易日；显式指定日期时可能返回 pending 数据。

{
  "symbol": "BTC",
  "trade_date": "2026-08-21",
  "count": 1,
  "data": [
    {
      "country_code": "US",
      "symbol": "BTC",
      "ticker": "IBIT",
      "name": "iShares Bitcoin Trust",
      "exchange": "NASDAQ",
      "trade_date": "2026-08-21",
      "net_inflow": "239278720",
      "cum_inflow": "62426677463.659996",
      "net_assets": "59014515840",
      "currency_share": "43.664",
      "prem_dsc": "0.0003664345914253797",
      "value_traded": "5206871551",
      "settlement_status": "settled",
      "synced_at": "2026-08-23T14:47:00.581971+00:00"
    }
  ]
}

prem_dsc 是比率，0.001 约等于 0.1%。currency_share 是基金份额相关数值， 不是美元资金流字段。

分析边界

分基金数据可以说明某只 ETF 在某个交易日获得或流失了多少资金，但不能识别盘中搬家、 逐笔订单、最终受益人，也不能证明同一投资者把资金从一只 ETF 直接转到另一只 ETF。