简介

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"
  • 分页 使用 limitoffset 参数