React Native balances and history - Polygon Developer Docs

omsWallet.indexer is read-only and can query any address. It does not require authentication, an active wallet session, or the address selected by omsWallet.wallet.

Get balances for an address

Pass the address to query and one or more exported networks:

import {
  Networks,
  type BalancesResult,
} from '@0xsequence/oms-react-native-sdk'

const result: BalancesResult = await omsWallet.indexer.getBalances({
  walletAddress: '0x1111111111111111111111111111111111111111',
  networks: [Networks.polygon],
  includeMetadata: true,
})

for (const balance of result.nativeBalances) {
  console.log(balance.symbol, balance.balance)
}

for (const balance of result.balances) {
  console.log(balance.contractAddress, balance.tokenId, balance.balance)
}

Amounts such as balance are raw base-unit strings. Use formatUnits(balance.balance, decimals) with the token’s actual decimals for display. BalancesResult separates native assets into NativeTokenBalance[] and contract assets into ContractTokenBalance[]. Contract balances include their contract address and token ID. Price, contract, and token metadata is optional even when requested. Use the public API reference when you need every response field.

Get transaction history

import type {
  Transaction,
  TransactionHistoryResult,
} from '@0xsequence/oms-react-native-sdk'

const history: TransactionHistoryResult =
  await omsWallet.indexer.getTransactionHistory({
    walletAddress: '0x1111111111111111111111111111111111111111',
    networks: [Networks.polygon],
    includeMetadata: true,
  })

for (const transaction: Transaction of history.transactions) {
  console.log(transaction.txnHash, transaction.timestamp)
}

Each transaction includes its chain, hash, block position, timestamp, and transfers. The OMS transaction ID and transfer metadata are optional.

Filter queries

Use networks for explicit chains. When you omit it, use networkType to query 'MAINNETS', 'TESTNETS', or 'ALL' supported networks. Balance filters include contract addresses, token IDs, verification status, metadata inclusion, and price omission:

const result = await omsWallet.indexer.getBalances({
  walletAddress: '0x1111111111111111111111111111111111111111',
  networkType: 'MAINNETS',
  contractAddresses: ['0x2222222222222222222222222222222222222222'],
  contractStatus: 'VERIFIED',
  includeMetadata: true,
  omitPrices: true,
})

History filters include contract addresses, transaction hashes, wallet transaction IDs, block range, token ID, and metadata options:

const history = await omsWallet.indexer.getTransactionHistory({
  walletAddress: '0x1111111111111111111111111111111111111111',
  networks: [Networks.polygon],
  transactionHashes: ['0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'],
  fromBlock: 70000000,
  metadataOptions: {
    verifiedOnly: true,
    includeContracts: ['0x2222222222222222222222222222222222222222'],
  },
})

Paginate results

Both methods accept a page request:

const result = await omsWallet.indexer.getBalances({
  walletAddress: '0x1111111111111111111111111111111111111111',
  networks: [Networks.polygon],
  page: { page: 0, pageSize: 40 },
})

if (result.page?.more === true) {
  console.log('Next page:', result.page.page + 1)
}

Continue with the next page while result.page?.more is true.

​Get balances for an address

​Get transaction history

​Filter queries

​Paginate results

Get balances for an address

Get transaction history

Filter queries

Paginate results