README.md

# Polymarket OrderFilled Analytics

这是存放在 Hugging Face Storage Bucket 中的 Polymarket CLOB V1 与 V2
`OrderFilled` 每日和月度聚合结果，供 Gradio Space 快速读取。Space 不需要
扫描原始的十亿级事件数据。

## 当前快照

| 项目 | 数值 |
|---|---:|
| V1 OrderFilled | 1,206,105,187 |
| V2 OrderFilled | 575,630,861 |
| 合计 | 1,781,736,048 |
| 月份范围 | 2022-11 ～ 2026-08 |
| UTC 日期范围 | 2022-11-21 ～ 2026-08-03 |
| 月度指标行数 | 1,773 |
| 每日指标行数 | 49,186 |
| 生成时间 | 2026-08-04T02:30:28.990697+00:00 |

## 指标口径

- `fill_event_count`：`OrderFilled` 事件数。
- `unique_transaction_count`：包含成交事件的唯一 Polygon 交易哈希数。
- `nominal_collateral_volume`：订单抵押资产腿的名义金额。V1 使用 USDC.e，
  V2 使用 pUSD，均按 6 位原始精度换算。
- `fee_amount`：`OrderFilled.fee` 按 6 位原始精度换算后的合计。
- `category`：由版本化 Gamma tag 分类配置解析出的唯一主分类；`all` 为总量，
  `other` 包含未命中分类规则或尚未匹配 Gamma token 的成交。
- `is_complete`：是否为已经结束的 UTC 自然月；每日文件沿用所属月份状态。

`nominal_collateral_volume` 是基于 `OrderFilled` 的订单级名义金额，不应直接解释为
Polymarket 官方 Volume。

## 文件

- `monthly_metrics.parquet`：Space 使用的主数据。
- `monthly_metrics.csv`：便于人工检查。
- `daily_metrics.parquet`：按 UTC 日期聚合的数据。
- `daily_metrics.csv`：每日指标的 CSV 版本。
- `aggregation_state.json`：源仓库 revision 和月分区指纹，用于增量更新。