> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Track Wallet Historical Net Worth Across Ethereum, Solana, BNB, Base & More

> Easily retrieve historical wallet net worth over time across chains using the Mobula API.

The [**Get Historical Net Worth**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-history) 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**.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/vIIVeParIPk" title="YouTube video player" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />
</div>

***

## 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](https://admin.mobula.io/)

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**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-activity).\
If you need current token positions with PnL, use [**wallet/positions**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-positions).

***

## Walkthrough — Get Wallet Historical Net Worth

### 1. Prepare your query

Either `wallet` or `wallets` must be provided.

| Parameter | Description                                            |
| --------- | ------------------------------------------------------ |
| `wallet`  | Single wallet address to query                         |
| `wallets` | Comma-separated wallet addresses to query in aggregate |

Optional parameters you can use to control output:

* `blockchains`: comma-separated chains (e.g.,[`solana`](https://docs.mobula.io/blockchains/solana),[`ethereum`](https://docs.mobula.io/blockchains/ethereum),[`base`](https://docs.mobula.io/blockchains/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 baseline history grid is

Examples:

* `period=1h` for hourly points
* `period=1d` for daily net worth
* `period=5min` for high-frequency charts (when needed)

<Note>
  `period` sets the **minimum** spacing of the baseline grid, not a hard cap on the number of points. The response also includes one point at the exact timestamp of every balance-changing transfer, so the total is roughly `(to − from) / period + number of transfers`. A 30-day query with `period=1d` therefore returns \~30 grid points **plus** one point per transfer, which can exceed 100 points for an active wallet. To get exactly one point per interval, bucket `balance_history` client-side and keep the last value per bucket.
</Note>

### 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](https://mobula-demo-endpoint-production.up.railway.app/)

[Wallet History Demo UI](https://mobula-demo-endpoint-production.up.railway.app/wallet-history)

[Docs](https://docs.mobula.io/rest-api-reference/endpoint/wallet-history)

***

## Summary

The [Get Historical Net Worth](https://docs.mobula.io/rest-api-reference/endpoint/wallet-history) 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](https://admin.mobula.io/)