Guides
Guides

Order by id (to be deprecated)

Retrieve detailed information about a particular order.

🚧

Deprecated. Prefer Get order detail on the Client order ID page (GET /fapi/v1/futures/orders/detail). That route accepts order_id and/or client_order_id. This path-only UUID get remains available for existing integrations.

The order is uniquely identified by its UUID. You do not need to send trade_currency. The response includes the order's trade_currency and, for INR orders, hedge_rate.

To look up by client_order_id (or by either id), see Client order ID.

Request

curl -X GET "https://trade.mudrex.com/fapi/v1/futures/orders/{order_id}" \
  -H "X-Authentication: your-secret-key"

Parameters

ParameterTypeRequiredDescription
order_idstringYesThe unique identifier of the order (path parameter).

Response

Status: 200 OK (INR order)

{
    "success": true,
    "data": {
        "created_at": "2026-09-30T10:12:46Z",
        "updated_at": "2026-09-30T10:12:46Z",
        "reason": {
            "message": "OK"
        },
        "actual_amount": 615.75,
        "quantity": 4,
        "filled_quantity": 4,
        "price": 1.5092,
        "filled_price": 1.5092,
        "leverage": 5,
        "hedge_rate": 102,
        "order_type": "LONG",
        "trigger_type": "MARKET",
        "trade_currency": "INR",
        "status": "FILLED",
        "id": "01a0f1cd-6903-7611-bca4-530d61420b85",
        "client_order_id": null,
        "asset_uuid": "01903bcc-8452-78e1-b276-3e897dda2908",
        "symbol": "XRPUSDT",
        "future_position_uuid": "01a0f1cd-6900-76ee-9686-e6a11bfab4c4",
        "position_id": "01a0f1cd-6900-76ee-9686-e6a11bfab4c4"
    }
}

Response fields

FieldDescription
idOrder UUID.
client_order_idClient order id, or null if not set. See Client order ID.
position_idUUID of the position the order belongs to. Same value as future_position_uuid. See Order and position IDs.
future_position_uuidPosition UUID. Same value as position_id.
asset_uuidAsset UUID.
symbolTrading pair (e.g. XRPUSDT).
order_typeLONG, SHORT, STOPLOSS, or TAKEPROFIT.
trigger_typeMARKET or LIMIT.
statusOrder status (e.g. CREATED, FILLED, CANCELLED, SYSTEM_CANCELLED).
trade_currencyUSDT or INR.
quantity / filled_quantityOrdered and filled quantity (base asset).
price / filled_priceOrder price and average fill price (USDT).
actual_amountOrder value (quantity × price) in trade_currency. On partially filled orders with the remainder cancelled, see the known issue below.
leverageLeverage.
hedge_rateINR/USDT rate for the order (1 for USDT).
reasonPlacement result, e.g. {"message": "OK"}, or null.
created_at / updated_atISO-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)

Stop-loss and take-profit orders cancelled by the system when their position closes, is liquidated, or is reversed have status: SYSTEM_CANCELLED. They are returned here but not by Order history.

Errors

❕Common errors

Order not found

{
    "success": false,
    "errors": [
        {
            "code": 404,
            "text": "order not found"
        }
    ]
}

Status: 404 Not Found


Did this page help you?