Skip to main content

Get currency list

GET /v1/currencies

List of supported crypto and fiat currencies.

HTTP request

https://fiat-api.changelly.com/v1/currencies

Request

Header parameters

NameTypeRequiredDescription
X-Api-KeystringtrueYour public API key.
X-Api-SignaturestringtrueThe query's serialized body signed by your private key according to the RSA-SHA256 method.

Query parameters

NameTypeRequiredDescription
typestringfalseEnum: crypto/fiat.
If the currency type is not specified, the endpoint will return both fiat currencies and cryptocurrencies.
providerCodestringfalseThe On-Ramp or Off-Ramp provider code. Possible values.
If the provider code is not specified, the endpoint will return the supported currencies of all providers.
supportedFlowstringfalseEnum: buy/sell.
If the flow is not specified, the endpoint will return result for both cases (On-Ramp buy and Off-Ramp sell).

Response

Sample response

application/json
[
{
"ticker": "ETH",
"name": "Ethereum",
"type": "crypto",
"extraIdName": null,
"iconUrl": "<icon URL>",
"precision": "8"
}
]

Response params

NameTypeRequiredDescription
tickerstringtrueCurrency ticker in uppercase. It is a unique identifier of the currency.
namestringtrueCurrency name that you can specify in your interface.
typestringtrueEnum: crypto/fiat.
Currency type.
extraIdNamestringtrueExtra ID name of the cryptocurrency, for example, "Memo".
Extra ID is required for the following currencies:
  • XRP
  • XLM
  • EOS
  • BNB
For fiat currencies and cryptocurrencies without an extra ID, extraIdName equals null.
ℹ️ If the currency has extra ID, you need to provide walletExtraId parameter in the request to /v1/orders and /v1/validate-address endpoints.
iconUrlstringtrueURL of currency icon.
precisionstringtrueCurrency precision. For fiat currencies, it is always 2.

Error schema

NameTypeRequiredDescription
errorTypestringtrueError type.
errorMessagestringtrueError message.
errorDetailsarray of objectstrueIf the error contains no details, errorDetails equals null.

Possible error types:

TypeDescription
validationValidation error.

errorDetails item schema

NameTypeRequiredDescription
causestringtrueError cause. For example, it can equal the missing request parameter for the validation error type.
valuestringtrueError value.

Error codes

CodeMessage
400BadRequest
401Unauthorized
429TooManyRequests
500InternalServerError
BadRequest
{
"errorType": "validation",
"errorMessage": "Validation error",
"errorDetails": [
{
"cause": "type",
"value": "Incorrect type"
}
]
}