Retrieve currency

Retrieves detailed information about a specific currency by ISO 4217 code, including name, symbol, decimals, country, and applicable fees.

This endpoint retrieves detailed information about a specific currency based on its ISO 4217 currency code. The response includes the currency's name, symbol, number of decimal places, country of origin, supported countries for operation, and supported currencies for exchange. Additionally, the response provides any associated fees for operating or exchanging the currency. Note: Fees from payment providers and FX providers are not included and will be calculated separately during payment processing.

GET/currencies/{currency}

Authorization

x-api-keyBearer

Path parameters

currencystring

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.

Query parameters

Response

200400404500

The response body returns the details of a single currency entity. This includes the currency's name, symbol, ISO code, number of decimal places, the country of origin, supported countries, supported currencies for exchange, and any associated fees. The response provides complete information about the currency, useful for displaying currency details or using them in transactional contexts.

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/{currency}', {
    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"
      ]
    }
  ]
}