> ## 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.

# 账户活动

> 查询当前认证账户的事件市场持仓、成交和相关账户活动。

> [!NOTE]
>
> 以下私有接口示例使用 Broker API Key。每次请求都需携带 `KEY`、`Timestamp`、`SIGN` 和 `X-User-Wallet-Address`；签名使用实际外部请求路径、Query String 和 Body。 [Broker API 认证与签名](https://dexbuilder.mintlify.site/zh/event-markets/api/broker-authentication.md)。

事件市场 API 提供当前认证账户的持仓和成交记录。相关接口属于私有接口，需要完成认证后调用。

生产环境 Base URL：

```text theme={null}
https://api.dexbuilder.com
```

## 查询持仓

```bash cURL theme={null}
curl -G "https://api.dexbuilder.com/api/v4/broker/prediction/positions" \
  -H "KEY: ${BROKER_API_KEY}" \
  -H "SIGN: ${SIGN}" \
  -H "Timestamp: ${TIMESTAMP}" \
  -H "X-User-Wallet-Address: ${WALLET}" \
  --data-urlencode "event_id=<event_id>" \
  --data-urlencode "condition_id=<condition_id>" \
  --data-urlencode "settlement_status=OPEN" \
  --data-urlencode "limit=20"
```

常见返回字段包括：

| 字段 | 说明 |
| - | - |
| `position_id` | 持仓 ID |
| `event_id` | 事件 ID |
| `token_id` | 结果代币 ID |
| `outcome` | 对应结果 |
| `size` | 总持仓数量 |
| `available_size` | 可用数量 |
| `locked_size` | 锁定数量 |
| `avg_open_price` | 平均开仓价格 |
| `position_value` | 当前持仓价值 |
| `settlement_status` | 结算状态 |
| `won` | 市场结算后是否获胜 |
| `updated_at` | 最后更新时间 |

使用返回的 `next_cursor` 作为下一页请求的 `cursor`。

## 查询单个持仓

```bash cURL theme={null}
curl "https://api.dexbuilder.com/api/v4/broker/prediction/positions/<position_id>" \
  -H "KEY: ${BROKER_API_KEY}" \
  -H "SIGN: ${SIGN}" \
  -H "Timestamp: ${TIMESTAMP}" \
  -H "X-User-Wallet-Address: ${WALLET}"
```

## 查询个人成交

```bash cURL theme={null}
curl -G "https://api.dexbuilder.com/api/v4/broker/prediction/usertrades" \
  -H "KEY: ${BROKER_API_KEY}" \
  -H "SIGN: ${SIGN}" \
  -H "Timestamp: ${TIMESTAMP}" \
  -H "X-User-Wallet-Address: ${WALLET}" \
  --data-urlencode "condition_id=<condition_id>" \
  --data-urlencode "token_id=<token_id>" \
  --data-urlencode "limit=20"
```

个人成交记录通常包含 `trade_id`、`order_id`、`condition_id`、`token_id`、`price`、`size`、`side`、`role` 和 `fee_rate` 等字段。

## 查询范围

当前接口主要围绕已认证账户提供数据，包括：

* 持仓；
* 个人成交；
* 订单；
* 账户资产和资金流水；
* 结算与领取记录。

> [!NOTE]
>
> 账户类接口用于查询当前认证用户的数据，不建议将其理解为任意钱包地址的公开链上查询接口。


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