Create new order

Place a new market or limit order. Pass the asset as a query parameter (?id= or ?symbol=). Leverage comes from the leverage already set for that asset (not sent in the body).

order_price, stoploss_price, and takeprofit_price are USDT price levels; quantity is in the base asset. Add "trade_currency": "INR" to draw margin from the INR futures wallet; omit it (or use "USDT") for USDT.

Request

# USDT — MARKET with stop loss
curl -X POST "https://trade.mudrex.com/fapi/v2/futures/order?symbol=BTCUSDT" \
  -H "Content-Type: application/json" \
  -H "X-Authentication: your-secret-key" \
  -d '{
    "trigger_type": "MARKET",
    "order_type": "LONG",
    "quantity": "0.001",
    "trade_currency": "USDT",
    "is_stoploss": true,
    "stoploss_price": "950",
    "client_order_id": "my-order-123"
  }'

# INR — LIMIT
curl -X POST "https://trade.mudrex.com/fapi/v2/futures/order?symbol=BTCUSDT" \
  -H "Content-Type: application/json" \
  -H "X-Authentication: your-secret-key" \
  -d '{
    "trigger_type": "LIMIT",
    "order_type": "SHORT",
    "quantity": "0.01",
    "order_price": "105",
    "trade_currency": "INR"
  }'

# By asset UUID instead of symbol
curl -X POST "https://trade.mudrex.com/fapi/v2/futures/order?id={asset_id}" \
  -H "Content-Type: application/json" \
  -H "X-Authentication: your-secret-key" \
  -d '{
    "trigger_type": "MARKET",
    "order_type": "LONG",
    "quantity": "0.001"
  }'

Parameters

Response

Status: 202 Accepted

{
    "success": true,
    "data": {
        "leverage": "5",
        "quantity": "30",
        "price": "0.19887",
        "order_id": "01a0c317-61e9-7388-a2f9-474780998ebb",
        "status": "CREATED",
        "message": "OK",
        "client_order_id": "my-order-123",
        "position_id": "01a0c317-61e7-73ec-93c5-a98a7b82bbb7"
    }
}

Response fields

Errors

{
    "success": false,
    "errors": [
        { "code": 400, "text": "leverage not found" }
    ]
}

Notes

• Position id: Placing an order creates its position immediately, with status INITIATED, and returns the position_id without waiting for a fill. The position_id does not change. The position is listed in Open Positions once it is OPEN.
• Client order id: Optional body field client_order_id. See Client order ID for lookup and cancel by client id.
• Leverage: Not accepted in the request body. Set it once per asset with POST /futures/{asset_id}/leverage (include trade_currency for INR) before placing an order, or the call returns 400 leverage not found.
• Order amount: Always computed as quantity × price. actual_amount and desired_amount are not accepted.
• Order Price: Must be between the asset's min & max price for LONG/SHORT orders (USDT).
• LIMIT orders / minimum notional: A LIMIT order must meet the asset's min_notional_value (USDT) evaluated at the limit price. Orders below the minimum notional are rejected.
• Reduce-Only Orders: If reduce_only is true and a position is open, the order type must be opposite the existing position. Stop loss and take profit fields are ignored.
• Stop Loss/Take Profit: If is_takeprofit or is_stoploss is true, you must define the corresponding price. The stop loss price is not validated against the liquidation price — check it yourself.
• Available balance: Unsettled PnL is not counted towards available balance, so a margin check can fail here where it would have passed on POST /fapi/v1/futures/{asset_id}/order.
• Concurrent actions: 423 means another order or liquidation holds the lock for the same user and asset. Retry after a short delay rather than resubmitting immediately.
• Rejected requests: a request rejected with 4xx creates no order. A lookup by its client_order_id returns 404.
• Settlement: 202 Accepted means the order was created and handed to the exchange. Fills and settlement are applied asynchronously — poll the order to follow its progress.

Place order (v1)

POST /fapi/v1/futures/{asset_id}/order is supported. Prefer the v2 path (?symbol= or ?id=) for lower latency. The v1 response has the same fields as v2, plus amount (order value, USDT).

Status: 202 Accepted

{
    "success": true,
    "data": {
        "leverage": "5",
        "amount": "6.038",
        "quantity": "4",
        "price": "1.5095",
        "order_id": "01a0f1ca-8e86-7b1d-8616-ce6f8a10eb8e",
        "status": "CREATED",
        "message": "OK",
        "client_order_id": null,
        "position_id": "01a0f1ca-8e83-7c9f-b3e6-d51b34cba2e3"
    }
}