Guides
Guides

Authentication & Rate Limits

Learn how to authenticate with Mudrex API using API keys and understand the rate limits enforced for secure trading operations.

Authentication

Mudrex enforces strong security measures. To call any private endpoint, you must:

Verify your identity: Complete KYC verification (PAN & Aadhaar) and enable two-factor authentication for your Mudrex account.

Generate an API key: In your dashboard, create an API key. Copy the secret and store it securely, as it will not be displayed again.

All endpoints under /fapi/v1 require the following headers:

HeaderValueRequired
X-Authenticationyour_api_secretYes
Content-Typeapplication/jsonOnly for POST/PATCH/DELETE requests

Example Request

curl -X POST https://trade.mudrex.com/fapi/v1/futures/<asset_id>/order \
  -H "Content-Type: application/json" \
  -H "X-Authentication: <secret-key>" \
  -d '{
    "leverage": "5",
    "quantity": "0.001",
    "order_price": "107526",
    "order_type": "LONG",
    "trigger_type": "MARKET",
    "is_takeprofit": true,
    "is_stoploss": true,
    "stoploss_price": "106900",
    "takeprofit_price": "110000",
    "reduce_only": false
    }'

Rate Limits

The following rate limits are enforced per API key.

Enhanced Rate Limits (Selected Endpoints)

The following endpoints use higher rate limits to support high-frequency trading operations:

  • Create New Order
  • Cancel Order
  • Add / Reduce Margin
  • Set SL/TP
  • Edit SL/TP
  • Reverse Position
  • Partial Close
  • Square Off
  • Leverage by Asset ID / Symbol
  • Set leverage by Asset ID/ Symbol

Limits

DurationLimit
Second5
Minute125
Hour2500
Day25000

Standard Rate Limits (All Other Endpoints)

All endpoints not listed above will continue to use standard rate limits.

Limits

DurationLimit
Second2
Minute50
Hour1000
Day10000

Notes

  • Rate limits are applied per API key
  • Exceeding limits may result in request throttling or temporary blocking
  • Enhanced limits are designed for high-frequency trading endpoints only

What’s Next