查询用户持仓列表

查询用户永续合约持仓列表

GET /dex_futures/{settle}/positions

查询用户持仓列表

cURL

curl --request GET \
  --url https://api.dexbuilder.com/api/v1/dex_futures/{settle}/positions \
  --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

查询参数

holding · boolean

true 仅返回实际持仓，false 返回全部

limit · integer

单次返回的最大记录数量

offset · integer

列表偏移量，从 0 开始

响应

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