Get available pairs

Method returns all enabled currency pairs. You can filter them by payin currency, payout currency, or transaction type using the request params.

HTTP request

post

/v2/#getPairs

Request

Header parameters

Requires authentification.

Body parameters

Requires JSON-RPC 2.0 protocol request body.

The params parameter schema:

Name	Type	Required	Description
from	string	false	Payin currency ticker (in lowercase).
to	string	false	Payout currency ticker (in lowercase).
txType	string	false	Type of transaction. If not specified, the method returns all available pairs regardless of type. Enum: float/fixed

Sample request payload

application/json

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "getPairs",
  "params":
    {
      "from": "eth",
      "txType": "fixed"
    }
}  

Sample cURL

curl --location --request POST 'https://api.changelly.com/v2' \
--header 'X-Api-Key: {{apiKey}}' \
--header 'X-Api-Signature: {{sign}}' \
--data-raw '{
    "id": "test",
    "jsonrpc": "2.0",
    "method": "getPairs",
    "params":
      {
        "from": "eth",
        "txType": "fixed"
      }
}'

Response

Response parameters

Requires JSON-RPC 2.0 protocol response body.

The result parameter schema:

Name	Type	Description
from	string	Payin currency ticker.
to	string	Payout currency ticker.

Sample response

application/json

{
  "jsonrpc": "2.0",
  "id": "test",
  "result": [
    {
      "from": "eth",
      "to": "btc"
    },
    {
      "from": "eth",
      "to": "usdt"
    },
    {
      "from": "eth",
      "to": "xmr"
    }
  ]
}

Error response

Error response parameters

Check the error response schema.

Error codes

Code	Message	Description
-32600	Error: You reached requests limit {limit} rps	You have been sending more than 10 requests per second.
-32602	Invalid currency: {currency} not found	This currency is not listed on Changelly or the ticker is invalid.
-32602	Parameter {param} is invalid	You've specified an invalid parameter.
-32603	Internal Error or Error	Most likely, the problem is on our side. Further investigation is required.