Comment on page
Accounts
Endpoints with 
are under the API Pro subscription. To upgrade your API plan, browse through the BscScan APIs page.
Returns the BNB balance of a given address.
https://api.bscscan.com/api
?module=account
&action=balance
&address=0x70F657164e5b75689b64B7fd1fA275F334f28e18
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the address to check for balance |
tag | the string pre-defined block parameter, either earliest, pending or latest |
Sample response
{
"status":"1",
"message":"OK",
"result":"154476596514118000947297331"
}
Returns the balance of the accounts from a list of addresses.
https://api.bscscan.com/api
?module=account
&action=balancemulti
&address=0x3f349bBaFEc1551819B8be1EfEA2fC46cA749aA1,0x4bF01a5A576bE1254C5E19fbE5EB195D6cFBeBdD,0x70F657164e5b75689b64B7fd1fA275F334f28e18
&tag=latest
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the strings representing the addresses to check for balance, separated by , commas
up to 20 addresses per call |
tag | the string pre-defined block parameter, either earliest, pending or latest |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"account":"0x3f349bBaFEc1551819B8be1EfEA2fC46cA749aA1",
"balance":"37700000000000001"
},
{
"account":"0x4bF01a5A576bE1254C5E19fbE5EB195D6cFBeBdD",
"balance":"4999777740000000000"
},
{
"account":"0x70F657164e5b75689b64B7fd1fA275F334f28e18",
"balance":"57443177693229716"
}
]
}
Returns the historical BNB balance of an address at a certain block height.
Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
📝
https://api.bscscan.com/api
?module=account
&action=balancehistory
&address=0x0DB011018728D1B91dDB3C77933a40B9B68C9fa7
&blockno=2000000
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the address to check for balance |
blockno | the integer block number to check balance for eg. 2000000 |
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"account":"0x3f349bBaFEc1551819B8be1EfEA2fC46cA749aA1",
"balance":"37700000000000001"
},
{
"account":"0x4bF01a5A576bE1254C5E19fbE5EB195D6cFBeBdD",
"balance":"4999777740000000000"
},
{
"account":"0x70F657164e5b75689b64B7fd1fA275F334f28e18",
"balance":"57443177693229716"
}
]
}
Returns the list of transactions performed by an address, with optional pagination.
Note : This API endpoint returns a maximum of 10000 records only.
📝
https://api.bscscan.com/api
?module=account
&action=txlist
&address=0xF426a8d0A94bf039A35CEE66dBf0227A7a12D11e
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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 |
Tip: Specify a smaller
💡
startblock and endblock range for faster search results.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"
}
]
}
Returns the list of internal transactions performed by an address, with optional pagination.
Note : This API endpoint returns a maximum of 10000 records only.
📝
https://api.bscscan.com/api
?module=account
&action=txlistinternal
&address=0x0000000000000000000000000000000000001004
&startblock=0
&endblock=2702578
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
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 |
Tip: Specify a smaller
💡
startblock and endblock range for faster search resultsSample 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":""
}
]
}
Returns the list of internal transactions performed within a transaction.
Note : This API endpoint returns a maximum of 10000 records only.
📝
https://api.bscscan.com/api
?module=account
&action=txlistinternal
&txhash=0x4d74a6fc84d57f18b8e1dfa07ee517c4feb296d16a8353ee41adc03669982028
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
txhash | the string representing the transaction hash to check for internal transactions |
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":""
}
]
}
The
isError field returns 0 for successful transactions and 1 for rejected/cancelled transactions.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.bscscan.com/api
?module=account
&action=txlistinternal
&startblock=0
&endblock=2702578
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
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 |
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":""
}
]
}
The
isError field returns 0 for successful transactions and 1 for rejected/cancelled transactions.Returns the list of BEP-20 tokens transferred by an address, with optional filtering by token contract.
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
Usage:
- BEP-20 transfers from an address, specify the
addressparameter - BEP-20 transfers from a contract address, specify the
contract addressparameter - BEP-20 transfers from an address filtered by a token contract, specify both
addressandcontract addressparameters.
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the address to check for balance |
contractaddress | the string representing the token contract address to check for balance |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
startblock | the integer block number to start searching for transactions |
endblock | the integer block number to stop searching for transactions |
sort | the sorting preference, use asc to sort by ascending and desc to sort by descending |
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"
}
]
}
Returns the list of BEP-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract.
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
Usage:
- BEP-721 transfers from an address, specify the
addressparameter - BEP-721 transfers from a contract address, specify the
contract addressparameter - BEP-721 transfers from an address filtered by a token contract, specify both
addressandcontract addressparameters.
Returns the list of blocks validated by an address.
https://api.bscscan.com/api
?module=account
&action=getminedblocks
&address=0x78f3adfc719c99674c072166708589033e2d9afe
&blocktype=blocks
&page=1
&offset=10
&apikey=YourApiKeyToken
Request
Response
Query Parameters
Parameter | Description |
|---|---|
address | the string representing the address to check for balance |
blocktype | the string pre-defined block type, blocksfor canonical blocks |
page | the integer page number, if pagination is enabled |
offset | the number of transactions displayed per page |
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"
}
]
}
Last modified 22d ago