Skip to main content
Data API v2 用一套跨所有读取共享的契约取代了原有的按路由各自定义的契约。 可以逐个调用点迁移;新的集成应直接从 v2 开始。 两个版本都由 https://data-api.polymarket.com 提供服务,v2 路由位于 /v2 前缀下。
Data API v1 将于 2026 年 10 月 24 日停用。 请在此之前按下方的路由映射 迁移到 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、REDEEMABLE_LOST、MERGEABLE、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 更新日志。