API PRO Endpoints

The following is a complete list of additional API endpoints available under the API PRO subscription.
To upgrade your API plan, kindly visit BscScan APIs.
Get Historical BNB Balance for a Single Address by BlockNo 
​
Returns the historical BNB balance of an address at a certain block height.
1
https://api.bscscan.com/api
2
   ?module=account
3
   &action=balancehistory
4
   &address=0x0DB011018728D1B91dDB3C77933a40B9B68C9fa7
5
   &blockno=2000000
6
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
address
the strings representing the addresses to check for balance, separated by , commas
blockno
the integer block number to check balance for eg. 2000000
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK-Missing/Invalid API Key, rate limit of 1/5sec applied",
4
   "result":[
5
      {
6
         "account":"0x3f349bBaFEc1551819B8be1EfEA2fC46cA749aA1",
7
         "balance":"37700000000000001"
8
      },
9
      {
10
         "account":"0x4bF01a5A576bE1254C5E19fbE5EB195D6cFBeBdD",
11
         "balance":"4999777740000000000"
12
      },
13
      {
14
         "account":"0x70F657164e5b75689b64B7fd1fA275F334f28e18",
15
         "balance":"57443177693229716"
16
      }
17
   ]
18
}
Copied!
​📖
 Tip: The result is returned in wei.​
Convert BNB units using our Unit Converter.​
Get Daily Average Block Size 
​
Returns the daily average block size within a date range.
1
https://api.bscscan.com/api
2
   ?module=stats
3
   &action=dailyavgblocksize
4
   &startdate=2021-08-01
5
   &enddate=2021-08-31
6
   &sort=asc
7
   &apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
startdate
the starting date in yyyy-MM-dd format, eg. 2021-08-01
enddate
the ending date in yyyy-MM-dd format, eg. 2021-08-31
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "UTCDate":"2021-08-01",
7
         "unixTimeStamp":"1627776000",
8
         "blockSize_bytes":96364
9
      },
10
      {
11
         "UTCDate":"2021-08-02",
12
         "unixTimeStamp":"1627862400",
13
         "blockSize_bytes":94832
14
      },
15
      {
16
         "UTCDate":"2021-08-31",
17
         "unixTimeStamp":"1630368000",
18
         "blockSize_bytes":90159
19
      }
20
   ]
21
}
Copied!
Get Daily Block Count and Rewards 
​
Returns the number of blocks validated daily and the amount of block rewards.
1
https://api.bscscan.com/api
2
   ?module=stats
3
   &action=dailyblkcount
4
   &startdate=2021-08-01
5
   &enddate=2021-08-31
6
   &sort=asc
7
   &apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
startdate
the starting date in yyyy-MM-dd format, eg. 2021-08-01
enddate
the ending date in yyyy-MM-dd format, eg. 2021-08-31
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "UTCDate":"2021-08-01",
7
         "unixTimeStamp":"1627776000",
8
         "blockCount":27783,
9
         "blockRewards_Eth":"9216.309553593894910979"
10
      },
11
      {
12
         "UTCDate":"2021-08-02",
13
         "unixTimeStamp":"1627862400",
14
         "blockCount":27941,
15
         "blockRewards_Eth":"8474.944904178535758101"
16
      },
17
      {
18
         "UTCDate":"2021-08-31",
19
         "unixTimeStamp":"1630368000",
20
         "blockCount":28357,
21
         "blockRewards_Eth":"7213.736543000372715456"
22
      }
23
   ]
24
}
Copied!
Get Daily Block Rewards 
​
Returns the amount of block rewards distributed to validators daily.
1
https://api.bscscan.com/api
2
   ?module=stats
3
   &action=dailyblockrewards
4
   &startdate=2021-08-01
5
   &enddate=2021-08-31
6
   &sort=asc
7
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
startdate
the starting date in yyyy-MM-dd format, eg. 2021-08-01
enddate
the ending date in yyyy-MM-dd format, eg. 2021-08-31
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "UTCDate":"2021-08-01",
7
         "unixTimeStamp":"1627776000",
8
         "blockRewards_Eth":"0"
9
      },
10
      {
11
         "UTCDate":"2021-08-02",
12
         "unixTimeStamp":"1627862400",
13
         "blockRewards_Eth":"0"
14
      },
15
      {
16
         "UTCDate":"2021-08-31",
17
         "unixTimeStamp":"1630368000",
18
         "blockRewards_Eth":"0"
19
      }
20
   ]
21
}
Copied!
Get Daily Average Time for A Block to be Included in the BNB Smart Chain 
​
Returns the daily average of time needed for a block to be successfully validated.
1
https://api.bscscan.com/api
2
   ?module=stats
3
   &action=dailyavgblocktime
4
   &startdate=2021-08-01
5
   &enddate=2021-08-31
6
   &sort=asc
7
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
startdate
the starting date in yyyy-MM-dd format, eg. 2021-08-01
enddate
the ending date in yyyy-MM-dd format, eg. 2021-08-31
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "UTCDate":"2021-08-01",
7
         "unixTimeStamp":"1627776000",
8
         "blockTime_sec":"3.11"
9
      },
10
      {
11
         "UTCDate":"2021-08-02",
12
         "unixTimeStamp":"1627862400",
13
         "blockTime_sec":"3.09"
14
      },
15
      {
16
         "UTCDate":"2021-08-31",
17
         "unixTimeStamp":"1630368000",
18
         "blockTime_sec":"3.05"
19
      }
20
   ]
21
}
Copied!
Get Token Holder List by Contract Address 
​
Return the current token holders and number of tokens held.
1
https://api.bscscan.com/api
2
   ?module=token
3
   &action=tokenholderlist
4
   &contractaddress=0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82
5
   &page=1
6
   &offset=10
7
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
contractaddress
the contract address of the BEP-20 token
page
the integer page number, if pagination is enabled
offset
the number of transactions displayed per page
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "TokenHolderAddress":"0x0000000000000000000000000000000000000000",
7
         "TokenHolderQuantity":"0"
8
      },
9
      {
10
         "TokenHolderAddress":"0x0000000000000000000000000000000000000001",
11
         "TokenHolderQuantity":"1136630046187908600061"
12
      },
13
      {
14
         "TokenHolderAddress":"0x0000000000000000000000000000000000001004",
15
         "TokenHolderQuantity":"385642396146098637680574"
16
      },
17
      {
18
         "TokenHolderAddress":"0x00000000100f9d75535cbf23f82e23db5558e8c1",
19
         "TokenHolderQuantity":"25536632618506"
20
      }
21
   ]
22
}
Copied!
Get Historical BEP-20 Token TotalSupply by ContractAddress & BlockNo 
​
Returns the historical amount of a BEP-20 token in circulation at a certain block height.
​📝
 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
1
https://api.bscscan.com/api
2
   ?module=stats
3
   &action=tokensupplyhistory
4
   &contractaddress=0xc9849e6fdb743d08faee3e34dd2d1bc69ea11a51
5
   &blockno=4000000
6
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
contractaddress
the contract address of the BEP-20 token
blockno
the integer block number to check total supply for eg. 4000000
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":"21265524714464"
5
}
Copied!
​📈
 Tip : The result is returned in the token's smallest decimal representation.
Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398
Get Historical BEP-20 Token Account Balance by ContractAddress & BlockNo 
​
Returns the balance of a BEP-20 token of an address at a certain block height.
​📝
 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
1
https://api.bscscan.com/api
2
   ?module=account
3
   &action=tokenbalancehistory
4
   &contractaddress=0xc9849e6fdb743d08faee3e34dd2d1bc69ea11a51
5
   &address=0x7bb89460599dbf32ee3aa50798bbceae2a5f7f6a
6
   &blockno=4000000
7
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
contractaddress
the contract address of the BEP-20 token
address
the string representing the address to check for balance
blockno
the integer block number to check total supply for eg. 400000
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":"135499"
5
}
Copied!
​📈
 Tip : The result is returned in the token's smallest decimal representation.
Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398
Get Token Info by ContractAddress 
​
Returns project information and social media links of a BEP-20 token.
1
https://api.bscscan.com/api
2
   ?module=token
3
   &action=tokeninfo
4
   &contractaddress=0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82
5
   &apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
contractaddress
the contract address of the BEP-20 token to retrieve token info
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "contractAddress":"0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82",
7
         "tokenName":"PancakeSwap Token",
8
         "symbol":"Cake",
9
         "divisor":"18",
10
         "tokenType":"ERC20",
11
         "totalSupply":"431889535.843059000000000000",
12
         "blueCheckmark":"true",
13
         "description":"PancakeSwap is a yield farming project whereby users can get FLIP (LP token) for staking and get CAKE token as reward. CAKE holders can swap CAKE for SYRUP for additional incentivized staking.",
14
         "website":"https://pancakeswap.finance/",
15
         "email":"[email protected]",
16
         "blog":"https://medium.com/@pancakeswap",
17
         "reddit":"",
18
         "slack":"",
19
         "facebook":"",
20
         "twitter":"https://twitter.com/pancakeswap",
21
         "bitcointalk":"",
22
         "github":"https://github.com/pancakeswap",
23
         "telegram":"https://t.me/PancakeSwap",
24
         "wechat":"",
25
         "linkedin":"",
26
         "discord":"",
27
         "whitepaper":"",
28
         "tokenPriceUSD":"23.9300000000"
29
      }
30
   ]
31
}
Copied!
Get Daily Average Gas Limit
​
Returns the historical daily average gas limit of the BNB Smart Chain network.
1
 https://api.bscscan.com/api
2
    ?module=stats
3
    &action=dailyavggaslimit
4
    &startdate=2021-08-01
5
    &enddate=2021-08-28
6
    &sort=asc
7
    &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
startdate
the starting date in yyyy-MM-dd format, eg. 2021-08-01
enddate
the ending date in yyyy-MM-dd format, eg. 2021-08-28
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "UTCDate":"2021-08-01",
7
         "unixTimeStamp":"1627776000",
8
         "gasLimit":"77995057"
9
      },
10
      {
11
         "UTCDate":"2021-08-02",
12
         "unixTimeStamp":"1627862400",
13
         "gasLimit":"77477220"
14
      },
15
      {
16
         "UTCDate":"2021-08-03",
17
         "unixTimeStamp":"1627948800",
18
         "gasLimit":"77163193"
19
      }
20
   ]
21
}
Copied!
Get BNB Smart Chain Daily Total Gas Used
​
Returns the total amount of gas used daily for transctions on the BNB Smart Chainnetwork.
1
 https://api.bscscan.com/api
2
    ?module=stats
3
    &action=dailygasused
4
    &startdate=2021-02-01
5
    &enddate=2021-02-28
6
    &sort=asc
7
    &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
startdate
the starting date in yyyy-MM-dd format, eg. 2021-01-01
enddate
the ending date in yyyy-MM-dd format, eg. 2021-02-28
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
1
{
2
    "status":"1",
3
    "message":"OK",
4
    "result":[
5
       {
6
          "UTCDate":"2021-02-01",
7
          "unixTimeStamp":"1612137600",
8
          "gasUsed":"70672744503"
9
       },
10
       {
11
          "UTCDate":"2021-02-02",
12
          "unixTimeStamp":"1612224000",
13
          "gasUsed":"73905877156"
14
       },
15
       {
16
          "UTCDate":"2021-02-03",
17
          "unixTimeStamp":"1612310400",
18
          "gasUsed":"75696419315"
19
       }
20
    ]
21
 }
Copied!
Get Daily Average Gas Price
​
Returns the daily average gas price used on the BNB Smart Chain network.
1
 https://api.bscscan.com/api
2
    ?module=stats
3
    &action=dailyavggasprice
4
    &startdate=2021-02-01
5
    &enddate=2021-02-28
6
    &sort=asc
7
    &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Query Parameters
Parameter
Description
startdate
the starting date in yyyy-MM-dd format, eg. 2021-02-01
enddate
the ending date in yyyy-MM-dd format, eg. 2021-02-28
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Get BNB Historical Price 
​
Returns the historical price of 1 BNB.
1
https://api.bscscan.com/api
2
   ?module=stats
3
   &action=bnbdailyprice
4
   &startdate=2021-08-01
5
   &enddate=2021-08-31
6
   &sort=asc
7
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
startdate
the starting date in yyyy-MM-dd format, eg. 2021-08-01
enddate
the ending date in yyyy-MM-dd format, eg. 2021-08-28
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "UTCDate":"2021-08-01",
7
         "unixTimeStamp":"1627776000",
8
         "value":"332.79"
9
      },
10
      {
11
         "UTCDate":"2021-08-02",
12
         "unixTimeStamp":"1627862400",
13
         "value":"330.72"
14
      },
15
      {
16
         "UTCDate":"2021-08-30",
17
         "unixTimeStamp":"1630281600",
18
         "value":"460.05"
19
      }
20
   ]
21
}
Copied!
​💰
 Tip : The value is represented in US Dollars ( USD ).
Get Daily Network Transaction Fee 
​
Returns the historical amount of transaction fees paid to validators per day.
1
https://api.bscscan.com/api?
2
   module=stats
3
   &action=dailytxnfee
4
   &startdate=2020-10-01
5
   &enddate=2020-10-31
6
   &apikey=YourApiKeyToken 
7
   &sort=asc
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
startdate
the starting date in yyyy-MM-dd format, eg. 2020-10-01
enddate
the ending date in yyyy-MM-dd format, eg. 2020-10-31
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "UTCDate":"2020-10-01",
7
         "unixTimeStamp":"1601510400",
8
         "transactionFee_Eth":"356.764105308852361"
9
      },
10
      {
11
         "UTCDate":"2020-10-02",
12
         "unixTimeStamp":"1601596800",
13
         "transactionFee_Eth":"270.806833010901929108"
14
      },
15
      {
16
         "UTCDate":"2020-10-31",
17
         "unixTimeStamp":"1604102400",
18
         "transactionFee_Eth":"352.100068789871253431"
19
      }
20
   ]
21
}
Copied!
Get Daily New Address Count 
​
Returns the historical number of new BNB Smart Chain addresses created per day.
1
https://api.bscscan.com/api
2
   ?module=stats
3
   &action=dailynewaddress
4
   &startdate=2020-10-01
5
   &enddate=2020-10-31
6
   &sort=asc
7
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
startdate
the starting date in yyyy-MM-dd format, eg. 2020-10-01
enddate
the ending date in yyyy-MM-dd format, eg. 2020-10-31
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "UTCDate":"2020-10-01",
7
         "unixTimeStamp":"1601510400",
8
         "newAddressCount":3544
9
      },
10
      {
11
         "UTCDate":"2020-10-02",
12
         "unixTimeStamp":"1601596800",
13
         "newAddressCount":6524
14
      },
15
      {
16
         "UTCDate":"2020-10-31",
17
         "unixTimeStamp":"1604102400",
18
         "newAddressCount":8284
19
      }
20
   ]
21
}
Copied!
Get Daily Network Utilization 
​
Returns the daily average gas used over gas limit percentage.
1
https://api.bscscan.com/api
2
   ?module=stats
3
   &action=dailynetutilization
4
   &startdate=2021-07-01
5
   &enddate=2021-07-31
6
   &sort=asc
7
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
startdate
the starting date in yyyy-MM-dd format, eg. 2021-07-01
enddate
the ending date in yyyy-MM-dd format, eg. 2021-07-28
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "UTCDate":"2021-08-01",
7
         "unixTimeStamp":"1627776000",
8
         "networkUtilization":"0.7528"
9
      },
10
      {
11
         "UTCDate":"2021-08-02",
12
         "unixTimeStamp":"1627862400",
13
         "networkUtilization":"0.7051"
14
      },
15
      {
16
         "UTCDate":"2021-08-30",
17
         "unixTimeStamp":"1630281600",
18
         "networkUtilization":"0.4893"
19
      }
20
   ]
21
}
Copied!
Get Daily Transaction Count 
​
Returns the number of transactions performed on the Ethereum blockchain per day.
1
https://api.bscscan.com/api
2
   ?module=stats
3
   &action=dailytx
4
   &startdate=2021-07-01
5
   &enddate=2021-07-31
6
   &sort=asc
7
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
startdate
the starting date in yyyy-MM-dd format, eg. 2021-07-01
enddate
the ending date in yyyy-MM-dd format, eg. 2021-07-28
sort
the sorting preference, use asc to sort by ascending and desc to sort by descending
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "UTCDate":"2019-02-01",
7
         "unixTimeStamp":"1548979200",
8
         "transactionCount":498856
9
      },
10
      {
11
         "UTCDate":"2019-02-28",
12
         "unixTimeStamp":"1551312000",
13
         "transactionCount":541458
14
      }
15
   ]
16
}
Copied!
Get Address BEP20 Token Holding 
​
Returns the BEP-20 tokens and amount held by an address.
​📝
 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
1
https://api.bscscan.com/api
2
   ?module=account
3
   &action=addresstokenbalance
4
   &address=0x99817ce62abf5b17f58e71071e590cf958e5a1bf
5
   &page=1
6
   &offset=100
7
   &apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
address
the string representing the address to check for balance
page
the integer page number, if pagination is enabled
offset
the number of transactions displayed per page
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "TokenAddress":"0xfcb5DF42e06A39E233dc707bb3a80311eFD11576",
7
         "TokenName":"www.METH.co.in",
8
         "TokenSymbol":"METH",
9
         "TokenQuantity":"1337000",
10
         "TokenDivisor":"18"
11
      },
12
      {
13
         "TokenAddress":"0xdf1f0026374d4bcc490be5e316963cf6df2fff19",
14
         "TokenName":"InnovativeBioresearchCoin",
15
         "TokenSymbol":"INNBC",
16
         "TokenQuantity":"2000000000",
17
         "TokenDivisor":"6"
18
      },
19
      {
20
         "TokenAddress":"0x78e1936f065fd4082387622878c7d11c9f05ecf4",
21
         "TokenName":"JNTR/b",
22
         "TokenSymbol":"JNTR/b",
23
         "TokenQuantity":"163000000000000000000",
24
         "TokenDivisor":"18"
25
      },
26
      {
27
         "TokenAddress":"0x12e34cdf6a031a10fe241864c32fb03a4fdad739",
28
         "TokenName":"FREE coin BSC",
29
         "TokenSymbol":"FREE",
30
         "TokenQuantity":"21144000000000000000000",
31
         "TokenDivisor":"18"
32
      },
33
      {
34
         "TokenAddress":"0xef5ceb00ae3eb617773016b4ca886b61fa4e027e",
35
         "TokenName":"BURNING",
36
         "TokenSymbol":"BURN",
37
         "TokenQuantity":"50000000000000000",
38
         "TokenDivisor":"18"
39
      }
40
   ]
41
}
Copied!
Get Address ERC721 Token Holding 
​
Returns the BEP-721 tokens and amount held by an address.
​📝
 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
1
https://api.bscscan.com/api
2
   ?module=account
3
   &action=addresstokennftbalance
4
   &address=0x99817ce62abf5b17f58e71071e590cf958e5a1bf
5
   &page=1
6
   &offset=100
7
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
address
the string representing the address to check for balance
page
the integer page number, if pagination is enabled
offset
the number of transactions displayed per page
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1",
7
         "TokenName":"Pancake Lottery Ticket",
8
         "TokenSymbol":"PLT",
9
         "TokenQuantity":"18"
10
      },
11
      {
12
         "TokenAddress":"0xdf7952b35f24acf7fc0487d01c8d5690a60dba07",
13
         "TokenName":"Pancake Bunnies",
14
         "TokenSymbol":"PB",
15
         "TokenQuantity":"1"
16
      }
17
   ]
18
}
Copied!
Get Address ERC721 Token Inventory By Contract Address 
​
Returns the BEP-721 token inventory of an address, filtered by contract address.
​📝
 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
1
https://api.bscscan.com/api
2
   ?module=account
3
   &action=addresstokennftinventory
4
   &address=0x99817ce62abf5b17f58e71071e590cf958e5a1bf
5
   &contractaddress=0x5e74094cd416f55179dbd0e45b1a8ed030e396a1
6
   &page=1
7
   &offset=100
8
   &apikey=YourApiKeyToken 
Copied!
Try this endpoint in your browser 🔗
​
Request
Response
Query Parameters
Parameter
Description
address
the string representing the address to check for inventory
contractaddress
the string representing the BEP-721 token contractaddress to check for inventory
page
the integer page number, if pagination is enabled
offset
the number of transactions displayed per page
Sample Response
1
{
2
   "status":"1",
3
   "message":"OK",
4
   "result":[
5
      {
6
         "TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1",
7
         "TokenId":"5077"
8
      },
9
      {
10
         "TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1",
11
         "TokenId":"7543"
12
      },
13
      {
14
         "TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1",
15
         "TokenId":"7544"
16
      },
17
      {
18
         "TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1",
19
         "TokenId":"7545"
20
      },
21
      {
22
         "TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1",
23
         "TokenId":"121878"
24
      },
25
      {
26
         "TokenAddress":"0x5e74094cd416f55179dbd0e45b1a8ed030e396a1",
27
         "TokenId":"121879"
28
      }
29
   ]
30
}
Copied!