Retrieve the wallet

Get your wallet's balances per coin and network, and its main addresses.

Only public data comes back: balances with their USD value, and the main address on each network. The recovery phrase never leaves your browser.

address_counts gives, for each key family, the highest index checkout has handed out plus one: how far a wallet app restoring your recovery phrase has to look. EVM networks share one count, and Solana's counts the addresses its checkout key derived.

pending_change is a deletion waiting out its hold, or null. Until its effective_at, the wallet keeps receiving payments.

Errors

404 not_found

Your business has no wallet yet.

Any request can also fail on its key or its body. See errors.

Request

curl "https://dash.402pay.co/api/v1/wallet" \  -H "Authorization: Bearer $PAY402_SECRET_KEY"

Response200 OK

{  "data": {    "id": "wal_1fIGZOrILmsCO0jw",    "kind": "wallet",    "name": "Treasury",    "source": "created",    "total_value_usd": 9544239,    "balances": [      {        "asset": "USDC",        "network": "polygon",        "amount": "28814.47",        "price_usd": 100,        "value_usd": 2881447      },      {        "asset": "USDT",        "network": "tron",        "amount": "22995.72",        "price_usd": 100,        "value_usd": 2299572      },      {        "asset": "BTC",        "network": "bitcoin",        "amount": "0.17992045",        "price_usd": 9840000,        "value_usd": 1770417      },      {        "asset": "SOL",        "network": "solana",        "amount": "47.4820",        "price_usd": 18400,        "value_usd": 873669      },      {        "asset": "USDC",        "network": "solana",        "amount": "7099.29",        "price_usd": 100,        "value_usd": 709929      },      {        "asset": "USDC",        "network": "ethereum",        "amount": "6177.58",        "price_usd": 100,        "value_usd": 617758      },      {        "asset": "ETH",        "network": "ethereum",        "amount": "0.836580",        "price_usd": 362000,        "value_usd": 302842      },      {        "asset": "USDT",        "network": "ethereum",        "amount": "886.05",        "price_usd": 100,        "value_usd": 88605      }    ],    "main_addresses": {      "ethereum": "0x82DD86f0f1CC201A49EEaf01C1980A6D66AaEb86",      "polygon": "0x82DD86f0f1CC201A49EEaf01C1980A6D66AaEb86",      "solana": "2YJtPr25BcbApPPAXHyAu9USMS3z8KSepTbBx9N3YMgp",      "tron": "TFtTqBsPS39pnxMaHVzKHYuCurEgof2wDG",      "bitcoin": "bc1qp932jy8gqh9zn62ef2azjnh5gpvk0hv40jfmpx"    },    "address_counts": {      "evm": 118,      "tron": 37,      "bitcoin": 24,      "solana": 46    },    "pending_change": null,    "created_at": "2026-05-09T21:22:00.813Z"  }}