> ## 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.
# balances
> Fetch token balances for a wallet address across networks, with pagination, sorting, and optional token metadata.
### 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](/api-reference/graphql/types/BalancesResponse) and [Balance](/api-reference/graphql/types/Balance) for full type details.
### Arguments
See [BalancesInput](/api-reference/graphql/types/BalancesInput) for full details.
### Example
```graphql theme={null}
{
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
}
}
```
### Pagination
Use the `cursor` from the response to fetch the next page:
```graphql theme={null}
{
balances(input: {
walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
limit: 10
cursor: "eyJvZmZzZXQiOjEwfQ=="
}) {
items {
tokenAddress
shiftedBalance
balanceUsd
token { symbol }
}
cursor
}
}
```
### Playground