Wallet - Portfolio (V2)
curl --request GET \
--url https://public-api.birdeye.so/wallet/v2/current-net-worth \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/wallet/v2/current-net-worth"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)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_address": "8X35rQUK2u9hfn8rMPwwr6ZSEUhbmfDPEapp589XyoM1",
"currency": "usd",
"total_value": "0.010349446772590722",
"current_timestamp": "2025-05-19T04:47:19.414327725Z",
"items": [
{
"address": "cCpv5Z3nqKbKohYqgY7rxFebjMjvU7SBhwgYbCipump",
"decimals": 6,
"price": 0.00014999198221145974,
"balance": "69000000",
"amount": 69,
"network": "solana",
"name": "Smellow",
"symbol": "SMLO",
"logo_uri": "https://pump.mypinata.cloud/ipfs/QmcCjKS4MMeji11PqnNhqDSXd6gD4iGj1nC6zjyfaekuQZ",
"value": "0.010349446772590722"
}
]
},
"pagination": {
"limit": 100,
"offset": 0,
"total": 1
}
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}Wallet, Networth & PnL
Wallet - Portfolio (V2)
Retrieve the portfolio and total asset value of a given wallet address.
GET
/
wallet
/
v2
/
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>'import requests
url = "https://public-api.birdeye.so/wallet/v2/current-net-worth"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)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_address": "8X35rQUK2u9hfn8rMPwwr6ZSEUhbmfDPEapp589XyoM1",
"currency": "usd",
"total_value": "0.010349446772590722",
"current_timestamp": "2025-05-19T04:47:19.414327725Z",
"items": [
{
"address": "cCpv5Z3nqKbKohYqgY7rxFebjMjvU7SBhwgYbCipump",
"decimals": 6,
"price": 0.00014999198221145974,
"balance": "69000000",
"amount": 69,
"network": "solana",
"name": "Smellow",
"symbol": "SMLO",
"logo_uri": "https://pump.mypinata.cloud/ipfs/QmcCjKS4MMeji11PqnNhqDSXd6gD4iGj1nC6zjyfaekuQZ",
"value": "0.010349446772590722"
}
]
},
"pagination": {
"limit": 100,
"offset": 0,
"total": 1
}
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}- 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.
limitsupports1to100items per request, andoffsetsupports up to10,000.filter_valuecan be used to hide small positions below a minimum USD threshold.flagscan include additional portfolio behaviors such asinclude_low_liquidity.sort_byis currently value-oriented andsort_typesupports ascending or descending order.
- Standard
- Lite
- Starter
- Premium
- Business
- Enterprise
Solana
Compute Unit ⚙️
Compute Unit ⚙️
- This endpoint consumes
20 CUper request.
Use Cases 💡
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 🛠️
How to Use 🛠️
- Set
x-chain=solana. - Pass the wallet address in
wallet. - Use
filter_valueto suppress tiny positions. - Page through holdings with
offsetandlimit.
Best Practices ✅
Best Practices ✅
- Use this as the primary current-portfolio endpoint instead of stitching holdings and prices manually.
- Apply
filter_valuein UI views where dust assets would otherwise drown out signal. - Cache per-wallet snapshots for a short interval rather than polling every interaction.
Limitations ⚠️
Limitations ⚠️
- Solana only.
Authorizations
API key for authentication
Headers
Solana network only.
Available options:
solana Query Parameters
The wallet of the account.
Minimum value threshold; returns tokens with value ≥ this (optional, no default).
Specify the sort field.
Available options:
value 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"]
Specify the sort order.
Available options:
desc, asc Required range:
1 <= x <= 100Make sure offset <= 10000
Required range:
0 <= x <= 10000Was this page helpful?

