React Native Balances & History - Polygon Developer Docs

Use oms.indexer to read balances and transaction history after creating OMSClient. Requests use the publishable key configured for the client, and token amounts are returned as raw base-unit strings. Pass explicit SDK OmsNetwork values with networks, or omit networks and use networkType. When both are omitted, networkType defaults to MAINNETS.

Get Balances

import { formatUnits } from '@0xsequence/oms-react-native-sdk'

const walletAddress = await oms.wallet.getWalletAddress()

if (!walletAddress) {
  throw new Error('No active wallet session')
}

const polygon = oms.supportedNetworks.find((network) => network.chainId === '137')

const result = await oms.indexer.getBalances({
  walletAddress,
  networks: polygon ? [polygon] : undefined,
  contractAddresses: ['0x2222222222222222222222222222222222222222'],
  includeMetadata: true,
})

for (const balance of result.nativeBalances) {
  console.log(balance.symbol, formatUnits(balance.balance ?? '0', 18))
}

for (const balance of result.balances) {
  const decimals = balance.contractInfo?.decimals ?? 18
  console.log(balance.contractAddress, formatUnits(balance.balance ?? '0', decimals))
}

Parameters

Parameter	Type	Description
`walletAddress`	`string`	Wallet address to inspect. This can be the active wallet or any wallet address.
`networks`	`OmsNetwork[]` or undefined	Explicit networks to query. Use values from `oms.supportedNetworks`.
`networkType`	`'MAINNETS'`, `'TESTNETS'`, `'ALL'`, or undefined	Network group to query when `networks` is omitted. Defaults to `MAINNETS`.
`contractAddresses`	`string[]` or undefined	Optional token contract addresses to query. Omit it to query balances across token contracts.
`includeMetadata`	`boolean` or undefined	Whether token metadata should be included in the response. Defaults to `true`.
`omitPrices`	`boolean`, `null`, or undefined	Whether price fields should be omitted.
`tokenIds`	`string[]` or undefined	Optional token IDs to filter by.
`contractStatus`	`'VERIFIED'`, `'UNVERIFIED'`, `'ALL'`, `null`, or undefined	Contract verification status filter.
`page.page`	`number` or undefined	Optional page number. Defaults to `0` when `page` is omitted.
`page.pageSize`	`number` or undefined	Optional page size. Defaults to the SDK response default when omitted.

Returns oms.indexer.getBalances returns Promise<OmsBalancesResult>.

Field	Type	Description
`status`	`number`	HTTP status code from the balance response.
`page`	`OmsTokenBalancesPage`, `null`, or undefined	Pagination metadata from the balance response.
`nativeBalances`	`OmsTokenBalance[]`	Native token balances returned for the wallet.
`balances`	`OmsTokenBalance[]`	Token contract balances returned for the wallet.

Get Transaction History

const walletAddress = await oms.wallet.getWalletAddress()

if (!walletAddress) {
  throw new Error('No active wallet session')
}

const amoy = oms.supportedNetworks.find((network) => network.chainId === '80002')

const result = await oms.indexer.getTransactionHistory({
  walletAddress,
  networks: amoy ? [amoy] : undefined,
  includeMetadata: true,
  page: {
    page: 0,
    pageSize: 25,
  },
})

for (const transaction of result.transactions) {
  console.log(transaction.txnHash, transaction.timestamp)
}

Parameters

Parameter	Type	Description
`walletAddress`	`string`	Wallet address to inspect. This can be the active wallet or any wallet address.
`networks`	`OmsNetwork[]` or undefined	Explicit networks to query. Use values from `oms.supportedNetworks`.
`networkType`	`'MAINNETS'`, `'TESTNETS'`, `'ALL'`, or undefined	Network group to query when `networks` is omitted. Defaults to `MAINNETS`.
`contractAddresses`	`string[]` or undefined	Optional token contract addresses to filter by.
`transactionHashes`	`string[]` or undefined	Optional on-chain transaction hashes to filter by.
`metaTransactionIds`	`string[]` or undefined	Optional wallet transaction ID filters, such as `txnId` returned by transaction APIs.
`fromBlock`	`number`, `null`, or undefined	Optional lower block number bound.
`toBlock`	`number`, `null`, or undefined	Optional upper block number bound.
`tokenId`	`string`, `null`, or undefined	Optional token ID filter.
`includeMetadata`	`boolean` or undefined	Whether token metadata should be included in the response. Defaults to `true`.
`omitPrices`	`boolean`, `null`, or undefined	Whether price fields should be omitted.
`metadataOptions.verifiedOnly`	`boolean` or undefined	Include metadata only for verified contracts.
`metadataOptions.unverifiedOnly`	`boolean` or undefined	Include metadata only for unverified contracts.
`metadataOptions.includeContracts`	`string[]` or undefined	Contract addresses for metadata inclusion.
`page.page`	`number` or undefined	Optional page number. Defaults to `0` when `page` is omitted.
`page.pageSize`	`number` or undefined	Optional page size. Defaults to the SDK response default when omitted.

Returns oms.indexer.getTransactionHistory returns Promise<OmsTransactionHistoryResult>.

Field	Type	Description
`status`	`number`	HTTP status code from the transaction-history response.
`page`	`OmsTokenBalancesPage`, `null`, or undefined	Pagination metadata from the transaction-history response.
`transactions`	`OmsTransaction[]`	Transactions returned for the wallet.

Token Balance Shape

Each OmsTokenBalance can include:

Field	Type	Description
`contractType`	`string` or `null`	Token contract type, such as ERC20, ERC721, or `NATIVE`.
`contractAddress`	`string` or `null`	Token contract address. Native token balances do not include a contract address.
`accountAddress`	`string` or `null`	Wallet address queried.
`tokenId`	`string` or `null`	Token ID for token types that use IDs.
`name`	`string`, `null`, or undefined	Token name.
`symbol`	`string`, `null`, or undefined	Token symbol.
`balance`	`string` or `null`	Raw base-unit balance as a string.
`balanceUSD`	`string`, `null`, or undefined	Balance value in USD when prices are included.
`priceUSD`	`string`, `null`, or undefined	Token price in USD when prices are included.
`priceUpdatedAt`	`string`, `null`, or undefined	Timestamp for the price.
`blockHash`	`string` or `null`	Block hash for the balance snapshot.
`blockNumber`	`number`, `null`, or undefined	Block number for the balance snapshot.
`chainId`	`number`, `null`, or undefined	Numeric chain ID.
`uniqueCollectibles`	`string`, `null`, or undefined	Unique collectible count for NFT summary rows.
`isSummary`	`boolean`, `null`, or undefined	Whether the row summarizes a set of balances.
`contractInfo`	`OmsTokenContractInfo`, `null`, or undefined	Token contract metadata when requested and available.
`tokenMetadata`	`OmsTokenMetadata`, `null`, or undefined	Token metadata when requested and available.

Transaction Shape

Each OmsTransaction can include:

Field	Type	Description
`txnHash`	`string` or `null`	On-chain transaction hash.
`blockNumber`	`number` or `null`	Block number.
`blockHash`	`string` or `null`	Block hash.
`chainId`	`number` or `null`	Numeric chain ID.
`metaTxnId`	`string`, `null`, or undefined	Wallet transaction ID when available.
`transfers`	`OmsTransactionTransfer[]`, `null`, or undefined	Token transfers included in the transaction.
`timestamp`	`string`, `null`, or undefined	Transaction timestamp.

​Get Balances

​Get Transaction History

​Token Balance Shape

​Transaction Shape

Get Balances

Get Transaction History

Token Balance Shape

Transaction Shape