Skip to main content
Version: v1
Legacy — API v1

This documents the legacy v1 API. New integrations should use API v2.

Currencies

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

Fetch Currencies

Retrieve the complete list of supported currencies and their properties.

Request

GET /currency/

Parameters: None required

Response

Returns an array of currency objects with detailed information about each supported cryptocurrency.

Response Fields:

FieldTypeDescription
codestringCurrency ticker symbol (e.g., "BTC", "ETH")
namestringFull currency name (e.g., "bitcoin", "ethereum")
min_confirmationsinteger/nullMinimum confirmations required for deposits
is_cryptobooleanWhether this is a cryptocurrency
minimal_amountstringMinimum tradeable amount for this currency (deprecated)
maximal_amountstringMaximum tradeable amount for this currency (deprecated)
contract_addressstring/nullContract address for tokens (if applicable)
is_base_of_enabled_pairbooleanCan be used as base currency in trading pairs
is_quote_of_enabled_pairbooleanCan be used as quote currency in trading pairs
has_enabled_pairsbooleanHas active trading pairs available
is_base_of_enabled_pair_for_testbooleanBase pair availability for testing
is_quote_of_enabled_pair_for_testbooleanQuote pair availability for testing
has_enabled_pairs_for_testbooleanTest pair availability
withdrawal_feestringFixed withdrawal fee for this currency
extra_idstring/nullAdditional identifier for the currency (if applicable)
networkobject/nullNetwork information with name property
decimalsintegerNumber of decimal places the currency supports

Example Response:

[
{
"code": "BTC",
"name": "bitcoin",
"min_confirmations": 1,
"is_crypto": true,
"minimal_amount": "0.01000000",
"is_base_of_enabled_pair": true,
"is_quote_of_enabled_pair": true,
"has_enabled_pairs": true,
"withdrawal_fee": "0.00250000"
},
{
"code": "LTC",
"name": "litecoin",
"min_confirmations": 6,
"is_crypto": true,
"minimal_amount": "0.50000000",
"is_base_of_enabled_pair": true,
"is_quote_of_enabled_pair": true,
"has_enabled_pairs": true,
"withdrawal_fee": "0.00010000"
}
]

Currency Properties

Network Information

  • network: Object containing network information with name property (e.g., "BTC", "ETH")
  • 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)

Trading Availability

  • has_enabled_pairs: Currency has active trading pairs
  • is_base_of_enabled_pair: Can be received (target currency)
  • is_quote_of_enabled_pair: Can be sent (source currency)

Error Responses

404 Not Found

Returned when the endpoint is not available.

Example:

{
"detail": "Not found"
}

Next Steps