Skip to main content

๐ŸŽฏAccounts API Endpoints

Notes

Endpoints with ๐Ÿ…ฟ๐Ÿ†๐Ÿ…พ are under the API Pro subscription. To upgrade your API plan, browse through the BscScan APIs page.

//imports
using BscScan.NetCore.Contracts;
using BscScan.NetCore.Models.Request.Accounts;

//inject
private readonly IBscScanContractsService _bscScanContractsService;

๐Ÿ’ฐGet BNB Balance for a Single Addressโ€‹

Returns the BNB balance of a given address.โ€‹

//Sample Request ๐ŸŽ
var balance = await _bscScanAccountsService.GetBnbBalanceAsync(new BnbBalanceRequest
                {
                    Address = "0x70F657164e5b75689b64B7fd1fA275F334f28e18",
                    Tag = Tag.Latest
                });

๐Ÿ’ฐGet BNB Balance for Multiple Addresses in a Single Callโ€‹

Returns the balance of the accounts from a list of addresses.โ€‹

//Sample Request ๐ŸŽ
string[] addresses =
        {"0x70F657164e5b75689b64B7fd1fA275F334f28e18","0x3f349bBaFEc1551819B8be1EfEA2fC46cA749aA1" };

var balances = await _bscScanAccountsService.GetMultipleBnbBalanceAsync(new MultipleBnbBalanceRequest
              {
                    Addresses = addresses
              });

๐Ÿ’ฐGet Historical BNB Balance for a Single Address by BlockNo ๐Ÿ…ฟ๐Ÿ†๐Ÿ…พโ€‹

Returns the historical BNB balance of an address at a certain block height.โ€‹

//Sample Request ๐ŸŽ

var balance = await _bscScanAccountsService
                .GetHistoricalBnbBalanceByBlockNoAsync("0x0DB011018728D1B91dDB3C77933a40B9B68C9fa7",2000000);

๐Ÿ’ฐGet a list of 'Normal' Transactions By Addressโ€‹

Returns the list of transactions performed by an address, with optional pagination.โ€‹

//Sample Request ๐ŸŽ

  var parameters = new NormalTransactionsRequest
            {
                Address = "0xF426a8d0A94bf039A35CEE66dBf0227A7a12D11e",

                //optional parameters with default values
                //Sort = // default asc
                //EndBlock =  // default 9999999
                //OffSet =  // default 10
                //Page =  //default 1
                //StartBlock  //default 0 
            };

  var normalTransactions = await _bscScanAccountsService
                .GetNormalTransactionsByAddressAsync(parameters);

๐Ÿ’ฐGet a list of 'Internal' Transactions by Addressโ€‹

Returns the list of internal transactions performed by an address, with optional pagination.โ€‹

//Sample Request ๐ŸŽ

var parameters = new InternalTransactionsRequest
            {
                Address = "0x0000000000000000000000000000000000001004",
                Sort = Sort.Asc,
                StartBlock = 0,
                EndBlock = 2702578,
                Page = 1,
                OffSet = 10
            };

var internalTransactions = await _bscScanAccountsService
                .GetInternalTransactionsByAddressAsync(parameters);

๐Ÿ’ฐGet 'Internal Transactions' by Transaction Hashโ€‹

Returns the list of internal transactions performed within a transaction.โ€‹

//Sample Request ๐ŸŽ

 var internalTransactions = await _bscScanAccountsService
                .GetInternalTransactionsByTransactionHashAsync("0x4d74a6fc84d57f18b8e1dfa07ee517c4feb296d16a8353ee41adc03669982028");

๐Ÿ’ฐGet "Internal Transactions" by Block Rangeโ€‹

Returns the list of internal transactions performed within a block range, with optional pagination.โ€‹

//Sample Request ๐ŸŽ

 var parameters = new InternalTransactionsByBlockRangeRequest
            {
                StartBlock = 0,
                EndBlock = 2702578,
                Page = 1,
                OffSet = 10,
                Sort = Sort.Asc
            };

            var internalTransactions = await _bscScanAccountsService
                .GetInternalTransactionsByBlockRangeAsync(parameters);

๐Ÿ’ฐGet a list of 'BEP-20 Token Transfer Events' by Addressโ€‹

Returns the list of BEP-20 tokens transferred by an address, with optional filtering by token contract.โ€‹

//Sample Request ๐ŸŽ

var parameters = new Bep20TokenTransferEventsRequest
            {
                ContractAddress = "0xc9849e6fdb743d08faee3e34dd2d1bc69ea11a51",
                Address = "0x7bb89460599dbf32ee3aa50798bbceae2a5f7f6a",
                StartBlock = 0,
                EndBlock = 999999999,
                Page = 1,
                OffSet = 5,
                Sort = Sort.Asc
            };

            var bep20TokenTransferEvents = await _bscScanAccountsService
                .GetBep20TokenTransferEventsByAddressAsync(parameters);

๐Ÿ’ฐGet a list of 'BEP-721 Token Transfer Events' by Addressโ€‹

Returns the list of BEP-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract.โ€‹

//Sample Request ๐ŸŽ

var parameters = new Bep721TokenTransferEventsRequest
            {
                ContractAddress = "0x5e74094cd416f55179dbd0e45b1a8ed030e396a1",
                Address = "0xcd4ee0a77e09afa8d5a6518f7cf8539bef684e6c",
                StartBlock = 0,
                EndBlock = 999999999,
                Page = 1,
                OffSet = 3,
                Sort = Sort.Asc
            };

var bep721TokenTransferEvents = await _bscScanAccountsService
            .GetBep721TokenTransferEventsByAddressAsync(parameters);

๐Ÿ’ฐGet list of Blocks Validated by Addressโ€‹

Returns the list of blocks validated by an address.โ€‹

//Sample Request ๐ŸŽ

var parameters = new BlocksValidatedRequest
            {
                Address = "0x78f3adfc719c99674c072166708589033e2d9afe",
                Page = 1,
                OffSet = 5,
                BlockType = "blocks"
            };

var blocksValidatedByAddress = await _bscScanAccountsService
                .GetBlocksValidatedByAddressAsync(parameters);