Skip to main content
GET
Get wallet history

Query details

  • Either wallet or wallets must be provided
  • Boolean parameters are passed as strings ("true", "false").
How 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:
So a 30-day query with 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
string

Wallet address

wallets
string

Comma-separated wallet addresses

blockchains
string

Comma-separated blockchain IDs

from
string

Start date

to
string

End date

unlistedAssets
string

Include unlisted assets

period
string

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.

accuracy
string

Data accuracy level

testnet
string

Include testnet data

minliq
string

Minimum liquidity threshold

filterSpam
string

Filter spam tokens

Response

200 - application/json

Wallet history response

data
object
required