简介
Conviction 公共 API 提供对 ZetaChain 上预测市场数据的编程访问。使用它可以检索市场信息、概率、订单簿数据和价格历史。
基础 URL
所有 API 请求应发送至:
https://api.conviction.bet/v1
响应格式
所有端点返回 JSON 响应。成功响应直接包含数据:
{
"markets": [...],
"total": 42,
"limit": 20,
"offset": 0
}
错误响应返回标准错误格式:
{
"statusCode": 404,
"message": "Market not found",
"error": "Not Found"
}
可用端点
| 端点 | 描述 |
|---|---|
GET /v1/markets | 列出市场(支持筛选和分页) |
GET /v1/markets/:id | 通过 UUID 获取市场详细信息 |
GET /v1/markets/slug/:slug | 通过 Slug 获取市场详细信息 |
GET /v1/markets/:id/orderbook | 获取特定结果的当前订单簿 |
GET /v1/markets/slug/:slug/orderbook | 通过 Slug 获取当前订单簿 |
GET /v1/markets/:id/prices-history | 获取特定结果的历史价格数据 |
GET /v1/markets/slug/:slug/prices-history | 通过 Slug 获取历史价格数据 |
数据约定
- 价格 以十进制字符串表示(例如,
"0.670"= 67% 概率) - 交易量 以 USDC 为单位,保留2位小数(例如,
"1250.00") - 时间戳 采用 ISO 8601 格式(例如,
"2026-01-15T00:00:00Z") - 分页 使用
limit和offset参数