API 概览

事件市场 API 的基础地址、访问模型、分页、时间与错误约定。

​

Base URL

https://api.dexbuilder.com

​

REST 路由与身份

类型	路径前缀
公开行情路径	/api/v4/prediction
Broker 代用户路径	/api/v4/broker/prediction

公开市场数据继续使用原路径，无需 Broker Key；订单、持仓、账户及结算等私有接口使用 Broker 路径。私有请求必须携带 Broker API Key、签名和 X-User-Wallet-Address，网关核验钱包属于当前 Broker。 详见Broker API 认证与签名。

​

接口访问模型

接口类型	是否需要认证	典型能力
市场发现	否	事件、市场、标签
市场数据	否	价格、Ticker、订单簿、历史数据、K 线
交易	是	下单、查询订单、撤单
账户	是	持仓、资产、余额、费率、个人成交
结算	是	平仓、领取、资金处理

​

分页

列表接口使用游标分页：

{"items":[],"next_cursor":"opaque-cursor"}

将上一页返回的 next_cursor 原样作为下一页的 cursor。不要自行解析或修改游标。

​

时间约定

• 事件与市场日期字段通常使用 Unix 秒；
• from、to 等范围参数通常使用 Unix 毫秒；
• 币种 K 线接口的 start_ts、end_ts 和 history[].t 使用 Unix 秒；Token 价格历史的 from、to 和时间字段使用 Unix 毫秒。订单和账户生命周期时间以各接口字段说明为准。

​

多语言字段

部分文本字段使用语言对象返回：

{"en":"Yes","cn":"是","tw":"是"}

​

数值字段

价格、数量、成交额、余额、手续费等金额类字段通常以字符串返回。建议使用 Decimal 精度处理，避免二进制浮点误差。

​

状态字段

Market 的 status 描述市场状态；REST 订单的 status 使用 processing、open、matched、canceled、failed。WebSocket 消息的 type 表示推送消息类型。请分别按市场、REST 订单和 WebSocket 频道的定义解析，不要共用一套状态枚举。

​

标准错误

错误响应包含 label 和 message。公开行情接口的参数错误使用 INVALID_PARAM_VALUE，行情源不可用使用 QUOTE_UNAVAILABLE；Broker 私有业务接口的参数错误可能使用 INVALID_ARGUMENT。请以具体接口的错误定义为准。

HTTP 状态	说明
400	请求参数或 Body 无效
401	私有接口认证失败
404	资源不存在或当前不可见
503	上游或服务暂时不可用