跳转到主要内容
本文说明 DexBuilder 平台、事件市场和事件合约 API 的共同接入约定。各接口的参数、时间单位、分页方式、响应和错误字段以对应接口页为准。

​
接入地址与接口范围

生产环境 Base URL：
DexBuilder 平台的资产配置查询也使用 Broker API Key，但无需指定终端用户钱包。具体接口清单见代表用户访问。
PerpDEX 目前不支持 Broker API。PerpDEX 接口使用独立的 API Key 和认证规则，详见PerpDEX 认证与签名。

​
请求约定

  • 使用接口页标明的 HTTP 方法、路径、Query 参数和请求体。私有 REST 请求的签名必须依据实际发送的请求内容计算，详见Broker API Key 与签名。
  • Timestamp 请求头使用 Unix 秒级时间戳。业务字段的时间单位可能因产品和字段而异，请以接口字段说明为准。
  • 请求体、Query 参数的顺序和编码会影响签名。计算签名后，发送请求时保持参与签名的内容不变。
  • 列表接口的分页参数和返回结构以对应接口页为准。价格、数量和金额字段应按接口给出的类型处理，涉及精度时使用十进制数。

​
响应与错误

不同产品的业务响应和错误字段可能不同。请先根据 HTTP 状态码判断请求结果，再按照对应接口页及产品错误码页解析响应体。对提交类请求，若网络超时或收到不确定结果，应先查询操作状态，再决定是否重试；有幂等键要求的接口须按接口页提供幂等键。