Skip to main content
The Get Historical Net Worth endpoint returns historical net worth (USD) for one wallet or multiple wallets combined, with flexible filters for time range, chains, liquidity thresholds, spam filtering, and aggregation period. It is ideal for developers building portfolio history charts, wallet analytics dashboards, performance tracking, and multi-wallet reporting tools.

​
What this endpoint does

With this API, you can:
  • Retrieve historical wallet net worth over a specified time range
  • Query one wallet or multiple wallets aggregated into a single history
  • Filter results by blockchains (or fetch across many chains)
  • Set time windows using from and to (Unix ms timestamps)
  • Choose the chart granularity using period (5min → 7d)
  • Filter low-liquidity assets using minliq
  • Optionally include unlisted assets, filter spam, and fetch untracked history
  • Trigger transfer backfilling and read backfill_status in the response
Unlike portfolio snapshot endpoints, this one is designed for time-series net worth history.

​
What you’ll need

  • Basic knowledge of REST APIs
  • A wallet address (or multiple wallet addresses)
  • A Mobula API key
Note: All Mobula endpoints require an API key.
Get a free API key: Here Optional:
  • DexScreener or a block explorer to find example wallets to test

​
When to use Get Historical Net Worth

Use this endpoint when you want to:
  • Build a wallet net worth chart over time
  • Track portfolio performance historically for a wallet
  • Combine multiple wallets into a single “group net worth” timeline
  • Filter out spam tokens or low-liquidity assets from historical calculations
  • Generate performance history for dashboards, reports, or user profiles
If you need wallet activity events (transfers/swaps), use wallet/activity.
If you need current token positions with PnL, use wallet/positions.

​
Walkthrough — Get Wallet Historical Net Worth

​
1. Prepare your query

Either wallet or wallets must be provided.
ParameterDescription
walletSingle wallet address to query
walletsComma-separated wallet addresses to query in aggregate
Optional parameters you can use to control output:
  • blockchains: comma-separated chains (e.g., ethereum,base)
  • from: start time (Unix ms timestamp)
  • to: end time (Unix ms timestamp)
  • period: aggregation granularity (5min, 15min, 1h, 6h, 1d, 7d)
  • unlistedAssets: "true" to include unlisted assets
  • accuracy: set to "maximum" to analyze all assets (otherwise small assets may be skipped)
  • minliq: minimum liquidity threshold in USD (assets below excluded)
  • filterSpam: "true" to remove spam/low-quality assets
  • fetchUntrackedHistory: "true" to fetch historical prices for untracked assets
  • fetchAllChains: "true" to query all supported chains
  • shouldFetchPriceChange: set to "24h" to include 24-hour price change data
  • backfillTransfers: "true" to trigger transfer backfilling (returns backfill_status)
  • testnet: "true" to include testnet data
Note: Boolean parameters are passed as strings: "true" or "false".

​
2. Choose your time range and granularity

This endpoint uses Unix timestamps in milliseconds.
  • Use from and to to define the window
  • Use period to define how detailed the history is
Examples:
  • period=1h for hourly points
  • period=1d for daily net worth
  • period=5min for high-frequency charts (when needed)

​
3. Decide if you want single-wallet or multi-wallet history

  • Use wallet= for one wallet
  • Use wallets= for multiple wallets combined (comma-separated)
This is useful for:
  • tracking a user’s wallet + cold wallet together
  • combining treasury wallets
  • aggregating multiple addresses into one net worth chart

​
4. Fill the API form

Once the wallet address is filled (and optional filters are set), click Send to retrieve the wallet’s historical data.

​
Reviewing the wallet historical net worth response

The response returns a historical net worth object inside data:
  • wallets: list of queried wallets (or aggregated wallet list)
  • balance_usd: current balance in USD (summary)
  • balance_history: historical net worth time series
  • backfill_status: status for transfer backfill (when enabled)

​
Try It Live with Mobula Wallet History Demo (UI)

You can also test this endpoint using our demo UI: Demo UI Homepage Wallet History Demo UI Docs

​
Summary

The Get Historical Net Worth endpoint lets you build accurate wallet net worth history charts, with support for:
  • Single wallet or multi-wallet aggregation
  • Flexible time windows (from, to)
  • Multiple chains via blockchains
  • Chart granularity using period
  • Cleaner results via minliq and filterSpam
  • Optional backfill status reporting
If you’re building portfolio performance analytics or historical dashboards, this endpoint is the right choice.

​
Try Mobula for Free

Try our free API today and start building in minutes.
Get your free API key: Here