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 和月分区指纹，用于增量更新。