Skip to main content
GET
/
1
/
wallet
/
history
Get wallet history
curl --request GET \
  --url https://demo-api.mobula.io/api/1/wallet/history
{
  "data": {
    "wallets": [
      "<string>"
    ],
    "balance_usd": 123,
    "balance_history": [
      [
        123
      ]
    ],
    "backfill_status": "processed"
  }
}

​
Query details

  • Either wallet or wallets must be provided
  • Boolean parameters are passed as strings ("true", "false").
ParameterRequiredDefaultDescription
walletCond.—Single wallet address to query.
walletsCond.—Comma-separated wallet addresses to query in aggregate.
blockchainsNoAllComma-separated list of chains (e.g., ethereum,base).
fromNo24h agoStart of the historical window (Unix ms timestamp).
toNoNowEnd of the historical window (Unix ms timestamp).
unlistedAssetsNotrue"true" to include unlisted or non-indexed assets in the calculation.
periodNo—Aggregation granularity. Supported values: 5min, 15min, 1h, 6h, 1d, 7d.
accuracyNomaximumSet to "maximum" to analyze all assets. By default, to optimize response time, assets making < 1% of total net worth may be skipped.
testnetNofalse"true" to include testnet data.
minliqNo1000Minimum liquidity threshold in USD. Assets below are excluded.
filterSpamNofalse"true" to remove spam or low-quality assets from results.
fetchUntrackedHistoryNofalse"true" to fetch historical prices for untracked assets.
fetchAllChainsNofalse"true" to query all supported chains, including those without premium RPCs.
shouldFetchPriceChangeNofalseSet to "24h" to include 24-hour price change data. Note: This parameter accepts the value "24h", not "true".
backfillTransfersNofalse"true" to trigger backfilling of transfer history for the wallet(s). Returns backfill_status in the response.
​

​
Usage Examples

  • Query historical net worth for a single wallet with a specific time range and daily granularity
curl -X GET http://demo-api.mobula.io/api/1/wallet/history?wallet=4tqMHgB8jjbTgefVfqtVFYzyfQz2LQ8T3E922ePmt6kZ&from=1704067200000&to=1735689600000&period=1d
  • Query multiple wallets with liquidity threshold
curl -X GET https://demo-api.mobula.io/api/1/wallet/history?wallets=0x33e833f33ced917af1c2879faa95f375a2a66407,0x12e833f33ced917af1c2879faa95f375a2a66408&minliq=1000&period=1d
  • Query Historical Net Worth for Multiple Wallets Across Multiple Chains
curl -X GET https://demo-api.mobula.io/api/1/wallet/history?wallets=0x6b114A6bCACEDE76A714d251949fAaC5ac3245A8,4X2FZ9PqrjRPRRxSConh1r8eQarEwrrMtXLkzhA1J4E9&blockchains=1,8453,42161,10,59144,56,137,43114,81457,169,34443,solana,1030,4200&from=1739878441921&period=1h&unlistedAssets=true&accuracy=maximum

​
Response Format

The response contains the wallet addresses, current balance, and a time series of historical balances.
FieldTypeDescription
walletsstring[]List of queried wallet addresses
balance_usdnumberCurrent total balance in USD
balance_history[number, number][]Array of [timestamp_ms, balance_usd] tuples representing the historical net worth
backfill_statusstringTransfer backfill status: processed, processing, or pending (only present when backfillTransfers=true)

​
Sample Response

{
  "data": {
    "wallets": ["0x6b114A6bCACEDE76A714d251949fAaC5ac3245A8"],
    "balance_usd": 15420.55,
    "balance_history": [
      [1739878441921, 14200.30],
      [1739882041921, 14350.80],
      [1739885641921, 14500.10],
      [1739889241921, 14800.55],
      [1739892841921, 15100.20],
      [1739896441921, 15420.55]
    ],
    "backfill_status": "processed"
  }
}

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

Time period for history

​
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