---
title: WGO 数据口径与时效
description: WGO 的交易日、结算状态、数值精度、更新时效和分析边界。
---

# 数据口径与时效

## 两套日线日期

ETF 和链上数据的日期不能直接混用：

| 数据集 | 日期字段 | 日历口径 |
| --- | --- | --- |
| ETF | `trade_date` | 美国 ETF 交易日 |
| 链上 | `metric_date` | UTC 自然日 |

周末或美国休市日，ETF 的最近日期可能一直停留在星期五。日报必须标注响应里的业务日期，
不能直接使用调用方的本地自然日。

## ETF 结算状态

- `settled`：可以进入正式日报分析的已结算观测值。
- `pending`：观测值仍可能修订。
- `/etf/{symbol}/overview` 只使用 `settled` 数据。
- `/etf/{symbol}/funds` 不传 `trade_date` 时选择最近已结算日期。
- `/etf/{symbol}/daily` 和显式指定日期的 funds 请求可能返回 `pending` 数据。

ETF 采集不会请求纽约市场尚未结束的当天数据，但此前已经采集的记录仍可能被后续修订。

## 链上完成状态

`source_eod_completed_at` 是日线完成时间；没有确认时间时可能为 `null`。
`has_flash_data=true` 表示至少一个指标还是临时值。`synced_at` 只表示当前版本进入 WGO API
数据库的时间，不是指标的业务日期。

## 长期资金代理指标

WGO 使用以下变化量：

```text
窗口最新累计净流入 - 窗口最早累计净流入
```

结果分为 `increased`、`decreased` 或 `flat`，用于判断一段时间内净申购资金是在累积
还是流失。

它不能识别投资者身份或真实持有时间，尤其要注意：

- ETF 申购赎回过程中也包含做市商资金。
- 投资者之间可以发生买卖而不改变 ETF 汇总份额。
- `total_net_assets_change` 同时受到 BTC/ETH 价格变化影响，不能单独代表新增资金。
- 两只基金同日一进一出，不能证明是同一笔资金直接搬家。

## 数值类型

计数字段使用 JSON 整数。金额和比率等小数使用 JSON 字符串，以避免浮点精度损失。
财务计算应使用 Decimal 类型，不要直接转换成二进制浮点数。

字段为 `null` 表示该日期没有可用值，不能静默转换为 0。

## 采集频率

ETF 和链上数据都按日采集，并以短间隔把修订同步到 API 数据库。这是日报数据服务，
不是实时数据流。消费者应组合判断 `trade_date` 或 `metric_date`、`settlement_status`、
`has_flash_data` 和 `synced_at`，不要假定某个固定时间一定已经完成更新。

WGO 对日线观测值进行规范化和保存，但不将数据直接转化为交易建议。