Validating addresses

POST /api/public/v1/addresses/validate

Validates a wallet address before you create a payout. The endpoint checks that the address format is correct for the specified network and screens it against sanctions and high-risk wallet lists. A 200 response means the address passed both checks and is safe to use in a Create Payout request.

This endpoint uses Content-Type: application/json, not application/vnd.api+json.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <api_key>

Request Body

Name	Type	Required	Description
address	string	Yes	Wallet address to validate.
network	string	Yes	Network code for the address. Use the same value you intend to pass as payNetwork in Create Payout. See Supported Currencies or Listing Payout Currency Pairs.

cURL

curl -X "POST" "https://api.sandbox.txn.io/api/public/v1/addresses/validate" \
     -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer <api_key>' \
     -d '{
  "address": "TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe",
  "network": "ttrx:usdt"
}'

Response

HTTP 200

{
  "data": {},
  "status": "ok",
  "jsonapi": {
    "version": "1.0"
  }
}

Address is valid and not flagged. Safe to use in a Create Payout request.

HTTP 422

{
  "errors": [
    {
      "status": 422,
      "title": "Invalid address",
      "code": "invalid_address",
      "detail": "",
      "source": {
        "pointer": "/data/attributes/address"
      }
    }
  ]
}

Address format is invalid for the specified network. This is also returned when the address belongs to a different network than the one specified (e.g. an Ethereum address submitted with a Tron network code).

HTTP 422

{
  "errors": [
    {
      "status": 422,
      "title": "We couldn't send funds to this address, please try another address",
      "code": "address_has_high_risk_score",
      "detail": "",
      "source": {
        "pointer": "/data/attributes/address"
      }
    }
  ]
}

Address failed risk screening. Do not proceed with a payout to this address.

HTTP 404

{
  "errors": [
    {
      "status": 404,
      "title": "Record not found",
      "code": "network_not_found",
      "detail": "Network not found"
    }
  ]
}

Network code not recognised. Check the value against Supported Currencies or Listing Payout Currency Pairs.