查询单个持仓

查询指定合约的持仓信息

GET /dex_futures/{settle}/positions/{contract}

查询单个持仓

cURL

curl --request GET \
  --url https://api.dexbuilder.com/api/v1/dex_futures/{settle}/positions/{contract} \
  --header 'KEY: <api-key>' \
  --header 'SIGN: <api-key>' \
  --header 'Timestamp: <api-key>'

200

{
  "user": 123,
  "contract": "<string>",
  "size": "<string>",
  "leverage": "<string>",
  "risk_limit": "<string>",
  "leverage_max": "<string>",
  "maintenance_rate": "<string>",
  "value": "<string>",
  "margin": "<string>",
  "entry_price": "<string>",
  "liq_price": "<string>",
  "mark_price": "<string>",
  "unrealised_pnl": "<string>",
  "realised_pnl": "<string>",
  "mode": "<string>",
  "cross_leverage_limit": "<string>",
  "pid": 123
}

查询指定合约的单向持仓信息。

授权

KEY · string · header · 必填

DexBuilder API Key

Timestamp · string · header · 必填

Unix 时间戳（秒），与当前时间差不得超过 60 秒

SIGN · string · header · 必填

使用 API Secret 对签名字符串执行 HMAC-SHA512 后的十六进制签名

路径参数

settle · enum<string> · 必填

结算币种

可用选项: usdt

contract · string · 必填

永续合约

响应

200 - application/json

查询成功

永续合约持仓

user · integer<int64>

用户 ID

contract · string

合约

size · string

持仓数量

leverage · string

逐仓杠杆；0 表示全仓

risk_limit · string

风险限额

leverage_max · string

最大杠杆

maintenance_rate · string

维持保证金率

value · string

持仓价值

margin · string

保证金

entry_price · string

开仓均价

liq_price · string

预估强平价

mark_price · string

标记价格

unrealised_pnl · string

未实现盈亏

realised_pnl · string

已实现盈亏

mode · string

持仓模式

cross_leverage_limit · string

全仓杠杆

pid · integer<int64>

Position ID