List Positions

List Positions.

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
  }
]

List Positions through the DexBuilder PerpDEX REST API.

Authorizations

KEY · string · header · required

DexBuilder API Key

Timestamp · string · header · required

Unix 時間戳（秒），與目前時間差不得超過 60 秒

SIGN · string · header · required

使用 API Secret 對簽名字串執行 HMAC-SHA512 後的十六進制簽名

Path Parameters

settle · enum<string> · required

結算幣種

Available options: usdt

Query Parameters

holding · boolean

true 僅回傳實際持倉，false 回傳全部

limit · integer

單次回傳的最大記錄數量

offset · integer

清單偏移量，從 0 開始

Response

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