> ## Documentation Index
> Fetch the complete documentation index at: https://dexbuilder.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API 概览

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

## Base URL

```text theme={null}
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 认证与签名](https://dexbuilder.mintlify.site/zh/event-markets/api/broker-authentication.md)。

## 接口访问模型

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

## 分页

列表接口使用游标分页：

```json theme={null}
{"items":[],"next_cursor":"opaque-cursor"}
```

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

## 时间约定

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

## 多语言字段

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

```json theme={null}
{"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` | 上游或服务暂时不可用 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.