数据口径与时效

两套日线日期

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

数据集	日期字段	日历口径
ETF	trade_date	美国 ETF 交易日
链上	metric_date	UTC 自然日
已发生清算	bucket_start	UTC 小时或 UTC 自然日
潜在清算	snapshot_at	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 表示当前修订在 API 中可用的时间， 不是指标的业务日期。

长期资金代理指标

WGO 使用以下变化量：

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

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

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

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

数值类型

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

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

清算数据边界

已发生清算金额描述已经完成的事件。潜在清算价格桶来自公开可见仓位样本估算，不按账户 资产或单仓名义额过滤，不能视为全市场清算挂单簿。每份快照的 coverage 都是数据含义 的一部分。

数据时效

ETF 和链上数据为日级数据；已发生清算历史每小时刷新，潜在清算数据以带时间的快照返回。 这是报告数据服务，不是交易执行数据流。消费者应组合判断 trade_date、metric_date、settlement_status、has_flash_data、bucket_start 或 snapshot_at，不要假定某个固定时间一定已经完成更新。

WGO 数据不构成交易建议。