Official Documentation
HomeDashboardHave I been Frontrun? App
  • πŸ”­Welcome
  • πŸ’³Pricing Plans
  • πŸ†“Public RPC Endpoints
  • πŸ—ΊοΈGuides
    • πŸ†˜Getting support
    • πŸƒβ€β™‚οΈRunning a Node
    • πŸ–‡οΈHow to add OMNIA Endpoints to wallet
  • πŸ“ˆDeFi
    • πŸ“–Features Overview
    • πŸ—„οΈWallet Integration
    • πŸ’ΈMEV Cashback
    • πŸ›‘οΈFrontrunning Protection
    • πŸ› οΈReinforced Transactions
    • 🍯Honeypot Protection
    • 🚦Token Approval Protection
    • πŸ”Security Policy
    • ⚠️Comprehensive Security Event Detection (Notifications)
    • πŸ”ŽHave I been Frontrunned Tool
    • βš›οΈAtomic Transaction
  • πŸ“–RPC API docs
    • ⛓️Chains
      • Bitcoin
      • Ethereum
        • Custom JSON-RPC API
          • omnia_getAssetBalance
          • omnia_checkTokenSecurity
          • omnia_checkApproval
          • omnia_checkNFTSecurity
          • omnia_checkAddress
          • omnia_checkRugPull
          • omnia_checkPhishingSite
          • omnia_checkDappSecurity
          • omnia_decodeTransaction
          • omnia_disperse
          • omnia_getTokenPrice
        • Standard JSON-RPC API
          • eth_accounts
          • eth_blockNumber
          • eth_call
          • eth_chainId
          • eth_estimateGas
          • eth_feeHistory
          • eth_gasPrice
          • eth_getBalance
          • eth_getBlockByHash
          • eth_getBlockByNumber
          • eth_getBlockTransactionCountByHash
          • eth_getBlockTransactionCountByNumber
          • eth_getCode
          • eth_getFilterChanges
          • eth_getFilterLogs
          • eth_getLogs
          • eth_getProof
          • eth_getStorageAt
          • eth_getTransactionByBlockHashAndIndex
          • eth_getTransactionByBlockNumberAndIndex
          • eth_getTransactionByHash
          • eth_getTransactionCount
          • eth_getTransactionReceipt
          • eth_getUncleCountByBlockHash
          • eth_getUncleCountByBlockNumber
          • eth_maxPriorityFeePerGas
          • eth_newBlockFilter
          • eth_newFilter
          • eth_newPendingTransactionFilter
          • eth_uninstallFilter
          • eth_sendRawTransaction
          • net_listening
          • net_peerCount
          • net_version
          • web3_sha3
          • web3_clientVersion
      • Avalanche (C-Chain)
        • Ethereum Standard JSON-RPC API
          • eth_accounts
          • eth_blockNumber
          • eth_call
          • eth_chainId
          • eth_estimateGas
          • eth_feeHistory
          • eth_gasPrice
          • eth_getBalance
          • eth_getBlockByHash
          • eth_getBlockByNumber
          • eth_getBlockTransactionCountByHash
          • eth_getBlockTransactionCountByNumber
          • eth_getCode
          • eth_getFilterChanges
          • eth_getFilterLogs
          • eth_getLogs
          • eth_getProof
          • eth_getStorageAt
          • eth_getTransactionByBlockHashAndIndex
          • eth_getTransactionByBlockNumberAndIndex
          • eth_getTransactionByHash
          • eth_getTransactionCount
          • eth_getTransactionReceipt
          • eth_getUncleCountByBlockHash
          • eth_getUncleCountByBlockNumber
          • eth_maxPriorityFeePerGas
          • eth_newBlockFilter
          • eth_newFilter
          • eth_newPendingTransactionFilter
          • eth_uninstallFilter
          • eth_sendRawTransaction
          • net_listening
          • net_peerCount
          • net_version
          • web3_sha3
          • web3_clientVersion
        • Avalanche Specific API
        • Custom JSON-RPC API
          • omnia_getAssetBalance
          • omnia_checkTokenSecurity
          • omnia_checkApproval
          • omnia_checkNFTSecurity
          • omnia_checkAddress
          • omnia_checkPhishingSite
          • omnia_checkDappSecurity
          • omnia_decodeTransaction
          • omnia_disperse
          • omnia_getTokenPrice
      • Binance Smart Chain
        • Standard JSON-RPC API
          • eth_accounts
          • eth_blockNumber
          • eth_call
          • eth_chainId
          • eth_estimateGas
          • eth_feeHistory
          • eth_gasPrice
          • eth_getBalance
          • eth_getBlockByHash
          • eth_getBlockByNumber
          • eth_getBlockTransactionCountByHash
          • eth_getBlockTransactionCountByNumber
          • eth_getCode
          • eth_getFilterChanges
          • eth_getFilterLogs
          • eth_getLogs
          • eth_getProof
          • eth_getStorageAt
          • eth_getTransactionByBlockHashAndIndex
          • eth_getTransactionByBlockNumberAndIndex
          • eth_getTransactionByHash
          • eth_getTransactionCount
          • eth_getTransactionReceipt
          • eth_getUncleCountByBlockHash
          • eth_getUncleCountByBlockNumber
          • eth_maxPriorityFeePerGas
          • eth_newBlockFilter
          • eth_newFilter
          • eth_newPendingTransactionFilter
          • eth_uninstallFilter
          • eth_sendRawTransaction
          • net_listening
          • net_peerCount
          • net_version
          • web3_sha3
          • web3_clientVersion
        • Custom JSON-RPC API
          • omnia_getAssetBalance
          • omnia_checkTokenSecurity
          • omnia_checkApproval
          • omnia_checkNFTSecurity
          • omnia_checkAddress
          • omnia_checkRugPull
          • omnia_checkPhishingSite
          • omnia_checkDappSecurity
          • omnia_decodeTransaction
          • omnia_disperse
          • omnia_getTokenPrice
      • Polygon
        • Polygon Standard JSON-RPC API
          • bor_getAuthor
          • bor_getCurrentProposer
          • bor_getCurrentValidators
          • bor_getRootHash
          • bor_getSignersAtHash
          • eth_getRootHash
        • Ethereum Standard JSON-RPC API
          • eth_accounts
          • eth_blockNumber
          • eth_call
          • eth_chainId
          • eth_estimateGas
          • eth_feeHistory
          • eth_gasPrice
          • eth_getBalance
          • eth_getBlockByHash
          • eth_getBlockByNumber
          • eth_getBlockTransactionCountByHash
          • eth_getBlockTransactionCountByNumber
          • eth_getCode
          • eth_getFilterChanges
          • eth_getFilterLogs
          • eth_getLogs
          • eth_getProof
          • eth_getStorageAt
          • eth_getTransactionByBlockHashAndIndex
          • eth_getTransactionByBlockNumberAndIndex
          • eth_getTransactionByHash
          • eth_getTransactionCount
          • eth_getTransactionReceipt
          • eth_getUncleCountByBlockHash
          • eth_getUncleCountByBlockNumber
          • eth_maxPriorityFeePerGas
          • eth_newBlockFilter
          • eth_newFilter
          • eth_newPendingTransactionFilter
          • eth_uninstallFilter
          • eth_sendRawTransaction
          • net_listening
          • net_peerCount
          • net_version
          • web3_sha3
          • web3_clientVersion
        • Custom JSON-RPC API
          • omnia_getAssetBalance
          • omnia_checkTokenSecurity
          • omnia_checkApproval
          • omnia_checkNFTSecurity
          • omnia_checkAddress
          • omnia_checkPhishingSite
          • omnia_checkDappSecurity
          • omnia_decodeTransaction
          • omnia_disperse
          • omnia_getTokenPrice
      • Arbitrum
        • Standard JSON-RPC API
          • eth_accounts
          • eth_blockNumber
          • eth_call
          • eth_chainId
          • eth_estimateGas
          • eth_feeHistory
          • eth_gasPrice
          • eth_getBalance
          • eth_getBlockByHash
          • eth_getBlockByNumber
          • eth_getBlockTransactionCountByHash
          • eth_getBlockTransactionCountByNumber
          • eth_getCode
          • eth_getFilterChanges
          • eth_getFilterLogs
          • eth_getLogs
          • eth_getProof
          • eth_getStorageAt
          • eth_getTransactionByBlockHashAndIndex
          • eth_getTransactionByBlockNumberAndIndex
          • eth_getTransactionByHash
          • eth_getTransactionCount
          • eth_getTransactionReceipt
          • eth_getUncleCountByBlockHash
          • eth_getUncleCountByBlockNumber
          • eth_maxPriorityFeePerGas
          • eth_newBlockFilter
          • eth_newFilter
          • eth_newPendingTransactionFilter
          • eth_uninstallFilter
          • eth_sendRawTransaction
          • net_listening
          • net_peerCount
          • net_version
          • web3_sha3
          • web3_clientVersion
        • Custom JSON-RPC API
          • omnia_getAssetBalance
          • omnia_checkTokenSecurity
          • omnia_checkApproval
          • omnia_checkAddress
          • omnia_checkPhishingSite
          • omnia_checkDappSecurity
          • omnia_decodeTransaction
          • omnia_disperse
          • omnia_getTokenPrice
      • Aurora
        • Standard JSON-RPC API
          • eth_accounts
          • eth_blockNumber
          • eth_call
          • eth_chainId
          • eth_estimateGas
          • eth_feeHistory
          • eth_gasPrice
          • eth_getBalance
          • eth_getBlockByHash
          • eth_getBlockByNumber
          • eth_getBlockTransactionCountByHash
          • eth_getBlockTransactionCountByNumber
          • eth_getCode
          • eth_getFilterChanges
          • eth_getFilterLogs
          • eth_getLogs
          • eth_getProof
          • eth_getStorageAt
          • eth_getTransactionByBlockHashAndIndex
          • eth_getTransactionByBlockNumberAndIndex
          • eth_getTransactionByHash
          • eth_getTransactionCount
          • eth_getTransactionReceipt
          • eth_getUncleCountByBlockHash
          • eth_getUncleCountByBlockNumber
          • eth_maxPriorityFeePerGas
          • eth_newBlockFilter
          • eth_newFilter
          • eth_newPendingTransactionFilter
          • eth_uninstallFilter
          • eth_sendRawTransaction
          • net_listening
          • net_peerCount
          • net_version
          • web3_sha3
          • web3_clientVersion
      • Optimism
        • Standard JSON-RPC API
          • eth_accounts
          • eth_blockNumber
          • eth_call
          • eth_chainId
          • eth_estimateGas
          • eth_feeHistory
          • eth_gasPrice
          • eth_getBalance
          • eth_getBlockByHash
          • eth_getBlockByNumber
          • eth_getBlockTransactionCountByHash
          • eth_getBlockTransactionCountByNumber
          • eth_getCode
          • eth_getFilterChanges
          • eth_getFilterLogs
          • eth_getLogs
          • eth_getProof
          • eth_getStorageAt
          • eth_getTransactionByBlockHashAndIndex
          • eth_getTransactionByBlockNumberAndIndex
          • eth_getTransactionByHash
          • eth_getTransactionCount
          • eth_getTransactionReceipt
          • eth_getUncleCountByBlockHash
          • eth_getUncleCountByBlockNumber
          • eth_maxPriorityFeePerGas
          • eth_newBlockFilter
          • eth_newFilter
          • eth_newPendingTransactionFilter
          • eth_uninstallFilter
          • eth_sendRawTransaction
          • net_listening
          • net_peerCount
          • net_version
          • web3_sha3
          • web3_clientVersion
        • Custom JSON-RPC API
          • omnia_getAssetBalance
          • omnia_checkTokenSecurity
          • omnia_checkApproval
          • omnia_checkNFTSecurity
          • omnia_checkAddress
          • omnia_checkPhishingSite
          • omnia_checkDappSecurity
          • omnia_decodeTransaction
          • omnia_disperse
          • omnia_getTokenPrice
      • Fantom
        • Fantom Standard JSON-RPC API
          • ftm_currentEpoch
        • Ethereum Standard JSON-RPC API
          • eth_accounts
          • eth_blockNumber
          • eth_call
          • eth_chainId
          • eth_estimateGas
          • eth_feeHistory
          • eth_gasPrice
          • eth_getBalance
          • eth_getBlockByHash
          • eth_getBlockByNumber
          • eth_getBlockTransactionCountByHash
          • eth_getBlockTransactionCountByNumber
          • eth_getCode
          • eth_getFilterChanges
          • eth_getFilterLogs
          • eth_getLogs
          • eth_getProof
          • eth_getStorageAt
          • eth_getTransactionByBlockHashAndIndex
          • eth_getTransactionByBlockNumberAndIndex
          • eth_getTransactionByHash
          • eth_getTransactionCount
          • eth_getTransactionReceipt
          • eth_getUncleCountByBlockHash
          • eth_getUncleCountByBlockNumber
          • eth_maxPriorityFeePerGas
          • eth_newBlockFilter
          • eth_newFilter
          • eth_newPendingTransactionFilter
          • eth_uninstallFilter
          • eth_sendRawTransaction
          • net_listening
          • net_peerCount
          • net_version
          • web3_sha3
          • web3_clientVersion
        • Custom JSON-RPC API
          • omnia_getAssetBalance
          • omnia_checkTokenSecurity
          • omnia_checkApproval
          • omnia_checkAddress
          • omnia_checkPhishingSite
          • omnia_checkDappSecurity
          • omnia_decodeTransaction
          • omnia_disperse
          • omnia_getTokenPrice
      • Gnosis
        • Standard JSON-RPC API
          • eth_accounts
          • eth_blockNumber
          • eth_call
          • eth_chainId
          • eth_estimateGas
          • eth_feeHistory
          • eth_gasPrice
          • eth_getBalance
          • eth_getBlockByHash
          • eth_getBlockByNumber
          • eth_getBlockTransactionCountByHash
          • eth_getBlockTransactionCountByNumber
          • eth_getCode
          • eth_getFilterChanges
          • eth_getFilterLogs
          • eth_getLogs
          • eth_getProof
          • eth_getStorageAt
          • eth_getTransactionByBlockHashAndIndex
          • eth_getTransactionByBlockNumberAndIndex
          • eth_getTransactionByHash
          • eth_getTransactionCount
          • eth_getTransactionReceipt
          • eth_getUncleCountByBlockHash
          • eth_getUncleCountByBlockNumber
          • eth_maxPriorityFeePerGas
          • eth_newBlockFilter
          • eth_newFilter
          • eth_newPendingTransactionFilter
          • eth_uninstallFilter
          • eth_sendRawTransaction
          • net_listening
          • net_peerCount
          • net_version
          • web3_sha3
          • web3_clientVersion
        • Custom JSON-RPC API
          • omnia_checkTokenSecurity
          • omnia_checkApproval
          • omnia_checkAddress
          • omnia_checkPhishingSite
          • omnia_checkDappSecurity
          • omnia_disperse
          • omnia_getTokenPrice
      • Base
        • Custom JSON-RPC API
          • omnia_disperse
          • omnia_getTokenPrice
        • Standard JSON-RPC API
          • eth_accounts
          • eth_blockNumber
          • eth_call
          • eth_chainId
          • eth_estimateGas
          • eth_feeHistory
          • eth_gasPrice
          • eth_getBalance
          • eth_getBlockByHash
          • eth_getBlockByNumber
          • eth_getBlockTransactionCountByHash
          • eth_getBlockTransactionCountByNumber
          • eth_getCode
          • eth_getFilterChanges
          • eth_getFilterLogs
          • eth_getLogs
          • eth_getProof
          • eth_getStorageAt
          • eth_getTransactionByBlockHashAndIndex
          • eth_getTransactionByBlockNumberAndIndex
          • eth_getTransactionByHash
          • eth_getTransactionCount
          • eth_getTransactionReceipt
          • eth_getUncleCountByBlockHash
          • eth_getUncleCountByBlockNumber
          • eth_maxPriorityFeePerGas
          • eth_newBlockFilter
          • eth_newFilter
          • eth_newPendingTransactionFilter
          • eth_uninstallFilter
          • eth_sendRawTransaction
          • net_listening
          • net_peerCount
          • net_version
          • web3_sha3
          • web3_clientVersion
      • Harmony
        • Ethereum Standard JSON-RPC API
          • eth_accounts
          • eth_blockNumber
          • eth_call
          • eth_chainId
          • eth_estimateGas
          • eth_feeHistory
          • eth_gasPrice
          • eth_getBalance
          • eth_getBlockByHash
          • eth_getBlockByNumber
          • eth_getBlockTransactionCountByHash
          • eth_getBlockTransactionCountByNumber
          • eth_getCode
          • eth_getFilterChanges
          • eth_getFilterLogs
          • eth_getLogs
          • eth_getProof
          • eth_getStorageAt
          • eth_getTransactionByBlockHashAndIndex
          • eth_getTransactionByBlockNumberAndIndex
          • eth_getTransactionByHash
          • eth_getTransactionCount
          • eth_getTransactionReceipt
          • eth_getUncleCountByBlockHash
          • eth_getUncleCountByBlockNumber
          • eth_maxPriorityFeePerGas
          • eth_newBlockFilter
          • eth_newFilter
          • eth_newPendingTransactionFilter
          • eth_uninstallFilter
          • eth_sendRawTransaction
          • net_listening
          • net_peerCount
          • net_version
          • web3_sha3
          • web3_clientVersion
        • Harmony Specific API
      • Moonbeam
        • Ethereum Standard JSON-RPC API
          • eth_accounts
          • eth_blockNumber
          • eth_call
          • eth_chainId
          • eth_estimateGas
          • eth_feeHistory
          • eth_gasPrice
          • eth_getBalance
          • eth_getBlockByHash
          • eth_getBlockByNumber
          • eth_getBlockTransactionCountByHash
          • eth_getBlockTransactionCountByNumber
          • eth_getCode
          • eth_getFilterChanges
          • eth_getFilterLogs
          • eth_getLogs
          • eth_getProof
          • eth_getStorageAt
          • eth_getTransactionByBlockHashAndIndex
          • eth_getTransactionByBlockNumberAndIndex
          • eth_getTransactionByHash
          • eth_getTransactionCount
          • eth_getTransactionReceipt
          • eth_getUncleCountByBlockHash
          • eth_getUncleCountByBlockNumber
          • eth_maxPriorityFeePerGas
          • eth_newBlockFilter
          • eth_newFilter
          • eth_newPendingTransactionFilter
          • eth_uninstallFilter
          • eth_sendRawTransaction
          • net_listening
          • net_peerCount
          • net_version
          • web3_sha3
          • web3_clientVersion
        • Moonbeam Specific API
        • Custom JSON-RPC API
          • omnia_disperse
          • omnia_getTokenPrice
      • NEAR
        • Standard JSON-RPC API
      • Cosmos
        • Standard REST API
      • Solana
        • Standard JSON-RPC API
    • ⏩Custom RPC
      • omnia_getAssetBalance
      • omnia_disperse
      • omnia_getTokenPrice
      • omnia_checkTokenSecurity
      • omnia_checkNFTSecurity
      • omnia_checkApproval
      • omnia_checkAddress
      • omnia_checkRugPull
      • omnia_checkPhishingSite
      • omnia_checkDappSecurity
      • omnia_decodeTransaction
Powered by GitBook
On this page
  1. RPC API docs
  2. Chains
  3. Optimism
  4. Custom JSON-RPC API

omnia_getAssetBalance

Returns a list of assets owned by the wallet, including token details and current balance. Receives up to 100 contract addresses used to check the balance of the wallet. If no contract addresses are provided, it will use OMNIA's list of most used contracts per chain.

Parameters

  1. DATA, 20 Bytes - wallet. The wallet address that is checked for it's holdings. REQUIRED

  2. Array of DATA, 20 Bytes - contracts. The contract addresses of the tokens for which the wallet is checked.

Beta version note: The feature of not providing a contracts and relying solely on OMNIA's token contracts collection is still in beta, so you might experience some Internal Server Error responses. To avoid that, until the stable version is released, we recommend explicitly specifying token contract addresses in the paramsfield of the request body.

Returns

Array - assets. Token holdings of the wallet address. Only tokens for which the balance is > 0 are returned.

Example

Request

curl --request POST \
     --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "omnia_getAssetBalance",
    "params": [
        {
            "wallet": "0xbBa591C7C9e8460B3EA2b6A9d8980b0237Fd42eC",
            "contracts": [
                "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "0x4d224452801ACEd8B2F0aebE155379bb5D594381"
            ]
        }
    ]
}
'

Response

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "wallet": "0xbBa591C7C9e8460B3EA2b6A9d8980b0237Fd42eC",
        "assets": [
            {
                "token": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "balance": "1184434877401855",
                "symbol": "WETH",
                "decimals": 18
            },
            {
                "token": "0x4d224452801ACEd8B2F0aebE155379bb5D594381",
                "balance": "8990163329569654507",
                "symbol": "APE",
                "decimals": 18
            }
        ]
    }
}
PreviousCustom JSON-RPC APINextomnia_checkTokenSecurity

Last updated 1 year ago

πŸ“–
⛓️