Retrieve available currencies

Retrieves a list of available currencies for transactions or exchanges, including details like name, symbol, ISO code, country, and applicable fees.

This endpoint retrieves a list of all available currencies that can be used for transactions or exchanges. Each currency in the response includes its name, symbol, ISO code, decimal places, country of origin, supported countries for operation, and supported currencies for exchange. The response also includes any applicable fees for operating or exchanging currencies, but does not include fees charged by payment providers or FX providers—those fees will be included separately when initiating a payment.

GET/currencies

Authorization

x-api-keyBearer

Response

200400404500

The response body returns an array of currency entities, each containing the details of the individual currencies, including their name, symbol, ISO code, decimal places, country of origin, supported countries, supported currencies for exchange, and any associated fees. This response is useful when retrieving a complete list of currencies for operations like currency selection or displaying exchange option

Body

application/json

namestring

The full name of the currency (e.g., US Dollar, Euro).

currencycurrencySymbol

Currency code supported by the payment method. For cryptocurrencies, include both the token and network (e.g., USDC_SOLANA). For fiat currencies, use the standard ISO 4217 currency codes.

ARSBRLCLPCOPCRCCUPDOPEURGBPGTQJMDMXNPABPENPYGUSDUYUUSDC_SOLANAUSDC_ER20USDC_MATIC

symbolstring

The symbol used to represent the currency (e.g., $, €, ¥).

decimalsinteger

The number of decimal places used for this currency (e.g., 2 for US Dollar).

countrycountry

The 3-character ISO 3166 country code indicating the country of address.

ARGBOLBRACHLCOLCRICUBDOMECUSLVGTMGUYHNDHTIJAMMEXNICPANPRYPERSURTTOURYVENGBRALBANDAUTBELBIHBGRHRVCYPCZEDNKESTFINFRADEUGRCHUNISLIRLITALVALIELTULUXMLTMDAMCOMNENLDMKDNORPOLPRTROURUSSMRSRBSVKSVNESPSWECHEUKR

supportedCountriesarray of country

A list of countries where this currency can be legally operated. If operating in local currency, this will include the country where the currency originates.

supportedCurrenciesarray of all of

A list of currencies that can be operated or exchanged with this currency. When performing transactions in the same currency, the supported currencies will be the same as the base currency.

Request

JavaScriptCurlPython

const response = await fetch('/currencies', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "name": "text",
    "currency": "ARS",
    "symbol": "text",
    "decimals": 0,
    "country": "ARG",
    "supportedCountries": [
      "ARG"
    ],
    "supportedCurrencies": [
      {
        "name": "text",
        "currency": "ARS",
        "symbol": "text",
        "decimals": 0,
        "country": "ARG",
        "supportedCountries": [
          "ARG"
        ]
      }
    ]
  }
]