Get Balance

Returns your current account balance across all currencies, including amounts locked in pending orders or withdrawals.

GET/api/v1/balanceRequires authentication
Amounts in SUN
All balance values are returned as numbers in SUN. 1 TRX = 1,000,000 SUN. Divide by 1,000,000 to convert to TRX.

Request

No query parameters or request body. Requires a valid JWT or API key in the X-API-Key header.

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

Response

Returns an object with three numeric fields representing your available and locked balances.

200Success
{
  "trx": 150000000,
  "usdt": 42000000,
  "trx_locked": 5000000
}

Response fields

trxnumberAvailable TRX balance in SUN
usdtnumberAvailable USDT balance in SUN-equivalent units
trx_lockednumberTRX currently locked in pending operations, in SUN
401Unauthorized
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing authentication credentials"
  }
}