Guides
Guides

Order by id

Retrieve detailed information about a particular order.

The order is identified by its UUID, which already implies its currency; the response carries a trade_currency tag, and for INR orders the hedge_rate.

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": {
        "actual_amount": 481.11,
        "quantity": 43.8,
        "filled_quantity": 43.8,
        "price": 0.11442,
        "filled_price": 0.11442,
        "leverage": 5,
        "hedge_rate": 96,
        "order_type": "LONG",
        "trigger_type": "MARKET",
        "trade_currency": "INR",
        "status": "FILLED",
        "id": "019ecc52-2f97-7e34-b3cc-22364e107975"
    }
}

Response fields

FieldDescription
idOrder ID (UUID).
actual_amountActual amount used for the order, in the order's currency.
quantityOrder quantity (base asset).
filled_quantityQuantity that has been filled.
priceOrder price (USDT).
filled_priceAverage price at which the order has been filled (USDT).
leverageLeverage used for the order.
hedge_rateINR/USDT conversion rate captured for this order (INR orders).
order_typeType of order: LONG, SHORT, or TAKEPROFIT.
trigger_typeTrigger type: MARKET or LIMIT.
trade_currencyCurrency of the order: USDT or INR.
statusOrder status (e.g. CREATED, FILLED).

Errors

Common errors

Order not found

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

Status: 404 Not Found