Currencies

Retrieve the list of supported fiat currencies available for merchant invoices, together with the current exchange rate used by the payment system.

Get currencies

GET /api/v1/currencies

Returns the list of enabled currencies available for the authenticated merchant.

Each item contains the current buy rate from USDT → fiat, rounded down to 2 decimal places.

Authentication

Send your API key in the X-Api-Key header.

X-Api-Key: your_api_key_here

Query parameters

This endpoint does not accept query parameters.

Example request

curl -X GET https://api.ecca-ex.com/api/v1/currencies \
  -H "X-Api-Key: your_api_key_here"

Example response

{
  "successful": true,
  "data": [
    {
      "currency": "UAH",
      "decimal": 2,
      "symbol": "₴",
      "name": "Ukrainian Hryvnia",
      "rate": "41.32"
    },
    {
      "currency": "KZT",
      "decimal": 2,
      "symbol": "₸",
      "name": "Kazakhstani Tenge",
      "rate": "489.50"
    }
  ]
}

Response fields

Top-level response

Field	Type	Description
`successful`	boolean	Indicates whether the request succeeded
`data`	array	List of available currencies

Currency item fields

Field	Type	Description
`currency`	string	Currency code in uppercase, for example `UAH`
`decimal`	integer	Number of decimal places used for the currency
`symbol`	string	Currency symbol
`name`	string	Human-readable currency name
`rate`	string	Current buy rate from `USDT` to this fiat currency, rounded down to 2 decimals

Notes

The rate direction is USDT -> fiat.

Currency errors

HTTP	Code	Description
`503`	`RATES_UNAVAILABLE`	Exchange rates are temporarily unavailable
`503`	`RATES_INVALID`	Exchange rates cache is invalid
`422`	`RATE_INVALID`	A currency rate exists but is invalid
`404`	`RATE_NOT_FOUND`	No valid currency rates were found

Example error

{
  "successful": false,
  "request_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "error": {
    "code": "RATES_UNAVAILABLE",
    "message": "Exchange rates are temporarily unavailable",
    "details": {}
  }
}

Was this page helpful?

Last updated today

Built with Documentation.AI