GET
/
1
/
wallet
/
history
Get wallet history
curl --request GET \
  --url https://explorer-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
  • Values are passed as strings ("true", "false").
ParameterRequiredDescription
walletCond.Single wallet address to query.
walletsCond.Comma-separated wallet addresses to query in aggregate.
blockchainsCond.Comma-separated list of chains (e.g., ethereum,base). Defaults to all supported chains.
assetCond.Filter the net worth history to a specific asset (symbol or contract address) for the given wallet(s).
cacheCond."true" to allow returning cached results (faster responses).
staleCond.Number of seconds to allow cached data before refreshing. Example: 3600 = 1 hour.
fromCond.Start of the historical window (Unix ms timestamp or ISO 8601).
toCond.End of the historical window (Unix ms timestamp or ISO 8601).
unlistedAssetsCond."true" to include unlisted or non-indexed assets in the calculation.
periodCond.Supported values: 5min, 15min, 1h, 6h, 1d, 7d. Defines aggregation granularity.
accuracyCond.By default, to optimize response time, we will skip analyzing assets that make < 1% of the total net worth. You can set this to true` to analyze all assets.
testnetCond."true" to include testnet data.
minliqCond.Minimum liquidity threshold in USD (default: 1000). Assets below are excluded.
filterSpamCond."true" to remove spam or low-quality assets from results.
fetchUntrackedHistoryCond."true" to fetch historical prices for untracked assets.
fetchAllChainsCond."true" to query all supported chains, including those without premium RPCs.
​

​
Usage Examples

  • Query historical net worth for a single wallet with a specific time range and daily granularity
curl -X GET http://explorer-api.mobula.io/api/1/wallet/history?wallet=4tqMHgB8jjbTgefVfqtVFYzyfQz2LQ8T3E922ePmt6kZ&from=1704067200000&to=1735689600000&period=1d
  • Query multiple wallets with asset filtering and liquidity threshold
curl -X GET https://explorer-api.mobula.io/api/1/wallet/history?wallets=0x33e833f33ced917af1c2879faa95f375a2a66407,0x12e833f33ced917af1c2879faa95f375a2a66408&assets=ETH,USDT&minLiquidity=1000&period=weekly
  • Query Historical Net Worth for Multiple Wallets Across Multiple Chains
curl -X GET https://explorer-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

Query Parameters

​
wallet
string
​
wallets
string
​
portfolio
string
​
blockchains
string
​
asset
string
​
pnl
string
​
cache
string
​
stale
string
​
recheck_contract
string
​
from
string
​
to
string
​
portfolio_settings
string
​
unlistedAssets
string
​
period
string
​
accuracy
string
​
testnet
string
​
minliq
string
​
filterSpam
string
​
fetchUntrackedHistory
string
​
fetchAllChains
string
​
backfillTransfers
string

Response

200 - application/json

Wallet history response

The response is of type object.