Get Position

Get Position.

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
}

Get Position 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

contract · string · required

永續合約

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