Skip to main content
Version: v2

Currencies

Enumerate supported currencies and their properties. Concepts — code suffixes, the three request formats, extra IDs — are explained in Currencies & Networks.

List Currencies

GET /currency/

Request

curl -X GET "https://api.n.exchange/en/api/v2/currency/" \
-H "Accept: application/json" \
-H "Authorization: ApiKey YOUR_API_KEY"

Authentication: API key required — see Authentication.

Parameters: none. The response is a plain array (no pagination).

Response

FieldTypeDescription
codestringInternal currency code (ISO code for fiat, ticker + network suffix for multi-network tokens)
namestringCurrency name
is_fiatbooleantrue for fiat currencies
min_confirmationsinteger/nullConfirmations required to credit a deposit (null for fiat)
contract_addressstring/nullToken contract address (null for native currencies)
networkstring/nullNetwork this currency lives on (null for fiat and some natives)
withdrawal_feestringWithdrawal fee in this currency
extra_idstring/nullType of extra ID the currency requires (memo, destination_tag, …) or null
decimalsintegerDecimal places
common_symbolstring/nullWidely used external ticker (e.g. Binance mapping); falls back to code when no mapping exists. Use for display

Example response:

[
{
"code": "BTC",
"name": "bitcoin",
"min_confirmations": 2,
"is_fiat": false,
"contract_address": null,
"withdrawal_fee": "0.00050000",
"extra_id": null,
"network": null,
"decimals": 8,
"common_symbol": "BTC"
},
{
"code": "USDTERC",
"name": "Tether (Ethereum)",
"min_confirmations": 12,
"is_fiat": false,
"contract_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"withdrawal_fee": "4.00000000",
"extra_id": null,
"network": "ETH",
"decimals": 6,
"common_symbol": "USDT"
},
{
"code": "USD",
"name": "USD",
"min_confirmations": null,
"is_fiat": true,
"contract_address": null,
"withdrawal_fee": "0.00000000",
"extra_id": null,
"network": null,
"decimals": 8,
"common_symbol": "USD"
}
]

Get Currency Details

GET /currency/{code}/

Path parameters:

ParameterTypeRequiredDescription
codestringYesCurrency code, pattern ^[A-Z0-9]+$ (e.g. BTC, USDTERC)
curl -X GET "https://api.n.exchange/en/api/v2/currency/UNI/" \
-H "Accept: application/json" \
-H "Authorization: ApiKey YOUR_API_KEY"
{
"code": "UNI",
"name": "Uniswap",
"min_confirmations": 12,
"is_fiat": false,
"contract_address": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",
"withdrawal_fee": "0.11199579",
"extra_id": null,
"network": "ETH",
"decimals": 18,
"common_symbol": "UNI"
}

Errors

StatusMeaningBody
401Missing/invalid API key{"detail": "Authentication credentials were not provided."}
404Unknown currency code{"detail": "Not found"}

Next steps