Skip to main content
GET
/
v1
/
accounts
/
{account_id}
/
funds
/
withdrawals
/
addresses
curl
curl -X GET "https://api.services.payward.com/v1/accounts/W4BE9868GY65TB6523/funds/withdrawals/addresses" \
  -H "API-Key: $PWS_API_KEY" \
  -H "API-Nonce: $PWS_API_NONCE" \
  -H "API-Sign: $PWS_API_SIGN"
{
  "data": [
    {
      "key": "My cold storage",
      "asset": {
        "symbol": "BTC",
        "type": "crypto"
      },
      "method": {
        "id": "b3a7d8b4-9f36-4c2e-9c1e-7b9e6f9a0a11",
        "name": "Bitcoin"
      },
      "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
      "memo": null,
      "tag": null,
      "created_at": "2025-11-04T18:24:11Z"
    },
    {
      "key": "Treasury XRP",
      "asset": {
        "symbol": "XRP",
        "type": "crypto"
      },
      "method": {
        "id": "5e1c4a08-7a4a-4d74-9a81-2c9b7c28a1d2",
        "name": "XRP"
      },
      "address": "rEb8TK3gBgk5auZkwc6sHnwrGVJH8DuaLh",
      "memo": null,
      "tag": "4521980",
      "created_at": "2026-01-22T09:12:43Z"
    }
  ],
  "next_page_token": null
}

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.

Path Parameters

​
account_id
string
required

ID of the account the request applies to. This refers to one of the accounts held by the user the request is acting on behalf of (typically the user's main account, but any of the user's accounts is accepted). Routes the request to that specific account container. Canonical identifier for an account in the Payward public API.

Required string length: 14 - 42

Query Parameters

​
asset_symbol
string

Ticker symbol of the asset to filter saved withdrawal addresses by (e.g. BTC, ETH). Optional; if omitted, addresses for all assets are returned. Ticker symbol of an asset (e.g. BTC, USDC, EUR).

Required string length: 3 - 16
Example:

"BTC"

​
asset_type
enum<string>
default:crypto

Classification of the asset to filter saved withdrawal addresses by. Pair with asset_symbol to disambiguate when the same ticker exists across asset classes. Defaults to crypto.

Available options:
fiat,
crypto,
stablecoin,
xstock
​
method_id
string<uuid> | null

Filter by withdrawal method identifier

​
key
string | null

Filter by saved withdrawal address key

Response

Response

​
data
object[]
required

Result page.

​
next_page_token
string

Opaque cursor for the next page of results. Absent when there are no more pages.

Required string length: 1 - 256