Get Position Margin Change History

Info

• This endpoint requires signature. For specific signature rules, please refer to Authentication
• This endpoint will trigger rate limit. For specific rules, please refer to Rate Limit.

HTTP request

GET /futures/position-margin-history

Request parameters

Parameter Name	Required	Type	Notes
market	false	string	Market name
market_type	true	string	Market type. Note: In spot related functions, only SPOT or MARGIN can be used. In futures related functions, only FUTURES can be used.
position_id	false	int	Position ID
start_time	false	int	Query start time. Data will not be filtered based on time by default
end_time	false	int	Query end time. Data will not be filtered based on time by default
page	false	int	Number of pagination. Default is 1
limit	false	int	Number in each page. Default is 10

Return parameters

Parameter Name	Type	Notes
market	string	Market name
market_type	string	Market Type
position_id	int	Position ID
margin_mode	string	Position type
leverage	int	Leverage
liq_price	string	Liquidation price. (Long position) Forced liquidation price = Settlement price* (1 - forced liquidation margin rate)/(1 - maintenance margin rate) (Short position) Forced liquidation price = Settlement price*(1 + forced liquidation margin rate)/(1 + maintenance margin rate)
bkr_price	string	Bankruptcy price. (Long position) Bankruptcy price = Settlement price* (1 - forced liquidation margin rate) (Short position) Bankruptcy price = Settlement price* (1 + liquidation margin rate)
settle_price	string	Settlement price, calculated as mark price
open_interest	string	Position
margin_avbl	string	Margin available after execution.Current margin amount = Initial margin + added margin - reduced margin
margin_change	string	Adjusted margin amount. Positive means increasing the margin, and negative means decreasing the margin.
created_at	int	Data creation time

---

Request example

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

Response example

{
    "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
    }
}