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.

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 Ethereum's 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://wallet.402pay.co/api/v1/wallet" \
  -H "Authorization: Bearer $PAY402_SECRET_KEY"

const response = await fetch("https://wallet.402pay.co/api/v1/wallet", {
  headers: {
    Authorization: `Bearer ${process.env.PAY402_SECRET_KEY}`,
  },
});
const { data } = await response.json();

import os

import requests

response = requests.get(
    "https://wallet.402pay.co/api/v1/wallet",
    headers={
        "Authorization": f"Bearer {os.environ['PAY402_SECRET_KEY']}",
    },
)
data = response.json()["data"]

Response200 OK

{
  "data": {
    "id": "wal_1fIGZOrILmsCO0jw",
    "kind": "wallet",
    "name": "Treasury",
    "source": "created",
    "total_value_usd": "95442.39",
    "balances": [
      {
        "asset": "USDT",
        "network": "tron",
        "amount": "22995.72",
        "price_usd": "1.00",
        "value_usd": "22995.72"
      },
      {
        "asset": "BTC",
        "network": "bitcoin",
        "amount": "0.17992045",
        "price_usd": "98400.00",
        "value_usd": "17704.17"
      },
      {
        "asset": "LTC",
        "network": "litecoin",
        "amount": "139.41348214",
        "price_usd": "112.00",
        "value_usd": "15614.31"
      },
      {
        "asset": "TRX",
        "network": "tron",
        "amount": "41250.500000",
        "price_usd": "0.32",
        "value_usd": "13200.16"
      },
      {
        "asset": "SOL",
        "network": "solana",
        "amount": "47.4820",
        "price_usd": "184.00",
        "value_usd": "8736.69"
      },
      {
        "asset": "USDC",
        "network": "solana",
        "amount": "7099.29",
        "price_usd": "1.00",
        "value_usd": "7099.29"
      },
      {
        "asset": "USDC",
        "network": "ethereum",
        "amount": "6177.58",
        "price_usd": "1.00",
        "value_usd": "6177.58"
      },
      {
        "asset": "ETH",
        "network": "ethereum",
        "amount": "0.836580",
        "price_usd": "3620.00",
        "value_usd": "3028.42"
      },
      {
        "asset": "USDT",
        "network": "ethereum",
        "amount": "886.05",
        "price_usd": "1.00",
        "value_usd": "886.05"
      }
    ],
    "main_addresses": {
      "ethereum": "0x82DD86f0f1CC201A49EEaf01C1980A6D66AaEb86",
      "solana": "2YJtPr25BcbApPPAXHyAu9USMS3z8KSepTbBx9N3YMgp",
      "tron": "TFtTqBsPS39pnxMaHVzKHYuCurEgof2wDG",
      "bitcoin": "bc1qp932jy8gqh9zn62ef2azjnh5gpvk0hv40jfmpx",
      "litecoin": "ltc1qgznwwx88tuy5fe2pm97mjyfa2tq6ug6udflajg"
    },
    "address_counts": {
      "evm": 118,
      "tron": 37,
      "bitcoin": 24,
      "solana": 46
    },
    "pending_change": null,
    "created_at": "2026-05-09T21:22:00.813Z"
  }
}