Validate address

Use validateAddress to check if a given wallet address is valid or not for a given currency.

For some currencies, in addition to address, you can validate extraId.

extraId is never required for validating address. However, if you want to, you can validate extraId for the following currencies:

• EOS
• IOST
• STEEM
• STX
• XLM
• XRP

HTTP request

post

/v2/#validateAddress

Request

Header parameters

Requires authentification.

Body parameters

Requires JSON-RPC 2.0 protocol request body.

The params parameter schema:

Name	Type	Required	Description
currency	string	true	Currency ticker (in lowercase).
address	string	true	Wallet address.
extraId	string	false	Extra ID.

Sample request payload

application/json

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "validateAddress",
  "params": {
    "currency": "eos",
    "address": "<<eos address>>",
    "extraId": "<<eos extraId>>"
  }
}

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": "validateAddress",
  "params": {
     "currency": "eos",
     "address": "<<eos address>>",
     "extraId": "<<eos extraId>>"
  }
}'

Response

Response parameters

Requires JSON-RPC 2.0 protocol response body.

The result parameter schema:

Name	Type	Description
result	boolean	Is true if the given address is valid.
message	string	Error message which is returned only if the given address is invalid.

Sample response

application/json

{
  "jsonrpc": "2.0",
  "id": "test",
  "result": {
    "result": false,
    "message": "Invalid address"
  }
}

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	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.