Guides
Guides

Orders

Endpoints to query open and closed orders, retrieve details of a specific order, amend or cancel orders.

The Orders section covers the entire lifecycle of futures orders. Use these endpoints to place new market or limit orders, view your open orders, retrieve individual order details, view historical orders, amend orders, and cancel existing orders. You can also specify reduce‑only orders to ensure they only close or reduce positions. Refer to the sub‑pages for specifics on each operation.

Currency. To place an INR-margin order, add "trade_currency": "INR" to the order body; omit it (or pass USDT) for USDT. List endpoints (/futures/orders, /futures/orders/history) take trade_currency as a query parameter, default to USDT, return one currency per call, and tag each order with its trade_currency. For INR orders the FX rate is returned as hedge_rate. Order price remains in USDT; quantity is in the base asset.

Amend order — PATCH /futures/orders/{order_id}

Modify an open (unfilled) order by its UUID. The order's currency is inherited from its UUID; no trade_currency is needed.

Both order_price and quantity are required. A price-only amend returns 400 order quantity out of permissible range.

Request

curl -X PATCH "https://trade.mudrex.com/fapi/v1/futures/orders/{order_id}" \
  -H "Content-Type: application/json" \
  -H "X-Authentication: your-secret-key" \
  -d '{
    "order_price": "0.11380",
    "quantity": "44.0"
  }'

Parameters

ParameterTypeRequiredDescription
order_idstringYesThe order UUID (path parameter).
order_pricestringYesNew order price (USDT). Required together with quantity.
quantitystringYesNew quantity (base asset). Required together with price.

Response

Status: 200 OK

{
    "success": true,
    "data": {
        "message": "Order updated successfully"
    }
}

Response fields

FieldDescription
messageStatus message.