Kotlin SDK balances and history - Polygon Developer Docs

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:

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 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

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.

import technology.polygon.omswallet.models.IndexerNetworkType

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

Use MAINNETS, TESTNETS, or ALL. See Networks for the explicit Network registry.

Filter and paginate balances

Apply filters only after the basic query works:

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:

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.

​Query balances

​Query transaction history

​Choose networks

​Filter and paginate balances

​Filter transaction history

Query balances

Query transaction history

Choose networks

Filter and paginate balances

Filter transaction history