the strings representing the addresses to check for balance, separated by , commas.
up to 20 addresses per call
| | {% endtab %} | | {% tab title="Response" %} Sample response ``` { "status":"1", "message":"OK", "result":[ { "account":"0x3f349bBaFEc1551819B8be1EfEA2fC46cA749aA1", "balance":"37700000000000001" }, { "account":"0x4bF01a5A576bE1254C5E19fbE5EB195D6cFBeBdD", "balance":"4999777740000000000" }, { "account":"0x70F657164e5b75689b64B7fd1fA275F334f28e18", "balance":"57443177693229716" } ] } ``` {% hint style="info" %} 📖 **Tip:** The `result` is returned in [**wei.**](https://ibvmscan.io/unitconverter) Convert BNB units using our [**Unit Converter.**](https://ibvmscan.io/unitconverter) {% endhint %} {% endtab %} {% endtabs %} ## Get a list of 'Normal' Transactions By Address Returns the list of transactions performed by an address, with optional pagination. {% hint style="info" %} **** 📝 **Note :** This API endpoint returns a maximum of **10000 records** only. {% endhint %} ``` https://api.ibvmscan.io/api ?module=account &action=txlist &address=0xF426a8d0A94bf039A35CEE66dBf0227A7a12D11e &startblock=0 &endblock=99999999 &page=1 &offset=10 &sort=asc &apikey=YourApiKeyToken ``` > Try this endpoint in your [**browser**](https://api.ibvmscan.io/api?module=account\&action=txlist\&address=0xF426a8d0A94bf039A35CEE66dBf0227A7a12D11e\&startblock=0\&endblock=99999999\&page=1\&offset=10\&sort=asc\&apikey=YourApiKeyToken) 🔗 {% tabs %} {% tab title="Request" %} Query Parameters | Parameter | Description | | ---------- | --------------------------------------------------------------------------------------- | | address | the `string` representing the addresses to check for balance | | startblock | the `integer` block number to start searching for transactions | | endblock | the `integer` block number to stop searching for transactions | | page | the `integer` page number, if pagination is enabled | | offset | the number of transactions displayed per page | | sort | the sorting preference, use `asc` to sort by ascending and `desc` to sort by descending | {% hint style="info" %} 💡 **Tip:** Specify a smaller `startblock` and `endblock` range for faster search results. {% endhint %} {% endtab %} {% tab title="Response" %} Sample response ``` { "status":"1", "message":"OK", "result":[ { "blockNumber":"10475175", "timeStamp":"1630314219", "hash":"0x9c12ea64ffe659114e1404509ae82d52ca8b785851ef99405d31a6b65fb4d0a2", "nonce":"851069", "blockHash":"0x52754e796549fe9ab7a4550e0f7d8286fdc8efcac185aad7e7c63ff7c0fb1e5a", "transactionIndex":"22", "from":"0x161ba15a5f335c9f06bb5bbb0a9ce14076fbb645", "to":"0xf426a8d0a94bf039a35cee66dbf0227a7a12d11e", "value":"90541060000000000", "gas":"207128", "gasPrice":"10000000000", "isError":"0", "txreceipt_status":"1", "input":"0x", "contractAddress":"", "cumulativeGasUsed":"894108", "gasUsed":"21000", "confirmations":"2362" }, { "blockNumber":"10477535", "timeStamp":"1630321300", "hash":"0xf95f98ec21315ce7b397be1911719c9b3ab0e9386a34103e052ab36e41e9dc3f", "nonce":"3", "blockHash":"0xaa8e7de4eaced07d438438dfab90c84fea2e270f50a71418a89c87852d2b2a2a", "transactionIndex":"253", "from":"0xf426a8d0a94bf039a35cee66dbf0227a7a12d11e", "to":"0x10ed43c718714eb63d5aa57b78b54704e256024e", "value":"0", "gas":"254285", "gasPrice":"5000000000", "isError":"0", "txreceipt_status":"1", "input":"0x38ed173900000000000000000000000000000000000000000000000805e99fdcc5d000000000000000000000000000000000000000000000000000976181709dbde2904900000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000f426a8d0a94bf039a35cee66dbf0227a7a12d11e00000000000000000000000000000000000000000000000000000000612e1ec5000000000000000000000000000000000000000000000000000000000000000300000000000000000000000055d398326f99059ff775485246999027b3197955000000000000000000000000bb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c0000000000000000000000002d5c9167fdd5c068c8fcb8992e6af639b42fbf70", "contractAddress":"", "cumulativeGasUsed":"45034490", "gasUsed":"199442", "confirmations":"2" } ] } ``` {% endtab %} {% endtabs %} ## Get a list of 'Internal' Transactions by Address Returns the list of internal transactions performed by an address, with optional pagination. {% hint style="info" %} 📝 **Note :** This API endpoint returns a maximum of **10000 records** only. {% endhint %} ``` https://api.ibvmscan.io/api ?module=account &action=txlistinternal &address=0x0000000000000000000000000000000000001004 &startblock=0 &endblock=2702578 &page=1 &offset=10 &sort=asc &apikey=YourApiKeyToken ``` > Try this endpoint in your [**browser**](https://api.bscscan.com/api?module=account\&action=txlistinternal\&address=0x0000000000000000000000000000000000001004\&startblock=0\&endblock=2702578\&page=1\&offset=10\&sort=asc\&apikey=YourApiKeyToken) 🔗 {% tabs %} {% tab title="Request" %} Query Parameters | Parameter | Description | | ---------- | --------------------------------------------------------------------------------------- | | address | the `string` representing the addresses to check for balance | | startblock | the `integer` block number to start searching for transactions | | endblock | the `integer` block number to stop searching for transactions | | page | the `integer` page number, if pagination is enabled | | offset | the number of transactions displayed per page | | sort | the sorting preference, use `asc` to sort by ascending and `desc` to sort by descending | {% hint style="info" %} 💡 **Tip:** Specify a smaller `startblock` and `endblock` range for faster search results. {% endhint %} {% endtab %} {% tab title="Response" %} Sample response ``` { "status":"1", "message":"OK", "result":[ { "blockNumber":"10475175", "timeStamp":"1630314219", "hash":"0x9c12ea64ffe659114e1404509ae82d52ca8b785851ef99405d31a6b65fb4d0a2", "nonce":"851069", "blockHash":"0x52754e796549fe9ab7a4550e0f7d8286fdc8efcac185aad7e7c63ff7c0fb1e5a", "transactionIndex":"22", "from":"0x161ba15a5f335c9f06bb5bbb0a9ce14076fbb645", "to":"0xf426a8d0a94bf039a35cee66dbf0227a7a12d11e", "value":"90541060000000000", "gas":"207128", "gasPrice":"10000000000", "isError":"0", "txreceipt_status":"1", "input":"0x", "contractAddress":"", "cumulativeGasUsed":"894108", "gasUsed":"21000", "confirmations":"2362" }, { "blockNumber":"10477535", "timeStamp":"1630321300", "hash":"0xf95f98ec21315ce7b397be1911719c9b3ab0e9386a34103e052ab36e41e9dc3f", "nonce":"3", "blockHash":"0xaa8e7de4eaced07d438438dfab90c84fea2e270f50a71418a89c87852d2b2a2a", "transactionIndex":"253", "from":"0xf426a8d0a94bf039a35cee66dbf0227a7a12d11e", "to":"0x10ed43c718714eb63d5aa57b78b54704e256024e", "value":"0", "gas":"254285", "gasPrice":"5000000000", "isError":"0", "txreceipt_status":"1", "input":"0x38ed173900000000000000000000000000000000000000000000000805e99fdcc5d000000000000000000000000000000000000000000000000000976181709dbde2904900000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000f426a8d0a94bf039a35cee66dbf0227a7a12d11e00000000000000000000000000000000000000000000000000000000612e1ec5000000000000000000000000000000000000000000000000000000000000000300000000000000000000000055d398326f99059ff775485246999027b3197955000000000000000000000000bb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c0000000000000000000000002d5c9167fdd5c068c8fcb8992e6af639b42fbf70", "contractAddress":"", "cumulativeGasUsed":"45034490", "gasUsed":"199442", "confirmations":"2" } ] } ``` {% endtab %} {% endtabs %} ## Get 'Internal Transactions' by Transaction Hash Returns the list of internal transactions performed within a transaction. {% hint style="info" %} 📝 **Note :** This API endpoint returns a maximum of **10000 records** only. {% endhint %} ``` https://api.ibvmscan.io/api ?module=account &action=txlistinternal &txhash=0x4d74a6fc84d57f18b8e1dfa07ee517c4feb296d16a8353ee41adc03669982028 &apikey=YourApiKeyToken ``` > Try this endpoint in your [**browser**](https://api.bscscan.com/api?module=account\&action=txlistinternal\&txhash=0x4d74a6fc84d57f18b8e1dfa07ee517c4feb296d16a8353ee41adc03669982028\&apikey=YourApiKeyToken) 🔗 {% tabs %} {% tab title="Request" %} Query Parameters | Parameter | Description | | ------------ | --------------------------------------------------------------------------------- | | txhash | the `string` representing the transaction hash to check for internal transactions | | {% endtab %} | | {% tab title="Response" %} Sample response ``` { "status":"1", "message":"OK", "result":[ { "blockNumber":"958", "timeStamp":"1598674477", "from":"0x0000000000000000000000000000000000001004", "to":"0x4e656459ed25bf986eea1196bc1b00665401645d", "value":"100000000000000", "contractAddress":"", "input":"", "type":"call", "gas":"12300", "gasUsed":"0", "isError":"0", "errCode":"" }, { "blockNumber":"958", "timeStamp":"1598674477", "from":"0x0000000000000000000000000000000000001004", "to":"0x0000000000000000000000000000000000001005", "value":"1000000000000000", "contractAddress":"", "input":"", "type":"call", "gas":"2300", "gasUsed":"55", "isError":"0", "errCode":"" } ] } ``` {% hint style="info" %} The `isError` field returns `0` for **successful transactions** and `1` for **rejected/cancelled transactions.** {% endhint %} {% endtab %} {% endtabs %} ## Get "Internal Transactions" by Block Range Returns the list of internal transactions performed within a block range, with optional pagination. 📝 **Note :** This API endpoint returns a maximum of **10000 records** only. ``` https://api.ibvmscan.io/api ?module=account &action=txlistinternal &startblock=0 &endblock=2702578 &page=1 &offset=10 &sort=asc &apikey=YourApiKeyToken ``` > Try this endpoint in your [**browser**](https://api.bscscan.com/api?module=account\&action=txlistinternal\&startblock=0\&endblock=2702578\&page=1\&offset=10\&sort=asc\&apikey=YourApiKeyToken) 🔗 {% tabs %} {% tab title="Request" %} Query Parameters | Parameter | Description | | ------------ | --------------------------------------------------------------------------------------- | | address | the `string` representing the addresses to check for balance | | startblock | the `integer` block number to start searching for transactions | | endblock | the `integer` block number to stop searching for transactions | | page | the `integer` page number, if pagination is enabled | | offset | the number of transactions displayed per page | | sort | the sorting preference, use `asc` to sort by ascending and `desc` to sort by descending | | {% endtab %} | | {% tab title="Response" %} Sample response ``` { "status":"1", "message":"OK", "result":[ { "blockNumber":"958", "timeStamp":"1598674477", "hash":"0x4d74a6fc84d57f18b8e1dfa07ee517c4feb296d16a8353ee41adc03669982028", "from":"0x0000000000000000000000000000000000001004", "to":"0x4e656459ed25bf986eea1196bc1b00665401645d", "value":"100000000000000", "contractAddress":"", "input":"", "type":"call", "gas":"12300", "gasUsed":"0", "traceId":"0_1_1", "isError":"0", "errCode":"" }, { "blockNumber":"5561", "timeStamp":"1598688463", "hash":"0x329148b72b4bde1fb77fb3d27bca0e451f2879e5dfd7bb7027dbd9eb7bbf067b", "from":"0x0000000000000000000000000000000000001004", "to":"0x0000000000000000000000000000000000001005", "value":"1000000000000000", "contractAddress":"", "input":"", "type":"call", "gas":"2300", "gasUsed":"55", "traceId":"0_1_1_1", "isError":"0", "errCode":"" } ] } ``` {% hint style="info" %} The `isError` field returns `0` for **successful transactions** and `1` for **rejected/cancelled transactions.** {% endhint %} {% endtab %} {% endtabs %} ## Get a list of 'ERC-20 Token Transfer Events' by Address Returns the list of ERC-20 tokens transferred by an address, with optional filtering by token contract. ``` https://api.ibvmscan.io/api ?module=account &action=tokentx &contractaddress=0xc9849e6fdb743d08faee3e34dd2d1bc69ea11a51 &address=0x7bb89460599dbf32ee3aa50798bbceae2a5f7f6a &page=1 &offset=5 &startblock=0 &endblock=999999999 &sort=asc &apikey=YourApiKeyToken ``` Usage: * ERC-20 transfers from an **address**, specify the `address` parameter * ERC-20 transfers from a **contract address**, specify the `contract address` parameter * ERC-20 transfers from an **address** filtered by a **token contract**, specify both `address` and `contract address` parameters. > Try this endpoint in your [**browser**](https://api.bscscan.com/api?module=account\&action=tokentx\&contractaddress=0xc9849e6fdb743d08faee3e34dd2d1bc69ea11a51\&address=0x7bb89460599dbf32ee3aa50798bbceae2a5f7f6a\&page=1\&offset=5\&startblock=0\&endblock=999999999\&sort=asc\&apikey=YourApiKeyToken) 🔗 {% tabs %} {% tab title="Request" %} Query Parameters | Parameter | Description | | --------------- | --------------------------------------------------------------------------------------- | | address | the `string` representing the addresses to check for balance | | contractaddress | the `string` representing the token contract address to check for balance | | startblock | the `integer` block number to start searching for transactions | | endblock | the `integer` block number to stop searching for transactions | | page | the `integer` page number, if pagination is enabled | | offset | the number of transactions displayed per page | | sort | the sorting preference, use `asc` to sort by ascending and `desc` to sort by descending | | {% endtab %} | | {% tab title="Response" %} Sample response ``` { "status":"1", "message":"OK", "result":[ { "blockNumber":"2304192", "timeStamp":"1605585978", "hash":"0x7a5abf86c82d3f97a40dd841a9f2089fbe3ac1332157c01bd1a1d89f575c45fc", "nonce":"57", "blockHash":"0x703438fd8ba435996895a6b9b711934cc590c3e9297a7066419aa88dd9d83acc", "from":"0x641414e2a04c8f8ebbf49ed47cc87dccba42bf07", "contractAddress":"0xc9849e6fdb743d08faee3e34dd2d1bc69ea11a51", "to":"0x7bb89460599dbf32ee3aa50798bbceae2a5f7f6a", "value":"27605634758857128698365", "tokenName":"Bunny Token", "tokenSymbol":"BUNNY", "tokenDecimal":"18", "transactionIndex":"2", "gas":"5000000", "gasPrice":"20000000000", "gasUsed":"2312130", "cumulativeGasUsed":"2475576", "input":"deprecated", "confirmations":"8172919" }, { "blockNumber":"2304275", "timeStamp":"1605586227", "hash":"0x2712bc982d2486ed87e48965d87b8087695472dcd394a4e31fd182e3e8fb0193", "nonce":"830", "blockHash":"0x1715a97b8333aa91cd495dc19a495402683256f85faf13f4545b629844920faa", "from":"0x7bb89460599dbf32ee3aa50798bbceae2a5f7f6a", "contractAddress":"0xc9849e6fdb743d08faee3e34dd2d1bc69ea11a51", "to":"0xfb2b1ff4a80af6d4f2798e34426e7766626d8f88", "value":"500000000000000000", "tokenName":"Bunny Token", "tokenSymbol":"BUNNY", "tokenDecimal":"18", "transactionIndex":"0", "gas":"208132", "gasPrice":"20000000000", "gasUsed":"163927", "cumulativeGasUsed":"163927", "input":"deprecated", "confirmations":"8172836" }, { "blockNumber":"2304303", "timeStamp":"1605586311", "hash":"0xc9c999d7573fbcf70429b4c0d8ce01ef996a92f0c23bc07ac0adfb5cd9559bb0", "nonce":"66", "blockHash":"0x10b242b417becafd5d7dbdba3ed6377134870147de476c3ac4d9b33190b228c8", "from":"0xe87f02606911223c2cf200398ffaf353f60801f7", "contractAddress":"0xc9849e6fdb743d08faee3e34dd2d1bc69ea11a51", "to":"0x7bb89460599dbf32ee3aa50798bbceae2a5f7f6a", "value":"27596643935905551037808", "tokenName":"Bunny Token", "tokenSymbol":"BUNNY", "tokenDecimal":"18", "transactionIndex":"3", "gas":"5000000", "gasPrice":"20000000000", "gasUsed":"200227", "cumulativeGasUsed":"527144", "input":"deprecated", "confirmations":"8172808" } ] } ``` {% endtab %} {% endtabs %} ## Get a list of 'ERC-721 Token Transfer Events' by Address Returns the list of ERC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract. ``` https://api.ibvmscan.io/api ?module=account &action=tokennfttx &contractaddress=0x5e74094cd416f55179dbd0e45b1a8ed030e396a1 &address=0xcd4ee0a77e09afa8d5a6518f7cf8539bef684e6c &page=1 &offset=100 &startblock=0 &endblock=999999999 &sort=asc &apikey=YourApiKeyToken ``` Usage: * ERC-721 transfers from an **address**, specify the `address` parameter * ERC-721 transfers from a **contract address**, specify the `contract address` parameter * ERC-721 transfers from an **address** filtered by a **token contract**, specify both `address` and `contract address` parameters. > Try this endpoint in your [**browser**](https://api.bscscan.com/api?module=account\&action=tokennfttx\&contractaddress=0x5e74094cd416f55179dbd0e45b1a8ed030e396a1\&address=0xcd4ee0a77e09afa8d5a6518f7cf8539bef684e6c\&page=1\&offset=100\&startblock=0\&endblock=999999999\&sort=asc\&apikey=YourApiKeyToken) 🔗 ## Get list of Blocks Validated by Address Returns the list of blocks validated by an address. ``` https://api.ibvmscan.io/api ?module=account &action=getminedblocks &address=0x78f3adfc719c99674c072166708589033e2d9afe &blocktype=blocks &page=1 &offset=10 &apikey=YourApiKeyToken ``` > Try this endpoint in your [**browser**](https://api.bscscan.com/api?module=account\&action=getminedblocks\&address=0x78f3adfc719c99674c072166708589033e2d9afe\&blocktype=blocks\&page=1\&offset=10\&apikey=YourApiKeyToken) 🔗 {% tabs %} {% tab title="Request" %} Query Parameters | Parameter | Description | | ------------ | ----------------------------------------------------------------- | | address | the `string` representing the addresses to check for balance | | blocktype | the `string` pre-defined block type, `blocks`for canonical blocks | | page | the `integer` page number, if pagination is enabled | | offset | the number of transactions displayed per page | | {% endtab %} | | {% tab title="Response" %} Sample response ``` { "status":"1", "message":"OK", "result":[ { "blockNumber":"5428195", "timeStamp":"1614988862", "blockReward":"106809335800031367" }, { "blockNumber":"5428027", "timeStamp":"1614988358", "blockReward":"55018370100000000" }, { "blockNumber":"5428006", "timeStamp":"1614988295", "blockReward":"57546050000111471" } ] } ``` {% hint style="info" %} ⏳ **Note :** The `timeStamp` is represented in [**Unix timestamp.**](https://www.unixtimestamp.com/) {% endhint %} {% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://ibvm.gitbook.io/ibvm-doc/explorer-documentation/accounts.md?ask=