本页面讨论的是
data-api.polymarket.com 提供的 Data API，与 CLOB
V2（交易基础设施升级）无关。变化内容
响应结构。 v1 路由返回裸数组或裸对象。v2 的每个响应都把有效负载包在data 中，分页路由额外返回 pagination 对象。查询无结果时返回
data: null 或空列表，绝不会返回错误。
分页。 v1 通过 limit/offset 分页，且 offset 上限为 10,000 行。
v2 通过不透明游标分页：跟随 pagination.next_cursor 直到其为 null，
无需管理 offset 计算，且数据流路由在新行写入期间保持一致。参见
Data API v2 概览中的分页说明。
字段命名。 v1 响应使用 camelCase（proxyWallet、conditionId）。
v2 响应使用 snake_case（proxy_wallet、condition_id）。v2 的请求参数
同时接受两种拼写。
市场选择。 v1 用 market 参数选择市场。v2 统一为 condition
（别名 condition_id、conditionId），最多接受 20 个不同的逗号分隔
condition id。event_id 过滤保持不变。
仓位生命周期。 v2 把三个 v1 路由合并为一个：GET /v2/positions 通过
status 过滤器（OPEN、REDEEMABLE、CLOSED）服务完整生命周期，每行
携带 redeemable 与 mergeable 标志，取代了独立的 /closed-positions
和 /v1/market-positions 路由。
路由映射
每个 v2 接口页面记录了完整的参数集与行结构；多个路由接受 v1 对应路由
不支持的过滤器。
v2 新增
v2 新增以下读取能力。用户资料统计也涵盖原有的已交易市场计数：继续使用 v1
GET /v1/accounting/snapshot 没有 v2 对应版本。请继续使用原有路由。
SDK 迁移到 Data API V2
从0.10.0 版本开始，两个官方 SDK 均支持 Data API v2：TypeScript 包
@polymarket/client 和 Python 包 polymarket-client。迁移时需要更新的
破坏性变更、方法重命名、响应字段和分页行为，请参阅
TypeScript SDK 更新日志或
Python SDK 更新日志。