# 方法、字段映射与复算口径

方法版本：variational-oct2026-observation-v1。统计区间左闭右开，UTC。发布日期是生成日2026-11-02；边界数据与发布时间分开。

## 字段与来源

|报告字段|原始字段/表|清洗及派生|
|---|---|---|
|官方TVL|variational_stats_snapshots.official_tvl|保留API原字段，不把Core钱包加回；不转为用户存款|
|官方双边OI|variational_stats_snapshots.official_total_oi|独立序列；不除2拼接市场历史|
|市场OI|market_observations.long_open_interest + short_open_interest|aggregate_open_interest只作对账；不能据美元变化直接推合约数量|
|成交观察|market_observations.volume_24h / protocol.volume_24h|滚动24H，不逐小时累加成月成交|
|边界分钟成交增量|cumulative_volume[end] − cumulative_volume[start]|检查单调性；时间为采样分钟，实际入库延迟单列，非精确逐笔自然月|
|采样时刻|market_observations.retrieved_at|source_timestamp常来自报价updated_at，不能当整份市场统计抓取时间|
|新Pool|settlement_pools.chain_created_at|按pool_address唯一；clearing_events补tx/block/log，10月全量一致|
|新用户侧地址|settlement_pool_parties.party_address + Pool创建历史|排除已登记协议钱包；地址首次用户侧链时间；不是自然人|
|普通存款|olp_user_deposit_events|classification=VERIFIED_USER_SIDE且quality_status=PASS；tx+chain+event_log_index去重；call/transfer金额和参与方核验|
|余额|wallet_balance_snapshots.usdc_balance|仅指定treasury/core_olp钱包；amount_raw为USDC微单位；不是收入或权益|
|产品类别|market_registry.instrument_type|仅18个NAME_PREFIX/PARTIAL的SWAP，其他UNKNOWN；asset_class全UNKNOWN；不凭ticker猜分类|
|报价成本|metrics.quotes.size_1k / size_100k|同一对象，保留更新时间和状态，不混用不同快照|

## 时间网格和采样权重

1. 协议：每UTC小时选择整点后10分钟内第一条已存记录；同一分钟若多条则按created_at取最后一条。月内736/744有效槽等权；空槽不填0。原始最值来自全部已存采样，可能受采样密度影响，称“原始采样峰值”。
2. 市场：每market_id/小时选整点后20分钟内第一条retrieved_at观察，728/744全市场小时有数据。每日结构固定23时，29/31日有效；图表缺口留空。不同市场首次发现前不填0。
3. 月均表述为“小时网格观察均值”；每日均值、中位数以及7日趋势保存对应样本数。7日趋势基于已观察日均，不假称连续全采样；原始小时缺口单列。
4. 市场结构份额=有效日固定采样成交值之和/同样日和集合的总和，分子分母同口径。绝不称精确月成交份额。TopN窗口固定排名与每日重排分别命名。
5. 变化贡献比较10/1—7与10/25—31，星期结构一致。固定旧集合为9/30的557个市场；要求两组均有7个日样本后交集551个。新市场没有基期的增长率为空。
6. 9月比较复用已有02_market_daily.csv的9/24—30，10月用10/22—28的23时样本。全市场比较保留新增集合影响；额外用两窗完整旧集合549个，其中7个Swap，检查构成变化。两窗均周四至周三。不能转称整月环比。
7. 每日VOL/OI、VOL/TVL、OI/TVL使用当日近时点市场汇总与官方TVL，单位与分母固定，仅为规模关系。没有账户真实杠杆含义。

## 事件、资金与7日样本

- USDC原始整数除10^6；使用Decimal或整数汇总，金额不先四舍五入。原始字符串和原始amount_raw保持精度。市场图表使用浮点，派生CSV 12有效位，独立对账容忍0.1 USDC（实际最大日成交差0.008378）。
- 普通存款覆盖起点10/6 18:40:12；10月部分窗口46,006笔。整月总金额和整月去重字段主动留null，另命名observed总量。
- 月内期间地址去重使用全窗口地址集合；35,880每日去重之和不能代替17,406期间地址。
- 新旧地址按首次用户侧Pool创建时间相对10/1分组；Pool组按本Pool链时间。地址累计金额分位数先按地址累计再排序，P90使用线性插值。Top10按地址累计金额排序，分母为同一部分窗口全部合格存款。
- 跨日重复=有≥2个UTC日合格存款的地址/期间有存款地址；不称交易留存。
- 7日窗口：[Pool链上创建时间, +7天)。仅完整落在存款已证明覆盖区间且截至检查点确认的后续证据时点11/1 00:02:01成熟的样本入分母（保守左闭右开；2分1秒后续覆盖未增加成熟样本）。创建早于覆盖起点与窗口未成熟分别排除；不以失败计入。每个Pool只计一次。
- 创建字段入库时间不用于增长；11/1事件不泄漏进10月总量。链上创建日志索引来自clearing_events，仅在tx、block、Pool匹配后复用。
- 普通存款参与度仅使用已核验存款；注资／回流日聚合另统计资金活动Pool，两者不替代交易活跃，最终规则见FINAL_METHODS.md。

## Treasury / OLP

- 各UTC午夜取最近余额样本，容忍±300秒，保留实际时间及偏移。10/17边界无效，因此16、17日差分空。
- 日变化=B[d+1]−B[d]；正向增量=max(日变化,0)，仅有效29日求和；端点净变化另算，不要求两个不同覆盖范围相等。
- 每1B成交对应正向增量：同29有效日正增量总和 / 同期累计成交增量总和 ×10^9。成交边界取距离余额实际采样≤120秒的协议记录。该实验观察不等于收入、费率、利润或回购。
- Pool与官方TVL取近时点±5分钟，匹配712个完整Pool汇总；再分别比较Pool和Pool+Core。数值接近不是范围定义证明，OLP vault与Core钱包映射仍未核实。
- 逐Pool历史表0行；当前表包含不同时间戳，不能回填历史或用户权益。Core外部尾部流水未汇总为整月现金流。

## 报价与Funding

- 参考中点=(1K bid+1K ask)/2；Long成本=(100K ask/中点−1)×100000；Short成本=(1−100K bid/中点)×100000。bps=成本/100000×10000。
- 沿用持久化有效时段版本，America/New_York转换到UTC；每小时一个槽。标准休市、缺本地记录、来源无/无效报价、陈旧（>600秒）、未来（<−60秒）、未知日程分开。未覆盖完整假期与临时休市，命名“标准开市小时可用率”。
- 成本分布只用合格报价，按ticker+报价时间+1K/100K价格去重。新市场单列，观测从首次发现后下一个整点开始；每市场n与起止时间保留。
- 9月旧报价导出用base中点，未强行与本期1K中点对比；本月前后窗采用同法。
- v1 Swap funding_rate=0为占位，不是零融资。原始Perp值及周期保留，历史方向未全核验不进入成本。当前官方迁移文档说明v1 Perp为年化decimal，不据当前定义伪造缺失的历史applied事件。
- R3固定10/21 16:48:26—10/28 18:48:26；Var每腿5个模型付款，TradeXYZ每腿170个事件。固定输入、冻结公式、哈希pin；Decimal逐周期结果和Fraction独立相等。技术准入NO、动态权益OFFLINE、正式账本与真实结算未核实。不报告全月或实际收益。

## 公开包复算范围

本公开包包含派生汇总数据、共用图表数列和中英文生成源文件。使用[复算说明](RUNBOOK.md)可从这些输入重建图表和正文；不含原始事件和逐地址表，因而不能仅依靠公开包重新核验每条交易分类或地址映射。

最终读者口径见[中文说明](FINAL_METHODS.md)及[English methods](FINAL_METHODS_EN.md)。其中活动结算池为独立的资金事件日聚合；不是存款地址，也不是交易日活。日趋势仅显示完整日，七日线不跨缺口。完整来源与公开表映射见[数据覆盖情况](DATA_INVENTORY.md)。
