Skip to content
Developer
Sign inSign up

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. total_value_usd and each balance's price_usd and value_usd are decimal strings in US dollars. The recovery phrase never leaves your browser.

A balance's amount is what can be sent now. On Bitcoin and Litecoin, a payment on its way or a send's change waits for a confirmation in pending_amount, worth pending_value_usd; elsewhere both are zero. The wallet's pending_value_usd adds them up.

Query

  • refresh boolean
    true waits for the balances to be read from the networks again, rather than returning the last ones read. If the read doesn't finish in time, the last known balances come back.
  • network string
    With refresh: reads again only the accounts that this network's coins are on, such as after a send.

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 is the count Ethereum and Base share, 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://wallet.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": "96692.79",    "pending_value_usd": "0.00",    "balances": [      {        "asset": "USDT",        "network": "tron",        "amount": "22995.72",        "pending_amount": "0.00",        "price_usd": "1.00",        "value_usd": "22995.72",        "pending_value_usd": "0.00"      },      {        "asset": "BTC",        "network": "bitcoin",        "amount": "0.17992045",        "pending_amount": "0.00000000",        "price_usd": "98400.00",        "value_usd": "17704.17",        "pending_value_usd": "0.00"      },      {        "asset": "LTC",        "network": "litecoin",        "amount": "139.41348214",        "pending_amount": "0.00000000",        "price_usd": "112.00",        "value_usd": "15614.31",        "pending_value_usd": "0.00"      },      {        "asset": "TRX",        "network": "tron",        "amount": "41250.50",        "pending_amount": "0.00",        "price_usd": "0.32",        "value_usd": "13200.16",        "pending_value_usd": "0.00"      },      {        "asset": "SOL",        "network": "solana",        "amount": "47.4820",        "pending_amount": "0.0000",        "price_usd": "184.00",        "value_usd": "8736.69",        "pending_value_usd": "0.00"      },      {        "asset": "USDC",        "network": "solana",        "amount": "7099.29",        "pending_amount": "0.00",        "price_usd": "1.00",        "value_usd": "7099.29",        "pending_value_usd": "0.00"      },      {        "asset": "USDC",        "network": "ethereum",        "amount": "6177.58",        "pending_amount": "0.00",        "price_usd": "1.00",        "value_usd": "6177.58",        "pending_value_usd": "0.00"      },      {        "asset": "ETH",        "network": "ethereum",        "amount": "0.836580",        "pending_amount": "0.000000",        "price_usd": "3620.00",        "value_usd": "3028.42",        "pending_value_usd": "0.00"      },      {        "asset": "USDC",        "network": "base",        "amount": "1250.40",        "pending_amount": "0.00",        "price_usd": "1.00",        "value_usd": "1250.40",        "pending_value_usd": "0.00"      },      {        "asset": "USDT",        "network": "ethereum",        "amount": "886.05",        "pending_amount": "0.00",        "price_usd": "1.00",        "value_usd": "886.05",        "pending_value_usd": "0.00"      }    ],    "main_addresses": {      "ethereum": "0x82DD86f0f1CC201A49EEaf01C1980A6D66AaEb86",      "base": "0x82DD86f0f1CC201A49EEaf01C1980A6D66AaEb86",      "solana": "2YJtPr25BcbApPPAXHyAu9USMS3z8KSepTbBx9N3YMgp",      "tron": "TFtTqBsPS39pnxMaHVzKHYuCurEgof2wDG",      "bitcoin": "bc1qp932jy8gqh9zn62ef2azjnh5gpvk0hv40jfmpx",      "litecoin": "ltc1qgznwwx88tuy5fe2pm97mjyfa2tq6ug6udflajg"    },    "address_counts": {      "evm": 118,      "tron": 37,      "bitcoin": 24,      "litecoin": 19,      "solana": 46    },    "pending_change": null,    "created_at": "2026-05-09T21:22:00.813Z"  }}