支持的市场
了解 PolyTest API 提供的资产、时间周期、数据结构和可用性策略。
资产与时间周期
6 种资产PolyTest 按资产跟踪 Polymarket 上的预测市场。每种资产支持部分市场时间周期（从开盘到结算的时长）。所有时间周期的快照采集频率均为每秒 8×。在 API 中使用 coin 和 market_type 进行过滤。
| 资产 | 时间周期 |
|---|---|
BTC Bitcoin
| 5m15m1hr4hr24hr |
ETH Ethereum
| 5m15m1hr |
SOL Solana
| 5m15m1hr |
XRP XRP 即将推出正在采集数据
| 5m15m1hr4hr24hr |
DOGE Dogecoin 即将推出正在采集数据
| 5m15m1hr4hr24hr |
BNB BNB 即将推出正在采集数据
| 5m15m1hr4hr24hr |
每个市场的快照数约等于 时长 × 8（例如 5m ≈ 2,400，24h ≈ 691,200）。
数据可用性
数据可用性取决于你的套餐：Builder（以及完整包含 Builder 的 3 天免费试用）覆盖近期窗口，而 Pro 和 Enterprise 可无限制访问历史数据。对于范围查询，每个请求最多支持 31 天的窗口。
Builder
14 天
可访问约 14 天的历史市场和快照数据，3 天免费试用期间同样如此。
Pro
热门无限
完整访问历史数据。
Enterprise
无限
完整历史访问，外加自定义数据可用性策略和批量导出。
最大数据窗口：start_time 到 end_time 的跨度上限为 31 天。超过 31 天的数据会被清除。
市场对象结构
API 返回的每个市场都包含以下字段。
| 字段 | 类型 |
|---|---|
market_id | string |
event_id | string |
slug | string |
market_type | string |
coin | string |
start_time | ISO 8601 |
end_time | ISO 8601 |
price_start | number |
price_end | number | null |
winner | string | null |
final_volume | number |
final_liquidity | number |
condition_id | string |
clob_token_up | string |
clob_token_down | string |
resolved_at | ISO 8601 | null |
created_at | ISO 8601 |
updated_at | ISO 8601 |
快照对象结构
快照记录市场在某一时点的状态，包括价格、概率和可选的订单簿深度。
| 字段 | 类型 |
|---|---|
id | integer |
market_id | string |
time | ISO 8601 |
spot_price | number | null |
price_up | number | null |
price_down | number | null |
orderbook_up | object | null |
orderbook_down | object | null |
只有在请求中传入 include_orderbook=true 时才会包含订单簿字段。订单簿数据仅在 Builder、Pro 和 Enterprise 套餐中提供。
市场如何运作
每个市场代表一个二元预测：在市场的时间周期内，某种加密货币的价格会上涨（Up）还是下跌（Down）？
市场生命周期
- 1市场开盘：设置
start_time，开始交易 - 2以每秒 8× 的频率采集快照：概率价格实时更新
- 3市场结算：
winner被设为 "Up" 或 "Down" - 4数据归档：快照仍可通过 API 查询
概率价格
price_up 和 price_down 表示市场隐含概率，范围为 0.00 到 1.00。
price_up = 0.65 表示市场认为结算时资产价格更高的概率为 65%。
这些价格来自 Polymarket 订单簿，并随每条快照更新。