API Endpoints

Wallet - Net Worth Details

get
https://public-api.birdeye.so/wallet/v2/net-worth-details

Retrieve a wallet's total asset value and detailed asset breakdown at a specific point in the past

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Historical Solana net worth breakdown at one checkpoint.

  • limit supports 1 to 100 items per request, and offset supports up to 10,000.
  • type accepts 1h and 1d.
  • time must use YYYY-MM-DD HH:mm:ss in UTC, must not be in the future, and when type=1h it 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.
Compute Unit ⚙️
  • This endpoint consumes 50 CU per request.
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 🛠️
  • Set x-chain=solana.
  • Pass the wallet address in wallet.
  • Choose time and type for the checkpoint resolution.
  • Page through large historical holdings sets with offset and limit.
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 1d for broad historical review and 1h only for recent deep dives.
Limitations ⚠️
  • Solana only.
  • type=1h is limited to the last 7 days.

Query Params
string
required

The wallet of the account.

string

Time get net worth. Default is current time.

string
enum
Defaults to 1d

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.

Allowed:
string
enum
required
Defaults to desc

Specify the sort order.

Allowed:
integer
1 to 100
Defaults to 20
integer
0 to 10000
Defaults to 0

Make sure offset <= 10000

Headers
string
enum
Defaults to solana

Solana network only.

Allowed:
Responses

Updated 12 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 12 days ago

Did this page help you?