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
| Field | Type | Description |
|---|---|---|
code | string | Internal currency code (ISO code for fiat, ticker + network suffix for multi-network tokens) |
name | string | Currency name |
is_fiat | boolean | true for fiat currencies |
min_confirmations | integer/null | Confirmations required to credit a deposit (null for fiat) |
contract_address | string/null | Token contract address (null for native currencies) |
network | string/null | Network this currency lives on (null for fiat and some natives) |
withdrawal_fee | string | Withdrawal fee in this currency |
extra_id | string/null | Type of extra ID the currency requires (memo, destination_tag, …) or null |
decimals | integer | Decimal places |
common_symbol | string/null | Widely 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:
| Parameter | Type | Required | Description |
|---|---|---|---|
code | string | Yes | Currency 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
| Status | Meaning | Body |
|---|---|---|
401 | Missing/invalid API key | {"detail": "Authentication credentials were not provided."} |
404 | Unknown currency code | {"detail": "Not found"} |