API 简介

Conviction 的公开接口是 REST。所有公开路由都以 /v1/ 开头。

#基础 URL

https://api.conviction.bet

本文档的所有示例都以该 URL 为准。

#路径 prefix

公开路由全部以 /v1/... 开头。

GET https://api.conviction.bet/v1/markets?status=ACTIVE

不以 /v1/ 开头的端点（用户认证、入金、管理员、Webhook 等）不对外公开。

#涵盖哪些内容

本参考面向开发者·机器人·做市商，涵盖以下两部分。

• 公开市场数据（无需认证） —— 市场列表 / 详情、盘口（orderbook）、时序价格（price history）。任何人都可以调用。参见 REST → Markets。
• 以程序方式签署订单 —— 面向不经过 UI、直接挂单的机器人·做市商的 EIP-712 订单结构。参见 EIP-712 订单签名。

普通用户不需要本参考 —— UI 会处理全部过程。

#请求格式

• 所有请求体均为 JSON（Content-Type: application/json）。
• 时间为 ISO-8601 或 unix seconds（由各端点说明）。

#响应格式

成功响应是依各端点规范返回的 JSON。失败响应为标准错误 envelope。

#下一步

• 认证 —— 公开端点无需认证
• 错误 —— 响应 envelope、validation message 数组
• 分页 —— 所有 list 端点通用
• REST → Markets —— 公开市场数据端点
• EIP-712 订单签名 —— 面向以程序方式创建订单的机器人·做市商