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).
assetNo—Filter the net worth history to a specific asset (name or symbol).
cacheNofalse"true" to allow returning cached results (faster responses).
staleNo0Number of seconds to allow cached data before refreshing. Example: 3600 = 1 hour.
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 asset filtering and liquidity threshold
curl -X GET https://demo-api.mobula.io/api/1/wallet/history?wallets=0x33e833f33ced917af1c2879faa95f375a2a66407,0x12e833f33ced917af1c2879faa95f375a2a66408&asset=ETH&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

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

​
data
object
required