Wallet Portfolio (Beta)

curl --request GET \
  --url https://public-api.birdeye.so/v1/wallet/token_list \
  --header 'X-API-KEY: <api-key>' \
  --header 'x-chain: <x-chain>'

import requests

url = "https://public-api.birdeye.so/v1/wallet/token_list"

headers = {
    "x-chain": "<x-chain>",
    "X-API-KEY": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-chain': '<x-chain>', 'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/v1/wallet/token_list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "items": [
      {
        "address": "So11111111111111111111111111111111111111112",
        "decimals": 9,
        "balance": 130718,
        "uiAmount": 0.000130718,
        "chainId": "solana",
        "name": "Wrapped SOL",
        "symbol": "SOL",
        "icon": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
        "logoURI": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
        "priceUsd": 186.35315787784225,
        "valueUsd": 0.02435971209147578,
        "isScaledUiToken": false,
        "multiplier": null
      },
      {
        "address": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
        "decimals": 9,
        "balance": 20280,
        "uiAmount": 0.00002028,
        "chainId": "solana",
        "name": "Jito Staked SOL",
        "symbol": "JitoSOL",
        "icon": "https://storage.googleapis.com/token-metadata/JitoSOL-256.png",
        "logoURI": "https://storage.googleapis.com/token-metadata/JitoSOL-256.png",
        "priceUsd": 227.7398265331134,
        "valueUsd": 0.0046185636820915395,
        "isScaledUiToken": false,
        "multiplier": null
      },
      {
        "address": "J3NKxxXZcnNiMjKw9hYb2K4LUxgwB6t1FtPtQVsv3KFr",
        "decimals": 8,
        "balance": 3159,
        "uiAmount": 0.00003159,
        "chainId": "solana",
        "name": "SPX6900 (Wormhole)",
        "symbol": "SPX",
        "icon": "https://i.postimg.cc/w3Yq0dHf/2023-12-21-17-19-37.jpg",
        "logoURI": "https://i.postimg.cc/w3Yq0dHf/2023-12-21-17-19-37.jpg",
        "priceUsd": 1.9727875449629464,
        "valueUsd": 0.00006232035854537948,
        "isScaledUiToken": false,
        "multiplier": null
      }
    ]
  }
}

GET

wallet

token_list

Wallet Portfolio (Beta)

curl --request GET \
  --url https://public-api.birdeye.so/v1/wallet/token_list \
  --header 'X-API-KEY: <api-key>' \
  --header 'x-chain: <x-chain>'

import requests

url = "https://public-api.birdeye.so/v1/wallet/token_list"

headers = {
    "x-chain": "<x-chain>",
    "X-API-KEY": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-chain': '<x-chain>', 'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/v1/wallet/token_list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "items": [
      {
        "address": "So11111111111111111111111111111111111111112",
        "decimals": 9,
        "balance": 130718,
        "uiAmount": 0.000130718,
        "chainId": "solana",
        "name": "Wrapped SOL",
        "symbol": "SOL",
        "icon": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
        "logoURI": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
        "priceUsd": 186.35315787784225,
        "valueUsd": 0.02435971209147578,
        "isScaledUiToken": false,
        "multiplier": null
      },
      {
        "address": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
        "decimals": 9,
        "balance": 20280,
        "uiAmount": 0.00002028,
        "chainId": "solana",
        "name": "Jito Staked SOL",
        "symbol": "JitoSOL",
        "icon": "https://storage.googleapis.com/token-metadata/JitoSOL-256.png",
        "logoURI": "https://storage.googleapis.com/token-metadata/JitoSOL-256.png",
        "priceUsd": 227.7398265331134,
        "valueUsd": 0.0046185636820915395,
        "isScaledUiToken": false,
        "multiplier": null
      },
      {
        "address": "J3NKxxXZcnNiMjKw9hYb2K4LUxgwB6t1FtPtQVsv3KFr",
        "decimals": 8,
        "balance": 3159,
        "uiAmount": 0.00003159,
        "chainId": "solana",
        "name": "SPX6900 (Wormhole)",
        "symbol": "SPX",
        "icon": "https://i.postimg.cc/w3Yq0dHf/2023-12-21-17-19-37.jpg",
        "logoURI": "https://i.postimg.cc/w3Yq0dHf/2023-12-21-17-19-37.jpg",
        "priceUsd": 1.9727875449629464,
        "valueUsd": 0.00006232035854537948,
        "isScaledUiToken": false,
        "multiplier": null
      }
    ]
  }
}

Usage Note
Accessibility
Chain Supported

Beta wallet holdings inventory.

This endpoint returns the current portfolio inventory for one wallet.
ui_amount_mode controls Solana Token-2022 scaled amounts; other chains are normalized to scaled.
This is a beta wallet endpoint. Prefer V2 net-worth endpoints when you need maintained portfolio valuation flows.

Compute Unit ⚙️

This endpoint consumes 50 CU per request.

Use Cases 💡

List a wallet’s current token holdings for portfolio tables and account explorers.
Build wallet inventory screens before layering in PnL or net-worth analysis.
Quickly inspect which tokens a wallet currently holds.

How to Use 🛠️

Set x-chain=solana.
Pass the wallet address in wallet.
Use ui_amount_mode when you need raw versus scaled token amounts on Solana.

Best Practices ✅

Treat this as an inventory endpoint, not a valuation endpoint; combine it with price or PnL data if needed.
Prefer V2 portfolio APIs for production-facing wallet value screens.

Limitations ⚠️

Beta endpoint.
Solana only.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

required

A chain name listed in supported networks.

Available options:

solana

Query Parameters

wallet

string

required

The address of a wallet.

ui_amount_mode

enum<string>

default:scaled

Indicate whether to use the scaled amount for scaled ui amount tokens. Only support solana

Available options:

raw,

scaled

Response

JSON object containing a wallet's token holdings, with one row per token and optional total USD value.

success

boolean

required

Whether the request succeeded.

data

object

required

Show child attributes