Skip to main content
POST
/
v1
/
funds
/
withdrawals
/
addresses
/
validate
curl
curl -X POST "https://api.services.payward.com/v1/funds/withdrawals/addresses/validate" \
  -H "API-Key: $PWS_API_KEY" \
  -H "API-Nonce: $PWS_API_NONCE" \
  -H "API-Sign: $PWS_API_SIGN" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -d '{
    "asset_symbol": "BTC",
    "asset_type": "crypto",
    "method_id": "550e8400-e29b-41d4-a716-446655440000",
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0b8c1"
  }'
{
  "data": {
    "valid": true
  }
}

Authorizations

​
API-Key
string
header
required

Your public API key. Identifies the partner making the request.

​
API-Nonce
string
header
required

Monotonically increasing nonce included in the request signature.

​
API-Sign
string
header
required

HMAC signature over the request, computed with your private key.

Headers

​
Idempotency-Key
string<uuid>

Client-generated UUIDv4 for safe retries. Sent as the Idempotency-Key HTTP header. Replayed responses include the Idempotent-Replayed: true header.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json
​
asset_symbol
string
required

Ticker symbol of the asset to validate the address against (e.g. BTC, ETH).

Required string length: 3 - 16
Example:

"BTC"

​
method_id
string<uuid>
required

Withdrawal method identifier from GET /b2b/funds/withdrawals/methods/{asset}

​
address
string
required

The crypto address to validate

​
asset_type
enum<string>
default:crypto

Classification of the asset. Pair with asset_symbol to disambiguate when the same ticker exists across asset classes. Defaults to crypto.

Available options:
fiat,
crypto,
stablecoin,
xstock
​
memo
string | null

Memo or tag for networks that require one (e.g., XRP, XLM)

Response

Response

​
data
object
required