---
title: WGO API 快速开始
description: 使用 WGO API 判断 ETF 最新资金方向、持续性和长期资金代理指标。
---

# 快速开始

## 1. 配置 Token

申请 MobiusQuant Token，并保存到环境变量：

```bash
export MOBIUSQUANT_TOKEN='mq_xxx'
```

不要把真实 Token 写进源码、公开文档或浏览器 JavaScript。

## 2. 查询 ETF 总览

日报优先调用总览接口。一次请求即可获得最近资金方向、连续状态和长期资金代理指标：

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

关键响应结构：

```json
{
  "symbol": "BTC",
  "as_of": "2026-08-21",
  "observations": 30,
  "latest": {
    "net_inflow": "307453306.12",
    "direction": "inflow",
    "settlement_status": "settled"
  },
  "flow_streak": {
    "direction": "inflow",
    "days": 3
  },
  "period": {
    "net_inflow": "1430936317.58",
    "inflow_days": 18,
    "outflow_days": 12,
    "flat_days": 0
  },
  "long_term_capital_proxy": {
    "basis": "change_in_cumulative_net_inflow",
    "direction": "increased",
    "cumulative_net_inflow_change": "913743812.30",
    "from": "2026-07-13",
    "to": "2026-08-21"
  }
}
```

以上数值用于展示响应结构。生成报告时必须读取实时响应中的 `as_of`，不能假定它就是
当前自然日。

## 3. 解读结果

- `latest.direction`：最近一个已结算 ETF 交易日是流入还是流出。
- `flow_streak`：最近方向连续保持了多少个 ETF 观测日。
- `period`：请求窗口内的资金流合计和正负天数。
- `long_term_capital_proxy.direction`：累计净流入在窗口内增加、减少还是持平。

长期资金代理指标反映资金流的累积变化，不能识别持有人、做市商、机构或个人投资者。

## 4. 按需下钻

查询日线历史：

```bash
curl --fail --silent --show-error \
  -H "Authorization: Bearer ${MOBIUSQUANT_TOKEN}" \
  "https://api.mobiusquant.ai/api/wgo/v1/etf/BTC/daily?limit=30"
```

查询最近已结算交易日的分基金明细：

```bash
curl --fail --silent --show-error \
  -H "Authorization: Bearer ${MOBIUSQUANT_TOKEN}" \
  "https://api.mobiusquant.ai/api/wgo/v1/etf/BTC/funds"
```

将 `BTC` 替换为 `ETH` 即可查询以太坊 ETF。