Sign in

v1

latestOpenAPI 3.1.02026-07-1325128129.5 KB
wallet

Wallet Portfolio

Returns the wallet's tokens with balances and USD values. Reusable beyond the pay-with-wallet flow (swap source picker, deposit balance display, etc.). Hits BalanceService caches; force_refresh bypasses L1+L2.

post/wallet/portfolio

Headers

X-API-KEYstring required

API key for authentication

Request body

wallet_addressstring required
chain_type'EVM' | 'SOL' | 'SUI' | 'UTXO' required
chain_idsChainID[]
min_balance_usdnumber nullable
force_refreshboolean

Example request

{
  "chain_ids": [
    1,
    8453,
    137
  ],
  "chain_type": "EVM",
  "force_refresh": false,
  "min_balance_usd": 1,
  "wallet_address": "0x1234...abcd"
}

Response

Portfolio scan succeeded

wallet_addressstring required
chain_type'EVM' | 'SOL' | 'SUI' | 'UTXO' required
scanned_atstring date-time required
expires_atstring date-time required

Example response

{
  "chain_type": "EVM",
  "currencies": [
    {
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "balance": {
        "raw_amount": "2400000",
        "ui_amount": 2.4,
        "ui_amount_display": "2.4",
        "value_usd": 123.45
      },
      "chain_id": 1,
      "chain_logo_uri": "https://assets.coingecko.com/asset_platforms/images/279/standard/ethereum.png",
      "decimals": 6,
      "logo_uri": "https://assets.coingecko.com/coins/images/6319/large/usdc.png",
      "price_usd": 1,
      "symbol": "USDC"
    }
  ],
  "wallet_address": "0x1234...abcd"
}