获取仓位自动结算历史记录

信息

• 该接口需要签名，具体签名规则请参阅认证
• 该接口会触发限频，具体规则请参阅限频

提示

自动结算是指将未实现盈亏到期结算为已实现盈亏放在仓位保证金，结算时的仓位保证金有超额保证金，支持手动转入（逐仓模式）和自动结算转入（全仓模式）到可用余额，结算周期支持动态调整，默认是每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
    }
}