Position history

Review your past closed positions for performance tracking, for one currency. Same default and isolation as Open Positions. PnL is in the position's currency.

Request

# USDT (default)
curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions/history?limit=2" \
  -H "X-Authentication: your-secret-key"

# INR
curl -X GET "https://trade.mudrex.com/fapi/v1/futures/positions/history?limit=5&trade_currency=INR" \
  -H "X-Authentication: your-secret-key"

Parameters

Parameter	Type	Required	Description
`trade_currency`	string	No	`USDT` or `INR`. Defaults to `USDT`. One currency per call.
`limit`	number	No	Maximum number of records to return (default: 20).

Response

Status: 200 OK

{
    "success": true,
    "data": [
        {
            "id": "019c0555-aa2e-73e5-86cf-3a2167c62cfc",
            "position_type": "LONG",
            "status": "LIQUIDATED",
            "leverage": "50",
            "entry_price": "0.31169",
            "closed_price": "0.30546",
            "quantity": "240",
            "pnl": "-143.53",
            "symbol": "SOMIUSDT",
            "trade_currency": "INR",
            "entry_hedge_rate": "96",
            "exit_hedge_rate": "96"
        }
    ]
}

Response fields

Field	Description
`id`	Position ID (UUID).
`position_type`	Position type: `LONG` or `SHORT`.
`status`	Position status (e.g. `LIQUIDATED`, `CLOSED`).
`leverage`	Leverage used for the position.
`entry_price`	Price at which the position was opened (USDT).
`closed_price`	Price at which the position was closed (USDT).
`quantity`	Position quantity (base asset).
`pnl`	Realised PnL for the closed position, in `trade_currency`.
`symbol`	Trading symbol (e.g. "SOMIUSDT").
`trade_currency`	Currency of the position: `USDT` or `INR` (additive).
`entry_hedge_rate`	INR/USDT rate captured at entry (additive, INR positions).
`exit_hedge_rate`	INR/USDT rate captured at exit (additive, INR positions).