取得倉位自動結算歷史記錄

資訊

• 此介面需要簽名，具體簽名規則請參閱認證
• 此介面會觸發限頻，具體規則請參閱限頻

提示

自動結算是指將未實現盈虧到期結算為已實現盈虧放在倉位保證金，結算時的倉位保證金有超額保證金，支持手動轉入（逐倉模式）和自動結算轉入（全倉模式）到可用餘額，結算週期支援動態調整，預設每8小時1次，若市場溢價率過高，結算週期可能會動態調整為4小時或2小時。

HTTP 請求

GET /futures/position-settle-history

請求參數

參數名	是否必須	類型	說明
market	false	string	市場名稱
market_type	true	string	市場類型。 注意：在現貨相關功能中，僅可使用SPOT 或MARGIN 在合約相關功能中，只可使用FUTURES
position_id	false	int	倉位ID
start_time	false	int	查詢開始時間。 預設不根據時間過濾資料
end_time	false	int	查詢結束時間。 預設不根據時間過濾資料
page	false	int	分頁頁數。預設頁數為1
limit	false	int	分頁數量。預設頁數為10

請求回應

參數名	類型	說明
market	string	市場名稱
market_type	string	市場類型
position_id	int	倉位ID
margin_mode	string	倉位類型
leverage	int	槓桿倍數
liq_price	string	強平價。 （多倉）強平價=結算價格*（1-強平保證金率）/（1-維持保證金率） （空倉）強平價=結算價格*（1+強平保證金率）/ （1+維持保證金率）
bkr_price	string	破產價格。 （多倉）破產價=結算價格*（1-強平保證金率） （空倉）破產價=結算價格*（1+強平保證金率）
settle_price	string	結算價格，以標記價格計算
open_interest	string	持倉數量
margin_avbl	string	成交後的可用保證金。當前保證金數量=起始保證金+追加保證金-減少保證金
margin_change	string	調整的保證金數量，為正表示增加保證金，為負表示減少保證金。
created_at	int	資料創建時間

---

請求範例

GET /futures/position-settle-history?market=CETUSDT&market_type=FUTURES&position_id=927266133&start_time=1636451914231&page=1&limit=100

回應範例

{
    "code": 0,
    "message": "OK",
    "data": [
        {
        "market": " CETUSDT",
        "market_type": "FUTURES",
        "position_id": 927266133,
        "margin_mode": "cross",
        "leverage": "10",
        "liq_price": "0.05679",
        "bkr_price": "0.053635",
        "settle_price": "0.06817",
        "open_interest": "129384.12"
        "margin_avbl": "189132.05",
        "margin_change": "5000",
        "created_at": 1691482451000
        }
    ],
    "pagination": {
        "has_next": false
    }
}