API Reference

Base URL: https://merx.exchange/api/v1 — All requests and responses use JSON. Authenticated endpoints require an X-API-Key header or Bearer JWT.

Authentication

Pass your API key via the X-API-Key header. Alternatively, use a Bearer JWT obtained from the login flow. All endpoints marked "auth" will return 401 without a valid credential.

Endpoints

Endpoint details

GET /prices

Returns current prices from all connected providers. No authentication required.

curl https://merx.exchange/api/v1/prices

POST /orders

Create a new energy or bandwidth order. Supports Idempotency-Key header to prevent duplicate orders on retry.

{
  "resource_type": "ENERGY",
  "amount": 65000,
  "duration_sec": 86400,
  "target_address": "TYourTargetAddressHere",
  "max_price_sun": 90
}

POST /withdraw

Initiate a TRX withdrawal to an external TRON address. Supports Idempotency-Key.

{
  "amount_sun": "10000000",
  "to_address": "TYourExternalAddressHere"
}

GET /deposit

Returns the deposit address and memo for funding your Merx account.

curl https://merx.exchange/api/v1/deposit \
  -H "X-API-Key: sk_live_your_key_here"

Error format

All errors follow a consistent structure. The HTTP status code matches the error type. The response body always contains an error object with code, message, and optional details.

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Not enough TRX to cover this order",
    "details": {
      "required_sun": "5460000",
      "available_sun": "2000000"
    }
  }
}

Common error codes

Rate limits

Rate limits are enforced per API key. When exceeded, the API returns 429 with a Retry-After header indicating seconds until the next window.