Get Historical Net Worth
Retrieve historical net worth for one or more wallets with filters for time range, assets, liquidity, period, caching, and chain options.
Query details
- Either
walletorwalletsmust be provided - Boolean parameters are passed as strings (
"true","false").
period actually controls the number of pointsperiod defines a fixed grid of timestamps between from and to (e.g. period=1d produces one grid point every 24h). On top of that grid, the response always adds one extra point at the exact timestamp of every balance-changing transfer in the window, so the curve is accurate at the moment each balance change occurs.This means the total number of points is:period=1d returns ~30 grid points plus one point per transfer — a wallet with frequent activity can easily exceed 100 points. period sets the minimum spacing of the baseline grid, it is not a hard cap on the number of returned points.If you need exactly one point per interval, downsample client-side by bucketing balance_history into your target interval and keeping the last value of each bucket.Step-by-Step Tutorial and Video Walkthrough
- Check out the guide: Here
Usage Examples
- Query historical net worth for a single wallet with a specific time range and daily granularity
- Query multiple wallets with liquidity threshold
- Query Historical Net Worth for Multiple Wallets Across Multiple Chains
Response Format
The response contains the wallet addresses, current balance, and a time series of historical balances.Sample Response
Query Parameters
Wallet address
Comma-separated wallet addresses
Comma-separated blockchain IDs
Start date
End date
Include unlisted assets
Baseline granularity of the history grid (5min, 15min, 1h, 6h, 1d, 7d). Sets the minimum spacing between grid points, NOT a hard cap on the number of points: the response also adds one point per balance-changing transfer, so total points ≈ (to-from)/period + number of transfers.
Data accuracy level
Include testnet data
Minimum liquidity threshold
Filter spam tokens
Response
Wallet history response