Wallet - Net Worth Details
curl --request GET \
--url https://public-api.birdeye.so/wallet/v2/net-worth-details \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/wallet/v2/net-worth-details"
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/net-worth-details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"wallet_address": "HV1KXxWFaSeriyFvXyx48FqG9BoFbfinB8njCJonqP7K",
"currency": "usd",
"net_worth": 11839478.53162622,
"requested_timestamp": "2025-07-31T04:50:06.303258803Z",
"resolved_timestamp": "2025-07-31T04:50:06.475623209Z",
"net_assets": [
{
"symbol": "Salute",
"token_address": "49aR46Zgvh3w7cLnM3nZRC4DSVV2A25tYV1fVxYbjtb4",
"decimal": 4,
"balance": "50000000000",
"price": 1.931249899999106,
"value": 9656249.49999553
},
{
"symbol": "SOL",
"token_address": "So11111111111111111111111111111111111111112",
"decimal": 9,
"balance": "7316581866484",
"price": 181.4958586895311,
"value": 1327929.3085297658
}
]
},
"pagination": {
"limit": 100,
"offset": 0,
"total": 2
}
}{
"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 - Net Worth Details
Retrieve a wallet’s total asset value and detailed asset breakdown at a specific point in the past
GET
/
wallet
/
v2
/
net-worth-details
Wallet - Net Worth Details
curl --request GET \
--url https://public-api.birdeye.so/wallet/v2/net-worth-details \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/wallet/v2/net-worth-details"
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/net-worth-details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"wallet_address": "HV1KXxWFaSeriyFvXyx48FqG9BoFbfinB8njCJonqP7K",
"currency": "usd",
"net_worth": 11839478.53162622,
"requested_timestamp": "2025-07-31T04:50:06.303258803Z",
"resolved_timestamp": "2025-07-31T04:50:06.475623209Z",
"net_assets": [
{
"symbol": "Salute",
"token_address": "49aR46Zgvh3w7cLnM3nZRC4DSVV2A25tYV1fVxYbjtb4",
"decimal": 4,
"balance": "50000000000",
"price": 1.931249899999106,
"value": 9656249.49999553
},
{
"symbol": "SOL",
"token_address": "So11111111111111111111111111111111111111112",
"decimal": 9,
"balance": "7316581866484",
"price": 181.4958586895311,
"value": 1327929.3085297658
}
]
},
"pagination": {
"limit": 100,
"offset": 0,
"total": 2
}
}{
"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
Historical Solana net worth breakdown at one checkpoint.
limitsupports1to100items per request, andoffsetsupports up to10,000.typeaccepts1hand1d.timemust useYYYY-MM-DD HH:mm:ssin UTC, must not be in the future, and whentype=1hit must be within the last 7 days.- Response fields:
balance: raw on-chain balance before decimal adjustment.price: token price in USD at the selected checkpoint.value: token balance multiplied by price after decimal adjustment.
- Standard
- Lite
- Starter
- Premium
- Business
- Enterprise
Solana
Compute Unit ⚙️
Compute Unit ⚙️
- This endpoint consumes
40 CUper request.
Use Cases 💡
Use Cases 💡
- Reconstruct a wallet’s asset composition at a past checkpoint.
- Explain historical net-worth moves by showing which holdings mattered at that time.
- Support portfolio forensics, treasury reporting, and audit-style wallet review.
How to Use 🛠️
How to Use 🛠️
- Set
x-chain=solana. - Pass the wallet address in
wallet. - Choose
timeandtypefor the checkpoint resolution. - Page through large historical holdings sets with
offsetandlimit.
Best Practices ✅
Best Practices ✅
- Use this after the net-worth chart identifies an interesting timestamp.
- Keep checkpoint times consistent across related analyses so holdings, price, and PnL line up.
- Use
1dfor broad historical review and1honly for recent deep dives.
Limitations ⚠️
Limitations ⚠️
- Solana only.
type=1his limited to the last 7 days.
Authorizations
API key for authentication
Headers
Solana network only.
Available options:
solana Query Parameters
The wallet of the account.
Time get net worth. Default is current time.
Time granularity used to group the returned net worth data. Use 1d for daily data with full historical coverage, or 1h for hourly data limited to the last 7 days.
Available options:
1h, 1d Specify the sort order.
Available options:
desc, asc Required range:
1 <= x <= 100Make sure offset <= 10000
Required range:
0 <= x <= 10000Was this page helpful?

