調整持倉保證金

增加或減少指定持倉保證金

POST /dex_futures/{settle}/positions/{contract}/margin

調整持倉保證金

cURL

curl --request POST \
  --url https://api.dexbuilder.com/api/v1/dex_futures/{settle}/positions/{contract}/margin \
  --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 · 必填

永續合約

查詢參數

change · 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