Skip to main content
Version: v2

Currencies

Get information about cryptocurrencies and fiat currencies supported by Nexchange, including minimum trading amounts and withdrawal fees.

List Currencies

Retrieve the complete list of supported currencies and their properties.

Request

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

Parameters: None required

Response

Returns an array of currency objects with detailed information about each supported currency in v2 simplified format.

Response Fields:

FieldTypeDescription
codestringCurrency code (ISO standard for fiat, ticker symbol for crypto)
namestringCurrency name or description
min_confirmationsinteger/nullMinimum confirmations required for this currency (null for fiat)
is_fiatbooleanWhether this is a fiat currency (false for crypto)
contract_addressstring/nullSmart contract address for tokens (null for native currencies)
withdrawal_feestringFee charged for withdrawals in this currency
extra_idstring/nullType of extra ID required (memo, destination_tag, etc.)
networkstring/nullNetwork name for this currency
decimalsintegerNumber of decimal places for this currency

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
},
{
"code": "ETH",
"name": "ethereum",
"min_confirmations": 12,
"is_fiat": false,
"contract_address": null,
"withdrawal_fee": "0.00500000",
"extra_id": null,
"network": null,
"decimals": 18
},
{
"code": "USD",
"name": "USD",
"min_confirmations": null,
"is_fiat": true,
"contract_address": null,
"withdrawal_fee": "0.00000000",
"extra_id": null,
"network": null,
"decimals": 8
}
]

Get Currency Details

Retrieve detailed information about a specific currency.

Request

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

Path Parameters:

ParameterTypeRequiredDescription
codestringYesCurrency code (e.g., BTC, ETH, USD)

Response

Returns detailed information about the specified currency.

Bitcoin Currency Example:

{
"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"
}

Token Currency Example (UNI):

{
"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"
}

Currency Properties

Network Information

  • network: Blockchain network for tokens (e.g., "ETH" for ERC-20 tokens)
  • contract_address: Smart contract address for tokens (null for native currencies)
  • extra_id: Special requirements like memo fields or destination tags

Decimal Precision

  • decimals: Number of decimal places supported by the currency
  • Used for proper amount formatting and validation

Confirmation Requirements

  • min_confirmations: Required blockchain confirmations before deposits are credited
  • null for fiat currencies (no blockchain confirmations needed)

Error Responses

404 Not Found

Returned when the specified currency code doesn't exist.

Example:

{
"detail": "Not found"
}

Next Steps

  • Trading Pairs - Learn about available trading pair combinations
  • Rates - Get real-time pricing information
  • Orders - Create and manage trading orders