Wallet - Portfolio (V2)

curl --request GET \
  --url https://public-api.birdeye.so/wallet/v2/current-net-worth \
  --header 'X-API-KEY: <api-key>'

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

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

{
  "success": true,
  "data": {
    "wallet": "0x63C12667638f2Ae6fC6ae09B43D98Ec84a8586eA",
    "currency": "usd",
    "total_value": "2263",
    "current_timestamp": "2026-10-05T06:00:00Z",
    "items": [
      {
        "address": "0xb773ec2c326b7f98a5a83fc098825492f020a4c7",
        "decimals": 9,
        "balance": "10000000000",
        "amount": 10,
        "price": 500,
        "valuation_price": 200,
        "value": "2000",
        "network": "robinhood",
        "name": "Staked NET",
        "symbol": "SNET",
        "logo_uri": ""
      },
      {
        "address": "0x08E91b659a545Bfb52F1a5e588Bf6Dc2FA85DE7A",
        "decimals": 18,
        "balance": "1000000000000000000",
        "amount": 1,
        "price": 263,
        "valuation_price": 263,
        "value": "263",
        "network": "robinhood",
        "name": "McDonald's • Robinhood Token",
        "symbol": "MCD",
        "logo_uri": ""
      }
    ]
  },
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 2
  }
}

GET

wallet

current-net-worth

Wallet - Portfolio (V2)

curl --request GET \
  --url https://public-api.birdeye.so/wallet/v2/current-net-worth \
  --header 'X-API-KEY: <api-key>'

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

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

{
  "success": true,
  "data": {
    "wallet": "0x63C12667638f2Ae6fC6ae09B43D98Ec84a8586eA",
    "currency": "usd",
    "total_value": "2263",
    "current_timestamp": "2026-10-05T06:00:00Z",
    "items": [
      {
        "address": "0xb773ec2c326b7f98a5a83fc098825492f020a4c7",
        "decimals": 9,
        "balance": "10000000000",
        "amount": 10,
        "price": 500,
        "valuation_price": 200,
        "value": "2000",
        "network": "robinhood",
        "name": "Staked NET",
        "symbol": "SNET",
        "logo_uri": ""
      },
      {
        "address": "0x08E91b659a545Bfb52F1a5e588Bf6Dc2FA85DE7A",
        "decimals": 18,
        "balance": "1000000000000000000",
        "amount": 1,
        "price": 263,
        "valuation_price": 263,
        "value": "263",
        "network": "robinhood",
        "name": "McDonald's • Robinhood Token",
        "symbol": "MCD",
        "logo_uri": ""
      }
    ]
  },
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 2
  }
}

Usage Note
Accessibility
Chain Supported

Current Solana wallet portfolio and valuation.

This endpoint returns a current wallet portfolio snapshot with total asset value and paginated asset rows.
limit supports 1 to 100 items per request, and offset supports up to 10,000.
filter_value can be used to hide small positions below a minimum USD threshold.
flags can include additional portfolio behaviors such as include_low_liquidity.
sort_by is currently value-oriented and sort_type supports ascending or descending order.

Compute Unit ⚙️

This endpoint consumes 30 CU per request.

Use Cases 💡

Show a wallet’s current portfolio value and holdings breakdown.
Power wallet overview pages, treasury dashboards, and portfolio snapshots.
Filter out dust positions and focus on the holdings that matter.
Rank or inspect one wallet’s top assets before drilling into per-token PnL.

How to Use 🛠️

Set x-chain=solana.
Pass the wallet address in wallet.
Use filter_value to suppress tiny positions.
Page through holdings with offset and limit.

Best Practices ✅

Use this as the primary current-portfolio endpoint instead of stitching holdings and prices manually.
Apply filter_value in UI views where dust assets would otherwise drown out signal.
Cache per-wallet snapshots for a short interval rather than polling every interaction.

Limitations ⚠️

Robinhood portfolio values use an effective valuation price and do not include historical balance-change data.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

Solana or Robinhood. Robinhood supports balance-change, current-net-worth, V1/V2 token balance and /defi/v3/token/holder. Other wallet history and transfer endpoints have separate chain support.

Available options:

solana,

robinhood

Query Parameters

wallet

string

required

The wallet of the account.

filter_value

number

Minimum value threshold; returns tokens with value ≥ this (optional, no default).

sort_by

enum<string>

default:value

Specify the sort field.

Available options:

value

flags

enum<string>[]

Modifiers that change result behavior (default: empty; excludes low-liquidity tokens < $100, use include_low_liquidity to include them).

Available options:

include_low_liquidity

Example:

["include_low_liquidity"]

sort_type

enum<string>

default:desc

required

Specify the sort order.

Available options:

desc,

asc

limit

integer

default:20

Required range: 1 <= x <= 100

offset

integer

default:0

Make sure offset <= 10000

Required range: 0 <= x <= 10000

Response

JSON object containing portfolio of an address

success

boolean

required

Whether the request succeeded.

data

object

required

Show child attributes

pagination

object

Show child attributes