Get currency list

List of supported crypto and fiat currencies.

HTTP request

get

/v1/currencies

Request

Header parameters

Requires authentification.

Query parameters

Name	Type	Required	Description
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).
type	string	false	Enum: crypto/fiat. If the currency type is not specified, the endpoint will return both fiat currencies and cryptocurrencies.

Sample cURL

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

Response params

Name	Type	Required	Description
extraIdName	string	true	Extra 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. Info 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.
iconColoredUrl	string	true	URL of colored currency icon.
name	string	true	Currency name that you can specify in your interface.
network	string	true	Currency network
type	string	true	Enum: crypto/fiat. Currency type.
precision	string	true	Currency precision. For fiat currencies, it is always 2.
protocol	string	true	Currency protocol. The value can be an empty string. Warning The result scheme parameter protocol is deprecated. The response will stop returning it soon.
providers	array of objects	true	List of providers that support the currency.
ticker	string	true	Currency ticker in uppercase. It is a unique identifier of the currency.

provider object schema

Name	Type	Required	Description
limits	object	true	The currency limits for buying and selling.
providerCode	string	true	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	array of strings	true	Enum: buy/sell. If the flow is not specified, the endpoint will return result for both cases (On-Ramp buy and Off-Ramp sell).

limits object schema

Name	Type	Required	Description
get	object	false	The currency limits for buying.
send	object	false	The currency limits for selling.

send and get object schema

Name	Type	Required	Description
max	number	false	The max limit for the operation.
min	number	false	The min limit for the operation.

Sample response

application/json

{
  "type": "crypto",
  "ticker": "ETH",
  "name": "Ethereum",
  "extraIdName": null,
  "iconUrl": "https://cdn.changelly.com/icons/eth.svg",
  "iconColoredUrl": "https://cdn.changelly.com/icons-colored/eth.png",
  "precision": "8",
  "network": "ethereum",
  "protocol": "",
  "providers": [
    {
      "providerCode": "moonpay",
      "supportedFlows": [
        "buy",
        "sell"
      ],
      "limits": {
        "send": {
          "min": 0.00441,
          "max": 8.5
        },
        "get": {
          "min": 0.0011,
          "max": 30000
        }
      }
    }
  ]
}

Error response

Error response parameters

Check the error response schema.

Possible error types in the errorType item:

Type	Description
validation	Validation error.

The 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	Bad request
401	Unauthorized
404	Not found
429	Too many requests
500	Internal server error

400

Bad Request

{
  "errorType": "validation",
  "errorMessage": "Validation error",
  "errorDetails": [
    {
      "cause": "type",
      "value": "type must be one of the following values: crypto, fiat"
    }
  ]
}

401

Unauthorized

{
  "errorType": "unauthorized",
  "errorMessage": "Unauthorized",
  "errorDetails": null
}

404

Not Found

{
  "errorType": "notFound",
  "errorMessage": "Not found",
  "errorDetails": null
}

429

Too Many Requests

{
  "errorType": "tooManyRequests",
  "errorMessage": "Too many requests",
  "errorDetails": null
}

500

Internal Server Error

{
  "errorType": "internalServerError",
  "errorMessage": "Internal Server Error",
  "errorDetails": null
}