Get currency list
GET /v1/currencies
List of supported crypto and fiat currencies.
HTTP request
https://fiat-api.changelly.com/v1/currencies
Request
- Request
- cURL
Header parameters
Name | Type | Required | Description |
---|---|---|---|
X-Api-Key | string | true | Your public API key. |
X-Api-Signature | string | true | The query's serialized body signed by your private key according to the RSA-SHA256 method. |
Query parameters
Name | Type | Required | Description |
---|---|---|---|
type | string | false | Enum: crypto /fiat .If the currency type is not specified, the endpoint will return both fiat currencies and cryptocurrencies. |
providerCode | string | false | The 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. |
supportedFlow | string | false | Enum: buy /sell . If the flow is not specified, the endpoint will return result for both cases (On-Ramp buy and Off-Ramp sell ). |
curl --location --request GET
'https://fiat-api.changelly.com/v1/currencies?providerCode=moonpay&type=crypto'
--header 'X-Api-Key: {{apiKey}}'
--header 'X-Api-Signature: {{signature}}'
Response
Sample response
application/json
[
{
"ticker": "ETH",
"name": "Ethereum",
"type": "crypto",
"extraIdName": null,
"iconUrl": "<icon URL>",
"precision": "8"
}
]
Response params
Name | Type | Required | Description |
---|---|---|---|
ticker | string | true | Currency ticker in uppercase. It is a unique identifier of the currency. |
name | string | true | Currency name that you can specify in your interface. |
type | string | true | Enum: crypto /fiat .Currency type. |
extraIdName | string | true | Extra ID name of the cryptocurrency, for example, "Memo". Extra ID is required for the following currencies:
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. |
iconUrl | string | true | URL of currency icon. |
precision | string | true | Currency precision. For fiat currencies, it is always 2. |
Error schema
Name | Type | Required | Description |
---|---|---|---|
errorType | string | true | Error type. |
errorMessage | string | true | Error message. |
errorDetails | array of objects | true | If the error contains no details, errorDetails equals null. |
Possible error types:
Type | Description |
---|---|
validation | Validation error. |
errorDetails
item schema
Name | Type | Required | Description |
---|---|---|---|
cause | string | true | Error cause. For example, it can equal the missing request parameter for the validation error type. |
value | string | true | Error value. |
Error codes
Code | Message |
---|---|
400 | BadRequest |
401 | Unauthorized |
429 | TooManyRequests |
500 | InternalServerError |
- 400
- 401
- 429
- 500
BadRequest
{
"errorType": "validation",
"errorMessage": "Validation error",
"errorDetails": [
{
"cause": "type",
"value": "Incorrect type"
}
]
}
Unauthorized
{
"errorType": "unauthorized",
"errorMessage": "Unauthorized",
"errorDetails": null
}
TooManyRequests
{
"errorType": "tooManyRequests",
"errorMessage": "Too many requests",
"errorDetails": null
}
InternalServerError
{
"errorType": "internalServerError",
"errorMessage": "Internal Server Error",
"errorDetails": null
}