List asset balances and wallet addresses per network

The asset balances endpoint lists every coin your PeerPesa account holds, such as USDC, together with the wallet addresses PeerPesa generated for it on each blockchain network and the balance held at each address. One coin can have several addresses, for example a Stellar address with a memo, a Solana address, and EVM (0x) addresses, because each network keeps its own balance.

GET /wallet/assets

Returns all assets for the authenticated account, one entry per coin.

curl https://api.peerpesa.co/v1/wallet/assets \
  -H "Authorization: Bearer $ACCESS_TOKEN"

const res = await fetch("https://api.peerpesa.co/v1/wallet/assets", {
  headers: { Authorization: `Bearer ${accessToken}` },
});
const { data: assets } = await res.json();

Example asset

The response returns a list of asset objects. One USDC asset:

Response

{
  "id": "3bb5afa7-947b-4de2-9876-40ec67d175ab",
  "token_name": "USDC",
  "symbol": "USDC",
  "label": "",
  "contract_address": null,
  "blockchain": "",
  "total_supply": "0.000000000000000000",
  "decimals": 0,
  "token_type": "Native",
  "status": "active",
  "deleted_at": null,
  "created_at": "2025-02-02T20:03:11.000Z",
  "updated_at": "2025-02-07T14:22:39.000Z",
  "wallet": {
    "id": "b11d77d5-760b-4281-8064-4d348aa0739b",
    "user_id": "b9ad5560-7d97-4dbf-8bb6-9a1e73b1c008",
    "label": "USDC Wallet",
    "memo": "",
    "address": "0x0f92Fd6158064cF73c74E95eeac187fc7d3791f8",
    "details": "",
    "wallet_key": "",
    "coin_id": "3bb5afa7-947b-4de2-9876-40ec67d175ab",
    "blockchain_network_id": "8cf1955c-ff62-4088-b753-97748628ea31",
    "account_type": "user",
    "status": "active",
    "is_default": 0,
    "deleted_at": null,
    "updated_at": null,
    "created_at": "2026-02-28T15:16:07.000Z",
    "balance": 0
  },
  "icon": "https://localhost/images/icons/usdc.png",
  "addressCollections": [
    {
      "id": "b11d77d5-760b-4281-8064-4d348aa0739b",
      "user_id": "b9ad5560-7d97-4dbf-8bb6-9a1e73b1c008",
      "label": "USDC Wallet",
      "memo": "",
      "address": "0x0f92Fd6158064cF73c74E95eeac187fc7d3791f8",
      "details": "",
      "wallet_key": "",
      "coin_id": "3bb5afa7-947b-4de2-9876-40ec67d175ab",
      "blockchain_network_id": "8cf1955c-ff62-4088-b753-97748628ea31",
      "account_type": "user",
      "status": "active",
      "is_default": 0,
      "deleted_at": null,
      "updated_at": null,
      "created_at": "2026-02-28T15:16:07.000Z",
      "balance": 0
    },
    {
      "id": "b6e1094d-f3a1-4661-8286-a8085de0da71",
      "user_id": "b9ad5560-7d97-4dbf-8bb6-9a1e73b1c008",
      "label": "USDC Wallet",
      "memo": "a8a45dcd8693471b",
      "address": "9jsCGGub4FV9AgWZ9xUyAJaMPb6W2GCswBJqnoqK41o4",
      "details": "",
      "wallet_key": "",
      "coin_id": "3bb5afa7-947b-4de2-9876-40ec67d175ab",
      "blockchain_network_id": "550e8400-e29b-41d4-a716-446655440000",
      "account_type": "user",
      "status": "active",
      "is_default": 0,
      "deleted_at": null,
      "updated_at": null,
      "created_at": "2026-02-28T15:16:04.000Z",
      "balance": 0
    },
    {
      "id": "f050485c-8156-4fd4-86a3-6c21b3af35b2",
      "user_id": "b9ad5560-7d97-4dbf-8bb6-9a1e73b1c008",
      "label": "USDC Wallet",
      "memo": "SHXDZD",
      "address": "GAKA4FLXAMBVVZOKM63VJZD63JOLCSZQAMQTMUCKFZ52OPD5ZIBXGTXG",
      "details": "",
      "wallet_key": "",
      "coin_id": "3bb5afa7-947b-4de2-9876-40ec67d175ab",
      "blockchain_network_id": "3bb5afa7-947b-4de2-9876-40ec67d1711b",
      "account_type": "user",
      "status": "active",
      "is_default": 0,
      "deleted_at": null,
      "updated_at": null,
      "created_at": "2026-02-28T15:15:55.000Z",
      "balance": 0
    },
    {
      "id": "9ac6e2d9-2834-4f58-8349-76ef736b4648",
      "user_id": "b9ad5560-7d97-4dbf-8bb6-9a1e73b1c008",
      "label": "USDC Wallet",
      "memo": "",
      "address": "0x965520F935C5453aDcfCA3dc64be89CeB935FcdC",
      "details": "",
      "wallet_key": "",
      "coin_id": "3bb5afa7-947b-4de2-9876-40ec67d175ab",
      "blockchain_network_id": "3bb5afa7-947b-4de2-9876-40ec67d1711a",
      "account_type": "user",
      "status": "active",
      "is_default": 0,
      "deleted_at": null,
      "updated_at": null,
      "created_at": "2025-12-04T15:53:39.000Z",
      "balance": 0
    },
    {
      "id": "c1f736af-b034-4765-b6db-b150674b820d",
      "user_id": "b9ad5560-7d97-4dbf-8bb6-9a1e73b1c008",
      "label": "USDC Wallet",
      "memo": "",
      "address": "0xF849Dce76c31ba36e36C809E76e5D8605BFdAB42",
      "details": "",
      "wallet_key": "",
      "coin_id": "3bb5afa7-947b-4de2-9876-40ec67d175ab",
      "blockchain_network_id": "3bb5afa7-947b-4de2-9876-40ec67d1711a",
      "account_type": "user",
      "status": "active",
      "is_default": 0,
      "deleted_at": null,
      "updated_at": null,
      "created_at": "2025-02-18T08:11:08.000Z",
      "balance": 0.003442
    }
  ]
}

balance is returned as a number, not a decimal string. To get the total held for a coin, add up balance across every entry in addressCollections. In the example, the USDC total is 0.003442.

When a wallet has a memo, include it with every deposit to that address. Deposits to shared Stellar or Solana addresses without the correct memo cannot be credited to your account.

Asset fields

string

Coin ID (UUID). Matches coin_id on each wallet.

string

Display name of the coin, for example USDC.

string

Ticker symbol, for example USDC.

string

Optional display label. Empty when not set.

string | null

Token contract address, when the coin has a single contract. null for coins issued on several networks, where each network has its own contract.

string

Blockchain name for single-network coins. Empty for multi-network coins such as USDC.

string

Token supply as a decimal string. Informational only.

integer

Token decimal places, where set.

string

Token type, for example Native.

string

active or inactive. Inactive coins cannot be deposited, sent, or swapped.

string

URL of the coin icon for display in your UI.

string

ISO 8601 timestamp when the coin was added.

string

ISO 8601 timestamp of the last change to the coin.

string | null

Set when the coin has been removed. null for available coins.

object

The primary wallet for this coin. Same shape as an entry in addressCollections.

object[]

Every wallet address you hold for this coin, one or more per network.

Show wallet properties

string

Wallet ID (UUID).

string

ID of the account that owns the wallet.

string

Wallet label, for example USDC Wallet.

string

Memo or destination tag to include with deposits. Empty when the address is not shared, such as 0x addresses.

string

Deposit address on the wallet’s network.

string

Extra wallet details. Usually empty.

string

Reserved. Always returned empty.

string

ID of the coin this wallet holds.

string

ID of the blockchain network the address belongs to.

string

Owner type, for example user.

string

active or inactive.

integer

1 if this is the default wallet for the coin, otherwise 0.

number

Balance held at this address, in whole coin units.

string

ISO 8601 timestamp when the address was generated.

string | null

ISO 8601 timestamp of the last update, or null.

string | null

Set when the wallet has been removed.

Reading balances in your app

Total balance per coin

const res = await fetch("https://api.peerpesa.co/v1/wallet/assets", {
  headers: { Authorization: `Bearer ${accessToken}` },
});
const { data: assets } = await res.json();

const balances = assets
  .filter((asset) => asset.status === "active")
  .map((asset) => ({
    symbol: asset.symbol,
    icon: asset.icon,
    total: asset.addressCollections.reduce((sum, w) => sum + w.balance, 0),
    addresses: asset.addressCollections.map((w) => ({
      network_id: w.blockchain_network_id,
      address: w.address,
      memo: w.memo || null,
      balance: w.balance,
    })),
  }));

Errors

Code	Status	Cause
`unauthorized`	401	Token missing or expired
`rate_limited`	429	Too many requests. Retry after the `Retry-After` delay.

See Error Codes for the full list.

Deposit

Generate a new deposit address on a network.

List Currencies

See supported coins, networks, and fees.

Send

Send crypto from your balance.

Swap

Move value between coins and networks.

​GET /wallet/assets

​Example asset

​Asset fields

​Reading balances in your app

​Errors

Deposit

List Currencies

Send

Swap

GET /wallet/assets

Example asset

Asset fields

Reading balances in your app

Errors