# Polymarket成交量为何对不上：分清Global/US、份额、金额与统计窗口

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/polymarket-global-us-volume-unit-window-compare
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

对照已有数据表，把聚合交易所、单边事件成交量、双边用户成交量和时点OI分列，避免拼出错误同比或总量。

## 使用工具
- [Polymarket Global](https://lianxiaozhi.com/tools/polymarket) · [官方入口](https://polymarket.com/)

## 前置条件
- 准备已有市场页面、数据表或脱敏响应，保留原来源URL、产品、对象ID和取得时间；缺字段标未知。
- 匿名阅读本页官方来源并对照已有材料；不注册、登录、连接钱包、安装SDK、调用数据/交易API、取报价、下单、投注或发赎回。

## 1. 先核是哪一家产品的数据

在原图表或数据页记Global/International、US或两者聚合。官方data.polymarket.com明确合并US与International，US Daily Market Report和US Time & Sales也不能自动套到Global。

同品牌、美元符号或预测市场标题都不足以确认范围；没有拆分字段时，保留聚合值，不能用它替换Global的历史序列。

核对结果：每列都有产品范围和原链接；无法拆分的聚合值不进入Global同比。
依据：[官方数据页：US与International聚合范围](https://data.polymarket.com/)

## 2. 把事件、市场和用户口径分开

事件数据用event_id，市场用condition_id，用户统计用wallet。Event Live Volume可汇总多个事件下的市场，taker_volume_total是其返回市场之和，不另加一次分项。

其中taker_volume为累计单边taker份额；排行榜volume、user-volume的volume为双边份额，user-volume的volume_usdc为同一度量的美元金额。不要把份额写成美元，也不要用当前概率乘累计份额冒充历史成交金额。

核对结果：表内列明对象集合、单位和单双边；总计与分项、用户与市场不混加。
依据：[Global公开分析：事件成交量、OI与排行榜](https://docs.polymarket.com/market-data/public-analytics.md)
依据：[Global Data API v2公开接口契约](https://data-api.polymarket.com/v2/docs)

## 3. 对齐累计、24小时与UTC整日窗口

Gamma volume24hr说明是过去24小时成交量，所读Market Details未明确其单位和单双边细节，保留原字段待核。事件live-volume是累计，不能直接与月度报道并排算涨幅。

已有user-volume记录的start/end为epoch秒、含边界且按UTC整日归桶，省略或0为无界；这不是任意小时区间。先检查起止顺序：该契约把倒置窗口也返回零，零值不能独立证明没有成交。

核对结果：起止时区、滚动/日历/累计窗口、端点单位和倒置检查齐全；单位未知不换算。
依据：[Global Data API v2公开接口契约](https://data-api.polymarket.com/v2/docs)
依据：[Global市场字段与流动性、24小时成交量](https://docs.polymarket.com/market-data/market-details.md)

## 4. 把OI当持仓时点值读取

Data v2的OI是按价格计算的gross持仓价值，单位USDC，各结果不净额抵消；它不等于期间成交额、净流入或可成交深度。缺市场行表示未解析成可服务市场，和有行value=0不同。

原HTTP文档的全局行condition_id为GLOBAL，SDK Analytics则归一化为null/None；按原记录形状解释，不能由null自动判断市场不存在。缺少同一时点的价格或原始持仓时，不自行重算精确OI。

核对结果：OI独立成时点列；API/SDK形状、缺行/零值及金额单位分清。
依据：[Global公开分析：事件成交量、OI与排行榜](https://docs.polymarket.com/market-data/public-analytics.md)
依据：[Global Data API v2公开接口契约](https://data-api.polymarket.com/v2/docs)

## 5. 排查导出是否漏页或混入双边行

只检查已有导出，不发新请求。v2/trades的taker_only默认true，每个fill只列taker；false还含maker行，不把所有行数直接当独立成交数。cursor须走到next_cursor=null，并在每页保留相同过滤条件；变更过滤会重新定位。

v2/trades的start/end仅用户形状遵守；condition/event形状固定三年范围、无筛选的feed为当前及前一月，不能由写了日期参数就认定导出是该月。Data v1当前文档预告2026-10-24退役，10-14尚不能标作已退役；旧数组与v2 data/pagination分开解析。

核对结果：注明导出完整性、原filters、taker_only、API版本及实际可用窗口；不完整材料只描述已见部分。
依据：[Global Data API v2公开接口契约](https://data-api.polymarket.com/v2/docs)
依据：[Data API v1到v2迁移与退役日期](https://docs.polymarket.com/migrate/data-api-v1-to-v2.md)

## 6. 保留数据时效，输出可比较范围

已有status材料须分别读computed_at/age_seconds、serving和ingestion。status是后台快照，HTTP成功或ingestion接近头部都不能独立证明投影及时；没有时效材料就注明未核新鲜度。

最终只比较产品、对象、单位、单双边和时间一致的列；其余保留差异原因和缺项。记者的月度分析证明有近期数据关注，不替代本人重算，也不由成交量推出使用人数、流动性或未来结果。

核对结果：交付一张口径表和可比/不可比说明，未把文档样例或媒体数字当本次实时查询结果。
依据：[Global Data API v2公开接口契约](https://data-api.polymarket.com/v2/docs)

## 常见错误
- 将官方两交易所聚合图视为Global数据。
- 把双边份额、单边累计份额、美元金额、OI和流动性统称成交量。
- 将空行、字段null、倒置窗口零和真实有行零混为一谈。

## 完成检查
- 已有数字均能标明产品、对象、单位、单双边、窗口和时效；无法一致比较的数字保留原因。

## 相关知识
- [原始、解码和整理后的链上数据有什么区别？](https://lianxiaozhi.com/learn/raw-decoded-curated-data)
- [链上指标历史数值为什么会变？](https://lianxiaozhi.com/learn/point-in-time-metrics)

## 官方依据
- [官方数据页：US与International聚合范围](https://data.polymarket.com/)
- [Global公开分析：事件成交量、OI与排行榜](https://docs.polymarket.com/market-data/public-analytics.md)
- [Global Data API v2公开接口契约](https://data-api.polymarket.com/v2/docs)
- [Data API v1到v2迁移与退役日期](https://docs.polymarket.com/migrate/data-api-v1-to-v2.md)
- [Global市场字段与流动性、24小时成交量](https://docs.polymarket.com/market-data/market-details.md)