Skip to main content
返回应用

API 简介

Conviction 的公开接口是 REST,目前为只读。所有公开路由都以 /v1/ 开头。

#基础 URL

https://api.conviction.bet

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

#路径 prefix

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

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

该主机上的其他路由(登录、入金、下单、管理员、Webhook 等)不属于公开 API:它们要么需要认证,要么仅供内部使用,不在此处文档化,并且可能随时变更而不另行通知。

#涵盖哪些内容

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

  • 公开市场数据(无需认证) —— 市场列表 / 详情、盘口(orderbook)、时序价格(price history)。任何人都可以调用。参见 REST → Markets。
  • EIP-712 签名域 —— 订单签名所使用的域,公开以供参考。参见 EIP-712 签名域。

通过 API 下单目前尚未开放。待可以在账户中签发 API 密钥后,写入类端点会逐步向机器人和做市商开放。

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

#请求格式

  • 所有公开端点都是 GET,只接收路径参数和查询参数——没有请求体。
  • 响应中的时间为 ISO-8601 字符串。时序价格端点是例外:它接收并返回 unix seconds。

#响应格式

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

#下一步

本页面是否有帮助?