数据口径与时效

两套日线日期

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 使用以下变化量：

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

结果分为 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 对日线观测值进行规范化和保存，但不将数据直接转化为交易建议。