查询持仓详情

查询持仓详情

GET /api/v4/broker/prediction/positions/{position_id}

查询持仓详情

cURL

curl --request GET \
  --url https://api.dexbuilder.com/api/v4/broker/prediction/positions/{position_id} \
  --header 'KEY: <api-key>' \
  --header 'SIGN: <sign>' \
  --header 'Timestamp: <timestamp>' \
  --header 'X-User-Wallet-Address: <x-user-wallet-address>'

200

{
  "available_size": "<string>",
  "avg_open_price": "<string>",
  "claimable_amount": "<string>",
  "event_id": "<string>",
  "locked_size": "<string>",
  "outcome": "<string>",
  "position_id": "<string>",
  "position_value": "<string>",
  "settlement_status": "<string>",
  "size": "<string>",
  "token_id": "<string>",
  "updated_at": 123,
  "won": true
}

此接口仅供 Broker 使用。请求须携带 Broker API Key、Timestamp、SIGN 和 X-User-Wallet-Address。网关确认钱包属于当前 Broker 后转发。请按外部 /api/v4/broker/... 路径计算签名。详见Broker API 认证与签名.

查询持仓详情。

授权

KEY · string · header · 必填

Broker API Key（由项目方管理流程创建）

请求头

Timestamp · string · 必填

Unix 秒级时间戳，与网关时间差不超过 60 秒

SIGN · string · 必填

按实际外部请求路径、Query 和 Body 生成的 HMAC-SHA512 十六进制签名

X-User-Wallet-Address · string · 必填

目标终端用户的钱包地址；网关校验该钱包属于当前 Broker

路径参数

position_id · string · 必填

响应

200

application/json

请求成功

响应对象。

available_size · string

avg_open_price · string

claimable_amount · string

event_id · string

locked_size · string

outcome · string

position_id · string

position_value · string

settlement_status · string

size · string

token_id · string

updated_at · integer

won · boolean