Get limits

Get limits for floating and fixed rate transactions

warning

The method is deprecated. To get the limits, you need to use getFixRateForAmount/getExchangeAmount, but the transaction amount must be within limits.

A full-fledged replacement of this method is also coming soon. getPairsParams still will be available for some time.

HTTP request

post

/v2/#getPairsParams

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	true	Payin currency code (in lowercase).
to	string	true	Payout currency code (in lowercase).

Sample request payload

application/json
{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "getPairsParams",
  "params": [
    {
      "from": "eth",
      "to": "btc"
    },
    {
      "from": "btc",
      "to": "eth"
    }
  ]
}  

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": "getPairsParams",
    "params": [
      {
        "from": "eth",
        "to": "btc"
      },
      {
        "from": "btc",
        "to": "eth"
      }
    ]
}'

Response

Response parameters

Requires JSON-RPC 2.0 protocol response body.

The result parameter schema:

Name	Type	Description
from	string	Payin currency code.
to	string	Payout currency code.
minAmountFloat	string	Minimum exchangeable amount for float rate transactions.
maxAmountFloat	string	Maximum exchangeable amount for float rate transactions.
minAmountFixed	string	Minimum exchangeable amount for fixed rate transactions.
maxAmountFixed	string	Maximum exchangeable amount for fixed rate transactions.

Sample response

application/json
{
  "jsonrpc": "2.0",
  "id": "test",
  "result": [
    {
      "from": "eth",
      "to": "btc",
      "minAmountFloat": "0.0465",
      "maxAmountFloat": "449172.45240999997",
      "minAmountFixed": "0.0775",
      "maxAmountFixed": "100"
    },
    {
      "from": "btc",
      "to": "eth",
      "minAmountFloat": "0.0015",
      "maxAmountFloat": "25629.527850432485",
      "minAmountFixed": "0.0025",
      "maxAmountFixed": "3.2138"
    }
  ]
}

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} temporary disabled`	This currency is currently disabled.
`-32602`	`Invalid currency: {currency} is temporary disabled on API as output currency`	This currency is currently disabled on API as an output currency.
`-32602`	`Invalid currency: {currency} is temporary disabled on API as input currency`	This currency is currently disabled on API as an input currency.
`-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.

Get limits

HTTP request​

Request​

Header parameters​

Body parameters​

Response​

Response parameters​

Error response​

Error response parameters​

Error codes​