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.
Overview Query token balances held by a wallet address. Supports multi-chain filtering, scam token removal, cursor-based pagination, and optional resolution of full token metadata.
Filter by specific networks or tokens
Include or exclude native assets
Remove scam tokens automatically
Sort by balance amount or USD value
Cursor-based pagination for large portfolios
Optionally resolve full token details and first-held timestamps
Returns See BalancesResponse and Balance for full type details. Show View fields (BalancesResponse)
Array of balance objects. Wallet identifier in address:networkId format.
Token identifier in tokenAddress:networkId format.
Raw balance in smallest units (before decimal shift).
Formatted balance (decimal-adjusted).
USD value of the balance.
Current token price in USD.
Unix timestamp when the wallet first held this token.
Available liquidity for the token in USD.
Cursor for fetching the next page. null if no more results.
Arguments See BalancesInput for full details. Wallet address to fetch balances for.
Array of network IDs to filter by (e.g. [1, 56, 1399811149]).
Array of token addresses to filter by.
Whether to include native assets (default: true).
Maximum number of results to return (default: 50).
Pagination cursor from a previous response.
Whether to filter out scam tokens (default: true).
Sort direction. Show RankingDirection values
Example { balances ( input : { walletAddress : "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" networks : [ 1 ] limit : 10 removeScams : true sortBy : USD_VALUE sortDirection : DESC }) { items { tokenAddress networkId balance shiftedBalance balanceUsd tokenPriceUsd liquidityUsd token { name symbol decimals address networkId } } cursor } }
Use the cursor from the response to fetch the next page:
{ balances ( input : { walletAddress : "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" limit : 10 cursor : "eyJvZmZzZXQiOjEwfQ==" }) { items { tokenAddress shiftedBalance balanceUsd token { symbol } } cursor } }
Playground 
