取得倉位資金費率紀錄

資訊

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

提示

資金費用機制是為了使合約市場價格錨定現貨價格，合約市場價格與現貨市場價格一旦存在價差，持倉者需要定期向多頭或空頭交易者支付一定的資金費用

HTTP 請求

GET /futures/position-funding-history

請求參數

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

請求回應

參數名	類型	說明
market	string	市場名稱
market_type	string	市場類型
ccy	string	結算幣種名稱
position_id	int	倉位ID
side	string	倉位方向
margin_mode	string	倉位類型
open_interest	string	持倉數量
settle_price	string	結算價格
funding_rate	string	資金費率
funding_value	string	資金費用
created_at	int	資料創建時間

---

請求範例

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

回應範例

{
    "code": 0,
    "message": "OK",
    "data": [
        {
        "market": " CETUSDT",
        "market_type": "FUTURES",
        "ccy": "USDT",
        "position_id": 927266133,
        "side": "long",
        "margin_mode": "cross",
        "open_interest": "129384.12"
        "settle_price": "0.0642",
        "funding_rate": "0.0003",
        "funding_value": "2.49193815",
        "created_at": 1691482451000
        }
    ],
    "pagination": {
        "has_next": false
    }
}