---
title: WGO ETF 接口
description: BTC、ETH 美国现货 ETF 总览、汇总日线和分基金资金流接口说明。
---

# ETF 接口

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

## ETF 总览

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

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

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

```bash
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 汇总日线

```http
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` 过滤已结算数据。

```json
{
  "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"
    }
  ]
}
```

## 分基金明细

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

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

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

```json
{
  "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。