跳到导航
REST API

倉位

以 Markdown 格式查看

註解

倉位端點需要交易許可。

設定槓桿

POST /v1/private/position/leverage
Content-Type: application/json

請求正文：

{
  "symbol": "BTCUSDT",
  "leverage": 20
}

回應欄位：

場地類型描述
symbolstring象徵
leverageint32槓桿
timestampint64時間戳記

設定邊際模式

POST /v1/private/position/margin-mode
Content-Type: application/json

請求正文：

{
  "symbol": "BTCUSDT",
  "marginMode": 1
}

marginMode： 1 十字架， 2 孤立。

倉位設定

GET /v1/private/position/settings?symbol=BTCUSDT

回應欄位：

場地類型描述
symbolstring象徵
marginModeint321 十字架， 2 孤立
leverageint32槓桿

現任職務

GET /v1/private/position/positions?symbol=BTCUSDT

請求參數：

參數類型必修描述
symbolstring不象徵

回應欄位：

場地類型描述
positions[].symbolstring象徵
positions[].marginModestring邊際模式
positions[].positionSidestring倉位側
positions[].leverageint32槓桿
positions[].quantitystring倉位量
positions[].entryPricestring入場價格
positions[].breakEvenPricestring損益平衡價格
positions[].liqPricestring清算價格
positions[].marginRatiostring利潤率
positions[].unrealizedPnlstring未實現的PnL
positions[].roestring股東權益報酬率
positions[].nextFundingFeestring預計下一筆資金
positions[].fundingFeeAccumstring累積資金費
positions[].tpPricestring獲利了結價格
positions[].slPricestring停損價格

倉位歷史

GET /v1/private/position/history?symbol=BTCUSDT&page=1&pageSize=20

請求參數：

參數類型必修描述
symbolstring不象徵
sidestring不long / short
startTimeint64不開賽時間
endTimeint64不終結時間
pageint64不頁碼，預設 1
pageSizeint64不每頁項目數，預設 20

回應欄位：

場地類型描述
list[].symbolstring象徵
list[].positionSidestring倉位側
list[].leverageint32槓桿
list[].maxQuantitystring最大倉位量
list[].entryPricestring入場價格
list[].closePricestring收盤價
list[].pnlstring實現的PnL
list[].roestring股東權益報酬率
list[].marginModestring邊際模式
list[].triggerModeint32關閉觸發模式
list[].fundingFeeAccumstring累積資金費
list[].openedAtint64開放時間
list[].closedAtint64收工時間
totalint64總計數

相關文件

  • [保證金規則]（/trading/margin-rules）
  • 【槓桿機制】（/trading/leverage-mechanics）
  • [風險與清算]（/trading/risk-and-liquidations）
  • [私人用戶通道]（/developer-api/websocket/private-user-channel）

相關頁面