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}")
}

BalancesResult 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.balance.toBigInteger(), decimals) with the token’s actual decimals when presenting a balance. The helper removes trailing fractional zeros.

Query Solana balances

Use getSolanaBalances for native SOL and fungible SPL-token balances. Omitting networks queries both Solana Mainnet and Devnet.

import technology.polygon.omswallet.SolanaNetwork

val result = omsWallet.indexer.getSolanaBalances(
    walletAddress = "vn3YnndV3gGu7DrHSQAPfywmba7QPq18SvA7PSiytAV",
    networks = listOf(SolanaNetwork.Mainnet, SolanaNetwork.Devnet),
)

result.balances.forEach(::println)
result.errors.forEach { error ->
    println("${error.network}: ${error.reason}")
}

Filter fungible tokens with mintAddresses or excludedMintAddresses, and use omitNativeBalances when native SOL is not needed. Individual network failures appear in errors without discarding balances returned by another requested network.

Query Tron balances

Use getTronBalances for native TRX and TRC-20 token balances. walletAddress is a Base58Check address that starts with T. Omitting networks queries both Tron Mainnet and Nile.

import technology.polygon.omswallet.TronNetwork
import technology.polygon.omswallet.models.TronBalance

val result = omsWallet.indexer.getTronBalances(
    walletAddress = "TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL",
    networks = listOf(TronNetwork.Nile),
)

result.balances.forEach { balance ->
    when (balance) {
        is TronBalance.Native ->
            println("${balance.network} TRX: ${balance.formattedBalance}")
        is TronBalance.FungibleToken ->
            println("${balance.network} ${balance.symbol} (${balance.contractAddress}): ${balance.formattedBalance}")
    }
}
result.errors.forEach { error ->
    println("${error.network}: ${error.reason}")
}

Results have the same structure as Solana balances. Each TronBalance has a raw balance in base units (sun for TRX) and a formattedBalance. TRC-20 entries are TronBalance.FungibleToken values identified by tokenStandard and contractAddress. Filter tokens with contractAddresses or excludedContractAddresses, and use omitNativeBalances when native TRX is not needed. TRC-10 tokens are not supported. The SDK does not expose Solana or Tron transaction history. getTransactionHistory is for EVM networks.

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

val page = result.page
if (page != null && page.more) {
    val nextPage = 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.