> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polygon.technology/llms.txt
> Use this file to discover all available pages before exploring further.

# Kotlin SDK balances and history

> Query native balances, contract-token balances, and transaction history for any address.

`omsWallet.indexer` is read-only. It accepts any wallet address and does not require authentication, a completed wallet session, or the currently selected address.

Indexer methods are `suspend` functions. Amounts are raw base-unit strings.

## Query balances

Pass explicit networks when you know which chains to query:

```kotlin theme={null}
import technology.polygon.omswallet.Network

val result = omsWallet.indexer.getBalances(
    walletAddress = "0x1111111111111111111111111111111111111111",
    networks = listOf(Network.POLYGON),
)

result.nativeBalances.forEach { balance ->
    println("${balance.symbol}: ${balance.balance}")
}

result.balances.forEach { balance ->
    println("${balance.contractAddress}: ${balance.balance}")
}
```

`TokenBalancesResult` exposes native assets as `List<NativeTokenBalance>` and contract assets as `List<ContractTokenBalance>`. Contract balances include their contract address and token ID. Price, contract, and token metadata is nullable when unavailable. Use the [public API reference](/wallets/sdk/kotlin/api-reference) when you need every response field.

Use `formatUnits(balance.toBigInteger(), decimals)` with the token's actual decimals when presenting a balance. The helper removes trailing fractional zeros.

## Query transaction history

```kotlin theme={null}
import technology.polygon.omswallet.Network

val history = omsWallet.indexer.getTransactionHistory(
    walletAddress = "0x1111111111111111111111111111111111111111",
    networks = listOf(Network.POLYGON),
)

history.transactions.forEach { transaction ->
    println("${transaction.txnHash}: ${transaction.timestamp}")
}
```

`TransactionHistoryResult.transactions` is `List<Transaction>`. Each transaction includes its chain, hash, block position, timestamp, and transfers. The OMS transaction ID and transfer metadata are optional.

## Choose networks

When `networks` is non-empty, the SDK sends those chain IDs. When it is empty, `networkType` controls the group and defaults to `IndexerNetworkType.MAINNETS`.

```kotlin theme={null}
import technology.polygon.omswallet.models.IndexerNetworkType

val result = omsWallet.indexer.getBalances(
    walletAddress = "0x1111111111111111111111111111111111111111",
    networkType = IndexerNetworkType.ALL,
)
```

Use `MAINNETS`, `TESTNETS`, or `ALL`. See [Networks](/wallets/sdk/kotlin/networks-and-reference) for the explicit `Network` registry.

## Filter and paginate balances

Apply filters only after the basic query works:

```kotlin theme={null}
import technology.polygon.omswallet.Network
import technology.polygon.omswallet.models.ContractVerificationStatus
import technology.polygon.omswallet.models.TokenBalancesPageRequest

val result = omsWallet.indexer.getBalances(
    walletAddress = "0x1111111111111111111111111111111111111111",
    networks = listOf(Network.POLYGON),
    contractAddresses = listOf("0x2222222222222222222222222222222222222222"),
    contractStatus = ContractVerificationStatus.VERIFIED,
    includeMetadata = true,
    page = TokenBalancesPageRequest(page = 0, pageSize = 40),
)

if (result.page?.more == true) {
    val nextPage = result.page.page + 1
}
```

Balance queries can also filter by `tokenIds`, omit price data with `omitPrices`, or disable metadata with `includeMetadata = false`.

Increment the page number while `result.page?.more` is `true`.

## Filter transaction history

History filters include contract addresses, transaction hashes, OMS meta-transaction IDs, block range, and token ID:

```kotlin theme={null}
import technology.polygon.omswallet.Network
import technology.polygon.omswallet.models.TokenBalancesPageRequest

val history = omsWallet.indexer.getTransactionHistory(
    walletAddress = "0x1111111111111111111111111111111111111111",
    networks = listOf(Network.POLYGON),
    metaTransactionIds = listOf("txn-id-from-send-transaction"),
    fromBlock = 60_000_000,
    includeMetadata = false,
    page = TokenBalancesPageRequest(page = 0, pageSize = 40),
)
```

Use `metadataOptions` only when you need verified-only, unverified-only, or included-contract metadata behavior. It affects metadata enrichment, not the address being queried.