Polymarket Up/Down 市场查询

粘贴一个 slug,例如 btc-updown-5m-1780949100,即可获取该市场的时间窗口、参考价格、结果和成交量,包括 Polymarket 已不再提供订单簿的市场。

试试:

解读 slug

每个 Polymarket 加密货币 Up/Down 市场都有一个格式固定、可预测的 slug。学会解读之后,你可以直接为任意时间窗口构造 slug,而不必去搜索。

btc-updown-5m-1780949100
│   │      │   └── Unix timestamp: when the window OPENS, in UTC
│   │      └────── Timeframe: 5m | 15m | 1h | 4h | 24h
│   └───────────── Always "updown"
└───────────────── Coin: btc | eth | sol

陷阱:API 的 startDate 字段是市场对象创建的时间,而不是开始交易的时间,通常会早一天或更久。slug 中的时间戳才是真正的窗口开始时间,endDate 则是它加上时间周期。

Polymarket 保留了什么

市场一旦结算,Polymarket 会保留市场记录和一条稀疏的价格序列,并丢弃订单簿。请求已结算市场的订单簿会返回 404。它的价格历史大约每分钟一个点,而且只有在你显式传入开始和结束时间时才会返回:

curl -s "https://clob.polymarket.com/book?token_id=$TOK"
# {"error":"No orderbook exists for the requested token id"}   404

curl -s "https://clob.polymarket.com/prices-history?market=$TOK&startTs=$START&endTs=$END&fidelity=1"
# about 6 points for a 5-minute market

curl -s "https://clob.polymarket.com/prices-history?market=$TOK&interval=max"
# {"history":[]} for older markets

上面的查询之所以可行,是因为这些市场在运行期间就被记录了下来。更多机制细节请见 Up/Down 市场详解,汇总的结算统计则在市场数据页面。

常见问题

如何查询 Polymarket 的 btc-updown-5m 市场?
把 slug(例如 btc-updown-5m-1780949100)粘贴到上方的查询框。你会得到交易时间窗口、开盘和收盘时的参考价格、结算为哪一方,以及最终成交量。完整的 Polymarket 事件 URL 也可以,系统会从中提取 slug。省略末尾的时间戳则返回该系列最新的市场。
Polymarket Up/Down slug 末尾的数字是什么意思?
它是交易窗口开启时刻的 Unix 时间戳(UTC)。在 btc-updown-5m-1780949100 中,市场在该时间戳开盘,5 分钟后收盘。注意它与 API 的 startDate 字段不同,后者记录的是市场对象的创建时间,可能早一天或更久。
为什么找不到较早的 Polymarket 市场?
有两个原因。Polymarket 对已结算市场的订单簿返回 404,只保留大约每分钟一个点的价格历史。PolyTest 保留滚动 31 天的存档,所以超过 31 天前结算的市场在这里也找不到。到那时,据我们所知,订单簿已经在任何地方都不存在了。
能获取某个特定 Polymarket 市场的订单簿吗?
可以,通过 PolyTest API 获取,适用于 31 天窗口内的任何市场。每个市场都有时点快照,双边各 8 档深度,亚秒级精度,这正是模拟真实成交所需要的。对于已结算的市场,Polymarket 自己的 API 无法提供这些数据。