Order history

Access historical order data, for one currency. Same default and isolation as Open orders: trade_currency defaults to USDT when omitted, never mixed, each order tagged.

Request

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

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

# Next page (offset = last order's created_at in epoch ms, plus 1)
curl -X GET "https://trade.mudrex.com/fapi/v1/futures/orders/history?limit=50&offset=1769616001001" \
  -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).
`offset`	number	No	Time cursor in epoch milliseconds. Returns orders whose `created_at` is at or before this value. See Notes.

Response

Status: 200 OK (INR)

{
    "success": true,
    "data": [
        {
            "created_at": "2026-01-28T16:00:01Z",
            "updated_at": "2026-01-28T16:00:01Z",
            "reason": null,
            "actual_amount": 7037.79,
            "quantity": 240,
            "filled_quantity": 240,
            "price": 0.30728,
            "filled_price": 0.30546,
            "leverage": 50,
            "hedge_rate": 96,
            "order_type": "SHORT",
            "trigger_type": "MARKET",
            "trade_currency": "INR",
            "status": "FILLED",
            "id": "019c0555-6ff2-76f0-8203-a41ee05653a7",
            "client_order_id": null,
            "asset_uuid": "019913c2-9b01-7d79-9c9d-7766751435d5",
            "symbol": "SOMIUSDT",
            "future_position_uuid": "019c0554-37ac-7d08-acc1-3d5e97ff460d",
            "position_id": "019c0554-37ac-7d08-acc1-3d5e97ff460d"
        }
    ]
}

Response fields

Field	Description
`id`	Order UUID.
`client_order_id`	Client order id, or `null` if not set. See Client order ID.
`position_id`	UUID of the position the order belongs to. Same value as `future_position_uuid`. See Order and position IDs.
`future_position_uuid`	Position UUID. Same value as `position_id`.
`asset_uuid`	Asset UUID.
`symbol`	Trading pair (e.g. `XRPUSDT`).
`order_type`	`LONG`, `SHORT`, `STOPLOSS`, or `TAKEPROFIT`.
`trigger_type`	`MARKET` or `LIMIT`.
`status`	Order status (e.g. `CREATED`, `FILLED`, `CANCELLED`, `SYSTEM_CANCELLED`).
`trade_currency`	`USDT` or `INR`.
`quantity` / `filled_quantity`	Ordered and filled quantity (base asset).
`price` / `filled_price`	Order price and average fill price (USDT).
`actual_amount`	Order value (quantity × price) in `trade_currency`. On partially filled orders with the remainder cancelled, see the known issue below.
`leverage`	Leverage.
`hedge_rate`	INR/USDT rate for the order (`1` for USDT).
`reason`	Placement result, e.g. `{"message": "OK"}`, or `null`.
`created_at` / `updated_at`	ISO-8601 timestamps (UTC).

🚧
Known issue: actual_amount on partially filled orders
When an order is partially filled and the remainder is cancelled, actual_amount returns price × ordered quantity instead of the filled value, and status can remain PARTIAL_FILLED. Fully filled orders are not affected. Trading fees are charged on the filled quantity only.
Workaround: calculate the filled notional from the fill fields.

USDT orders: filled_quantity × filled_price

INR orders: filled_quantity × filled_price × hedge_rate (filled_price is always in USDT)

Notes

Orders are sorted by created_at, newest first. Without limit, the response returns the 20 newest orders. page and per_page are not supported.
offset is a time cursor (epoch ms), not a row or page index. Orders with created_at equal to offset are included. To page through history:
1. Call with a chosen limit (and trade_currency).
2. Read created_at of the last order and convert it to epoch milliseconds.
3. Call again with the same limit and offset=<that epoch ms + 1>.
4. Drop orders whose id was already received. Stop when a page returns no new id.
CANCELLED orders are listed, including LIMIT orders cancelled before any fill. The position_id of such an order is not returned by Open Positions or Position history.
SYSTEM_CANCELLED stop-loss and take-profit orders are not listed. Use Order by id.

Request

Response

Known issue: actual_amount on partially filled orders

Notes

Known issue: `actual_amount` on partially filled orders