Swift balances and history - Polygon Developer Docs

omsWallet.indexer is read-only. It accepts any wallet address and does not require authentication or an active wallet session.

Query balances

Choose explicit SDK networks for predictable scope.

let address = "0x1111111111111111111111111111111111111111"

let result = try await omsWallet.indexer.getBalances(
    GetBalancesParams(
        walletAddress: address,
        networks: [.polygon, .polygonAmoy]
    )
)

for balance in result.nativeBalances {
    print(balance.chainId, balance.symbol, balance.balance)
}

for balance in result.balances {
    print(balance.chainId, balance.contractAddress, balance.tokenId, balance.balance)
}

Amounts are raw base-unit strings. Use try formatUnits(value: balance.balance, decimals: decimals) with the token’s actual decimals for display. result.nativeBalances is [NativeTokenBalance]; result.balances is [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. includeMetadata defaults to true. Set it to false when you only need balance data.

Query transaction history

let history = try await omsWallet.indexer.getTransactionHistory(
    GetTransactionHistoryParams(
        walletAddress: address,
        networks: [.polygonAmoy]
    )
)

for transaction in history.transactions {
    print(transaction.txnHash)
    print(transaction.blockNumber, transaction.timestamp)

    for transfer in transaction.transfers {
        print(transfer.from, transfer.to, transfer.amounts)
    }
}

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

Set network scope

When networks is nonempty, the SDK sends those chain IDs and ignores networkType. When networks is omitted or empty, networkType defaults to .mainnets. Use .testnets or .all when you want a registry-wide group instead of explicit networks.

let result = try await omsWallet.indexer.getBalances(
    GetBalancesParams(
        walletAddress: address,
        networkType: .testnets,
        includeMetadata: false
    )
)

Filter results

Balance queries can filter by contract addresses, token IDs, and ContractVerificationStatus. History queries can filter by contract addresses, transaction hashes, OMS meta-transaction IDs, block range, and token ID.

let history = try await omsWallet.indexer.getTransactionHistory(
    GetTransactionHistoryParams(
        walletAddress: address,
        networks: [.polygon],
        contractAddresses: [
            "0x2222222222222222222222222222222222222222"
        ],
        fromBlock: 60_000_000,
        includeMetadata: false,
        omitPrices: true
    )
)

Empty filter arrays are omitted from the request.

Paginate

Requests default to page 0 with page size 40. Supply TokenBalancesPageRequest when your UI needs another page or cursor.

let result = try await omsWallet.indexer.getBalances(
    GetBalancesParams(
        walletAddress: address,
        networks: [.polygon],
        page: TokenBalancesPageRequest(
            page: 0,
            pageSize: 100
        )
    )
)

if result.page?.more == true {
    print("More balances are available")
}

Apply the same page request to transaction history when that result set needs pagination.

​Query balances

​Query transaction history

​Set network scope

​Filter results

​Paginate

Query balances

Query transaction history

Set network scope

Filter results

Paginate