API Documentation

All API requests must include authentication headers. Generate your API credentials from the Developer Dashboard.

Required Headers

Header	Type	Required	Description
X-API-Key	string	Required	Your API Client ID (e.g., pcrf_60c2a1c7c799...)
X-API-Secret	string	Required	Your API Secret (shown once at creation)
X-Account-ID	string	Required	Your Account UUID
Content-Type	string	Required	Must be application/json

Example Request

curl -X GET https://api.mondax.co/api/v1/balance \
  -H "X-API-Key: pcrf_60c2a1c7c79926a54cedca8c" \
  -H "X-API-Secret: 5800096084579c142abc8ae95e32e56852c7f8eb..." \
  -H "X-Account-ID: 6f2112c3-4d2a-4309-b814-c2ee544136ee" \
  -H "Content-Type: application/json"

Error Response (401 Unauthorized)

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API credentials"
  }
}

Where to Find Your Credentials

API Key & Secret: account.mondax.co/developer → Create New Key

Account ID: Visible in your account URL or on the Account Settings page

Retrieve the deposit address for a specific cryptocurrency. Users send crypto to this address to initiate off-ramp transactions.

Query Parameters

Parameter	Type	Required	Description
currency	string	Required	Cryptocurrency code (e.g., USDT, BTC, ETH)
network	string	Required	Blockchain network (e.g., TRC20, ERC20, BEP20)

Response Example

{
  "success": true,
  "data": {
    "address": "TXyz123...abc789",
    "currency": "USDT",
    "network": "TRC20",
    "memo": null,
    "min_deposit": 10.00
  }
}

Convert deposited cryptocurrency to fiat currency at current exchange rates.

Request Body

Parameter	Type	Required	Description
from_currency	string	Required	Source cryptocurrency (e.g., USDT)
to_currency	string	Required	Target fiat currency (e.g., EUR, USD)
amount	number	Required	Amount of crypto to convert

Response Example

{
  "success": true,
  "data": {
    "tx_id": "conv_abc123xyz",
    "from_amount": 100.00,
    "to_amount": 92.50,
    "rate": 0.925,
    "fee": 1.50,
    "status": "completed"
  }
}

Initiate a fiat withdrawal to a linked bank account via SEPA or wire transfer.

Request Body

Parameter	Type	Required	Description
currency	string	Required	Fiat currency to withdraw (e.g., EUR)
amount	number	Required	Amount to withdraw
bank_account_id	string	Required	ID of linked bank account
reference	string	Optional	Payment reference (max 140 chars)

Response Example

{
  "success": true,
  "data": {
    "tx_id": "wd_xyz789abc",
    "amount": 500.00,
    "currency": "EUR",
    "fee": 0.50,
    "status": "pending",
    "estimated_arrival": "2025-12-15T14:00:00Z"
  }
}

Retrieve current exchange rates for crypto-to-fiat conversions.

Query Parameters

Parameter	Type	Required	Description
from	string	Optional	Source currency filter (e.g., USDT)
to	string	Optional	Target currency filter (e.g., EUR)

Response Example

{
  "success": true,
  "data": {
    "rates": [
      { "pair": "USDT/EUR", "rate": 0.925, "min": 10, "max": 50000 },
      { "pair": "BTC/EUR", "rate": 41250.00, "min": 0.0001, "max": 10 }
    ],
    "updated_at": "2025-12-14T08:00:00Z"
  }
}

Check the status of a conversion or withdrawal transaction.

Path Parameters

Parameter	Type	Required	Description
txId	string	Required	Transaction ID from convert or withdraw response

Response Example

{
  "success": true,
  "data": {
    "tx_id": "wd_xyz789abc",
    "type": "withdrawal",
    "status": "completed",
    "amount": 500.00,
    "currency": "EUR",
    "created_at": "2025-12-14T08:00:00Z",
    "completed_at": "2025-12-14T10:30:00Z"
  }
}