Accounts

Get BNB Balance for a Single Address

Returns the BNB balance of a given address.

https://api-testnet.bscscan.com/api
   ?module=account
   &action=balance
   &address=0x4281eCF07378Ee595C564a59048801330f3084eE
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

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":"2165659982838683456"
}

📖 Tip: The result is returned in wei.

Convert BNB units using our Unit Converter.

Get BNB Balance for Multiple Addresses in a Single Call

Returns the balance of the accounts from a list of addresses.

https://api-testnet.bscscan.com/api
   ?module=account
   &action=balancemulti
   &address=0x3f349bBaFEc1551819B8be1EfEA2fC46cA749aA1,0x83EBba62B9232f2a6cB16576Af9D48b349D1816d,0x70F657164e5b75689b64B7fd1fA275F334f28e18
   &tag=latest
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

address

the strings representing the addresses to check for balance, separated by , com

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":"1000000000000000000"
      },
      {
         "account":"0x83EBba62B9232f2a6cB16576Af9D48b349D1816d",
         "balance":"152535879999309248"
      },
      {
         "account":"0x70F657164e5b75689b64B7fd1fA275F334f28e18",
         "balance":"4000000000000000000"
      }
   ]
}

📖 Tip: The result is returned in wei.

Convert BNB units using our Unit Converter.

Get a list of 'Normal' Transactions By Address

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-testnet.bscscan.com/api
   ?module=account
   &action=txlist
   &address=0x1a73C6c04bBc0aD52cd079B657553EaA30A26e61
   &startblock=0
   &endblock=99999999
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

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":"12379815",
         "timeStamp":"1631685904",
         "hash":"0x54390efc5f0f40caa092553bbd0ffcb3294cb34f6aef98961ce58340a03f8826",
         "nonce":"34636",
         "blockHash":"0xffa43e06b031d93386976afb5b0cf11ff026b45a7bcad387a454558e7207f86e",
         "transactionIndex":"1",
         "from":"0x36b398c09b130b558c23ab94b4146f8911d6a8f1",
         "to":"",
         "value":"0",
         "gas":"6721975",
         "gasPrice":"20000000000",
         "isError":"0",
         "txreceipt_status":"1",
         "input":"0x6080604052600360cc556103e860d7553480156200001c57600080fd5b506040516200468f3803806200468f8339810160408190526200003f91620000f0565b60d480546001600160a01b039384166001600160a01b0319918216179091556040805160e081018252968416808852958416602088018190529484169087018190526000606088018190526080880181905260a08801529190921660c090950185905260cd8054831690941790935560ce8054821690921790915560cf8054821690921790915560d080548216905560d180548216905560d280548216905560d38054909116909117905562000188565b600080600080600060a0868803121562000108578081fd5b855162000115816200016f565b602087015190955062000128816200016f565b60408701519094506200013b816200016f565b60608701519093506200014e816200016f565b608087015190925062000161816200016f565b809150509295509295909350565b6001600160a01b03811681146200018557600080fd5b50565b6144f780620001986000396000f3fe60806040526004361061026b5760003560e01c806368c8ca0d11610144578063a457c2d7116100b6578063d4ecd0401161007a578063d4ecd04014610737578063d505accf14610757578063dd62ed3e14610777578063e9292c4714610797578063f05a020f146107b7578063f2090893146107d757610272565b8063a457c2d714610684578063a9059cbb146106a4578063af7a19ed146106c4578063c4181611146106f4578063ca8585e01461071457610272565b80637ecebe00116101085780637ecebe00146105cd578063868a686d146105ed57806387ab16421461061a57806395d89b411461063a5780639c724fa81461064f5780639fcaf49a1461066f57610272565b806368c8ca0d1461052557806370a08231146105455780637790f6ba1461056557806379502c55146105855780637d54cf71146105ad57610272565b80633644e515116101dd5780634521e181116101a15780634521e181146104845780634ef969ed146104a45780634fe5d790146104c457806350cfeddd146104e65780635793cb6b146104fb5780636067f59f1461051057610272565b80633644e515146103fa578063395093511461040f5780633b6678701461042f5780633eafcaf21461044f57806340b6ddbf1461046457610272565b806314d9dcd01161022f57806314d9dcd01461034157806318160ddd1461036357806323b872dd146103785780632f575b2914610398578063313ce567146103b8578063332ef5b9146103da57610272565b806306fdde0314610277578063076ac323146102a2578063095ea7b3146102c457806312e7a53d146102f157806312eb1fbf1461031f57610272565b3661027257005b600080fd5b34801561028357600080fd5b5061028c6107f9565b6040516102999190613ad1565b60405180910390f35b3480156102ae57600080fd5b506102c26102bd36600461337d565b610890565b005b3480156102d057600080fd5b506102e46102df3660046131f0565b610976565b6040516102999190613a3f565b3480156102fd57600080fd5b5061031161030c366004613529565b610994565b6040516102999291906139c5565b34801561032b57600080fd5b50610334610dbd565b6040516102999190613a4a565b34801561034d57600080fd5b50610356610dc2565b60405161029991906137d9565b34801561036f57600080fd5b50610334610dd1565b34801561038457600080fd5b506102e4610393366004613142565b610dd7565b3480156103a457600080fd5b506102c26103b33660046134a9565b610e64565b3480156103c457600080fd5b506103cd610f25565b60405161029991906143b5565b3480156103e657600080fd5b506102c26103f53660046134ee565b610f2e565b34801561040657600080fd5b50610334611029565b34801561041b57600080fd5b506102e461042a3660046131f0565b611038565b34801561043b57600080fd5b506102c261044a366004613455565b61108c565b34801561045b57600080fd5b506103346110f6565b34801561047057600080fd5b506102c261047f3660046134a9565b6110fb565b34801561049057600080fd5b506102c261049f36600461354a565b6111ae565b3480156104b057600080fd5b506102c26104bf3660046131f0565b6112d0565b3480156104d057600080fd5b506104d9611334565b6040516102999190613a2c565b3480156104f257600080fd5b5061033461138b565b34801561050757600080fd5b50610334611390565b34801561051c57600080fd5b50610334611396565b34801561053157600080fd5b5061028c610540366004613455565b61139b565b34801561055157600080fd5b506103346105603660046130ee565b611442565b34801561057157600080fd5b506104d9610580366004613455565b61145d565b34801561059157600080fd5b5061059a6114c1565b6040516102999796959493929190613984565b3480156105b957600080fd5b506104d96105c8366004613455565b6114fa565b3480156105d957600080fd5b506103346105e83660046130ee565b61155d565b3480156105f957600080fd5b5061060d610608366004613455565b61157e565b604051610299919061427e565b34801561062657600080fd5b506102c26106353660046134a9565b6118b4565b34801561064657600080fd5b5061028c611970565b34801561065b57600080fd5b506102c261066a3660046130ee565b6119d1565b34801561067b57600080fd5b50610334611a46565b34801561069057600080fd5b506102e461069f3660046131f0565b611a4b565b3480156106b057600080fd5b506102e46106bf3660046131f0565b611ab9565b3480156106d057600080fd5b506106e46106df366004613455565b611acd565b6040516102999493929190613ae4565b34801561070057600080fd5b506102c261070f366004613485565b611cdc565b34801561072057600080fd5b50610729611ec6565b6040516102999291906143a7565b34801561074357600080fd5b506102c2610752366004613455565b611eff565b34801561076357600080fd5b506102c2610772366004613182565b611f2e565b34801561078357600080fd5b5061033461079236600461310a565b612037565b3480156107a357600080fd5b506102c26107b2366004613257565b612062565b3480156107c357600080fd5b506102c26107d2366004613529565b6122ae565b3480156107e357600080fd5b506107ec612513565b6040516102999190614291565b60368054604080516020601f60026000196101006001881615020190951694909404938401819004810282018101909252828152606093909290918301828280156108855780601f1061085a57610100808354040283529160200191610885565b820191906000526020600020905b81548152906001019060200180831161086857829003601f168201915b505050505090505b90565b60cd546001600160a01b031633146108c35760405162461bcd60e51b81526004016108ba906140a1565b60405180910390fd5b6001600160a01b038216158015906108e4575060d2546001600160a01b0316155b80156108f9575060d0546001600160a01b0316155b6109155760405162461bcd60e51b81526004016108ba90613c29565b60006109338460000151856020015186604001518760600151612578565b60d080546001600160a01b03199081166001600160a01b039384161790915560d2805482169583169590951790945560d180549094169216919091179091555050565b600061098a610983612628565b848461262c565b5060015b92915050565b60d6546060906000908015806109a957508385115b806109b357508085115b156109c357606092509050610db6565b83818111156109cf5750805b601e86820311156109e05750601e85015b606086820367ffffffffffffffff811180156109fb57600080fd5b50604051908082528060200260200182016040528015610a3557816020015b610a22612d36565b815260200190600190039081610a1a5790505b5090506000875b83811015610dac5760d5600060d68381548110610a5557fe5b6000918252602080832091909101548352828101939093526040918201902081518154600260018216156101009081026000190190921604601f81018690049095028201810190935260e081018481529093919284928491840182828015610afe5780601f10610ad357610100808354040283529160200191610afe565b820191906000526020600020905b815481529060010190602001808311610ae157829003601f168201915b5050505050815260200160018201548152602001600282018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015610baa5780601f10610b7f57610100808354040283529160200191610baa565b820191906000526020600020905b815481529060010190602001808311610b8d57829003601f168201915b5050505050815260200160038201805480602002602001604051908101604052809291908181526020018280548015610c0257602002820191906000526020600020905b815481526020019060010190808311610bee575b5050505050815260200160048201805480602002602001604051908101604052809291908181526020018280548015610c5a57602002820191906000526020600020905b815481526020019060010190808311610c46575b5050505050815260200160058201805480602002602001604051908101604052809291908181526020018280548015610cb257602002820191906000526020600020905b815481526020019060010190808311610c9e575b505050505081526020016006820160405180604001604052908160008201805480602002602001604051908101604052809291908181526020018280548015610d2457602002820191906000526020600020905b81546001600160a01b03168152600190910190602001808311610d06575b5050505050815260200160018201805480602002602001604051908101604052809291908181526020018280548015610d7c57602002820191906000526020600020905b815481526020019060010190808311610d68575b50505050508152505081525050838381518110610d9557fe5b602090810291909101015260019182019101610a3c565b5090945091925050505b9250929050565b608081565b60d4546001600160a01b031681565b60355490565b6000610de48484846126e0565b610e5a84610df0612628565b610e5585604051806060016040528060288152602001614475602891396001600160a01b038a16600090815260346020526040812090610e2e612628565b6001600160a01b03168152602081019190915260400160002054919063ffffffff61280116565b61262c565b5060019392505050565b60cd546001600160a01b03163314610e8e5760405162461bcd60e51b81526004016108ba906140a1565b600082815260d5602052604090206001810154839190610ec05760405162461bcd60e51b81526004016108ba90613da0565b600084815260d5602090815260409091208451610ee592600590920191860190612d78565b507f7eb88e4a0af247244a661c1c3396b1056fbb526000133aa64223b41ebde62a388484604051610f17929190614354565b60405180910390a150505050565b60385460ff1690565b60cd546001600160a01b03163314610f585760405162461bcd60e51b81526004016108ba906140a1565b600082815260d5602052604090206001810154839190610f8a5760405162461bcd60e51b81526004016108ba90613da0565b60208301515183515114610fb05760405162461bcd60e51b81526004016108ba90613f1d565b600084815260d560209081526040909120845180518693600690930192610fdb928492910190612dc3565b506020828101518051610ff49260018501920190612d78565b509050507f13c6c1e3995a6e166e5271e71900b8731fef5e8e3deded10933f3616208e4d9d8484604051610f1792919061438e565b600061103361282d565b905090565b600061098a611045612628565b84610e558560346000611056612628565b6001600160a01b03908116825260208083019390935260409182016000908120918c16815292529020549063ffffffff61285b16565b60cd546001600160a01b031633146110b65760405162461bcd60e51b81526004016108ba906140a1565b60d78190556040517f9ef7e80651fd9de0992e3b6fca0d2faee38eaf176212ee59054d2654958836f6906110eb908390613a4a565b60405180910390a150565b606481565b60cd546001600160a01b031633146111255760405162461bcd60e51b81526004016108ba906140a1565b600082815260d56020526040902060018101548391906111575760405162461bcd60e51b81526004016108ba90613da0565b600084815260d560209081526040909120845161117c92600490920191860190612d78565b507f64bb5486f8cd4c4d6edca404c620289515cbdda97c64db7c2f155d040fd480768484604051610f17929190614354565b600083815260d56020526040902060018101548491906111e05760405162461bcd60e51b81526004016108ba90613da0565b8360058111156112025760405162461bcd60e51b81526004016108ba90613e99565b858460058151146112255760405162461bcd60e51b81526004016108ba90613e50565b3332146112445760405162461bcd60e51b81526004016108ba90613e19565b600088815260d560205260409081902060d3549151638a2d8aa360e01b815290916001600160a01b031690638a2d8aa3906112939033908d90600587019060038801908f908f906004016138b2565b600060405180830381600087803b1580156112ad57600080fd5b505af11580156112c1573d6000803e3d6000fd5b50505050505050505050505050565b60d2546001600160a01b031633146112fa5760405162461bcd60e51b81526004016108ba906140a1565b806001141561131c5761131782670de0b6b3a76400006001612887565b611330565b61133082678ac7230489e800006001612887565b5050565b606060d680548060200260200160405190810160405280929190818152602001828054801561088557602002820191906000526020600020905b81548152602001906001019080831161136e575050505050905090565b600481565b60cc5481565b600581565b600081815260d560209081526040918290206002908101805484516001821615610100026000190190911692909204601f810184900484028301840190945283825260609391929091908301828280156114365780601f1061140b57610100808354040283529160200191611436565b820191906000526020600020905b81548152906001019060200180831161141957829003601f168201915b50505050509050919050565b6001600160a01b031660009081526033602052604090205490565b600081815260d5602090815260409182902060030180548351818402810184019094528084526060939283018282801561143657602002820191906000526020600020905b8154815260200190600101908083116114a25750505050509050919050565b60cd5460ce5460cf5460d05460d15460d25460d3546001600160a01b039687169695861695948516949384169392831692918216911687565b600081815260d5602090815260409182902060040180548351818402810184019094528084526060939283018282801561143657602002820191906000526020600020908154815260200190600101908083116114a25750505050509050919050565b6001600160a01b038116600090815260996020526040812061098e906128f2565b611586612d36565b600082815260d5602090815260409182902082518154600260018216156101009081026000190190921604601f81018590049094028201810190945260e081018381529093919284928491908401828280156116235780601f106115f857610100808354040283529160200191611623565b820191906000526020600020905b81548152906001019060200180831161160657829003601f168201915b5050505050815260200160018201548152602001600282018054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156116cf5780601f106116a4576101008083540402835291602001916116cf565b820191906000526020600020905b8154815290600101906020018083116116b257829003601f168201915b505050505081526020016003820180548060200260200160405190810160405280929190818152602001828054801561172757602002820191906000526020600020905b815481526020019060010190808311611713575b505050505081526020016004820180548060200260200160405190810160405280929190818152602001828054801561177f57602002820191906000526020600020905b81548152602001906001019080831161176b575b50505050508152602001600582018054806020026020016040519081016040528092919081815260200182805480156117d757602002820191906000526020600020905b8154815260200190600101908083116117c3575b50505050508152602001600682016040518060400160405290816000820180548060200260200160405190810160405280929190818152602001828054801561184957602002820191906000526020600020905b81546001600160a01b0316815260019091019060200180831161182b575b50505050508152602001600182018054806020026020016040519081016040528092919081815260200182805480156118a157602002820191906000526020600020905b81548152602001906001019080831161188d575b5050509190925250505090525092915050565b600082815260d56020526040902060018101548391906118e65760405162461bcd60e51b81526004016108ba90613da0565b60d354600085815260d5602052604090819020905163a0c55e3160e01b81526001600160a01b039092169163a0c55e319161192f9133918991600390910190899060040161386e565b600060405180830381600087803b15801561194957600080fd5b505af115801561195d573d6000803e3d6000fd5b5050505061196a846128f6565b50505050565b60378054604080516020601f60026000196101006001881615020190951694909404938401819004810282018101909252828152606093909290918301828280156108855780601f1061085a57610100808354040283529160200191610885565b60cd546001600160a01b031633146119fb5760405162461bcd60e51b81526004016108ba906140a1565b60cd80546001600160a01b0319166001600160a01b0383161790556040517f73cc802a8666227e3cc846009797bce348c90d4d58fde06a579e87d34d43283a906110eb9083906137d9565b600881565b600061098a611a58612628565b84610e558560405180606001604052806025815260200161449d6025913960346000611a82612628565b6001600160a01b03908116825260208083019390935260409182016000908120918d1681529252902054919063ffffffff61280116565b600061098a611ac6612628565b84846126e0565b60d56020908152600091825260409182902080548351601f60026000196101006001861615020190931692909204918201849004840281018401909452808452909291839190830182828015611b645780601f10611b3957610100808354040283529160200191611b64565b820191906000526020600020905b815481529060010190602001808311611b4757829003601f168201915b505050505090806001015490806002018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015611c085780601f10611bdd57610100808354040283529160200191611c08565b820191906000526020600020905b815481529060010190602001808311611beb57829003601f168201915b5050505050908060060160405180604001604052908160008201805480602002602001604051908101604052809291908181526020018280548015611c7657602002820191906000526020600020905b81546001600160a01b03168152600190910190602001808311611c58575b5050505050815260200160018201805480602002602001604051908101604052809291908181526020018280548015611cce57602002820191906000526020600020905b815481526020019060010190808311611cba575b505050505081525050905084565b818060011480611cec575080600a145b611d085760405162461bcd60e51b81526004016108ba906141bd565b600060d754606485670de0b6b3a76400000281611d2157fe5b040290506001600160a01b038316611d4b5760405162461bcd60e51b81526004016108ba90613ce6565b60cf54604051636eb1769f60e11b81526001600160a01b0390911690600090829063dd62ed3e90611d8290339030906004016137ed565b60206040518083038186803b158015611d9a57600080fd5b505afa158015611dae573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611dd2919061346d565b905082811015611df45760405162461bcd60e51b81526004016108ba90613fa6565b60cf54611e0c906001600160a01b03163330866129d2565b60cf5460d154611e2f916001600160a01b039081169116600a8604600902612ac3565b60cf5460ce54611e53916001600160a01b0390811691166064865b04600502612ac3565b60cf54611e6c906001600160a01b031686606486611e4a565b611e813387670de0b6b3a76400000288612887565b7f7abdf250d54b73efb224a0fca882e6b50f7a946e7262834728106d5ec4cdf9ef33878786604051611eb69493929190613844565b60405180910390a1505050505050565b60008060d7546064670de0b6b3a764000081611ede57fe5b040260d7546064678ac7230489e8000081611ef557fe5b0402915091509091565b60cd546001600160a01b03163314611f295760405162461bcd60e51b81526004016108ba906140a1565b60cc55565b83421115611f4e5760405162461bcd60e51b81526004016108ba90613d69565b6000609a54888888611f83609960008e6001600160a01b03166001600160a01b031681526020019081526020016000206128f2565b89604051602001611f9996959493929190613a53565b6040516020818303038152906040528051906020012090506000611fbc82612bb1565b90506000611fcc82878787612bea565b9050896001600160a01b0316816001600160a01b031614611fff5760405162461bcd60e51b81526004016108ba90613f6f565b6001600160a01b038a16600090815260996020526040902061202090612cd7565b61202b8a8a8a61262c565b50505050505050505050565b6001600160a01b03918216600090815260346020908152604080832093909416825291909152205490565b60cd546001600160a01b0316331461208c5760405162461bcd60e51b81526004016108ba906140a1565b805151819060048110156120b25760405162461bcd60e51b81526004016108ba9061411c565b602080830151600090815260d5909152604090206001810154156120e85760405162461bcd60e51b81526004016108ba90613cb1565b604083015151600881101561210f5760405162461bcd60e51b81526004016108ba90614212565b60808111156121305760405162461bcd60e51b81526004016108ba90613fef565b60c08401516020810151519051511461215b5760405162461bcd60e51b81526004016108ba90613f1d565b602080860151600090815260d5825260409020865180518893612182928492910190612e24565b506020828101516001830155604083015180516121a59260028501920190612e24565b50606082015180516121c1916003840191602090910190612d78565b50608082015180516121dd916004840191602090910190612d78565b5060a082015180516121f9916005840191602090910190612d78565b5060c082015180518051600684019161221791839160200190612dc3565b5060208281015180516122309260018501920190612d78565b50505060208701805160d680546001810182556000919091527fe767803f8ecf1dee6bb0345811f7312cda556058b19db6389ad9ae3568643ddd01555187516040517fc935b230e6de5e0792a6500bbc2baa104eca7871b65e1d1e6144c710c1fb9dcb945061229f9350614375565b60405180910390a15050505050565b600082815260d56020526040902060018101548391906122e05760405162461bcd60e51b81526004016108ba90613da0565b8280600114806122f1575060cc5481145b61230d5760405162461bcd60e51b81526004016108ba90613bde565b33321461232c5760405162461bcd60e51b81526004016108ba90613e19565b60d054604051636eb1769f60e11b81526001600160a01b0390911690600090829063dd62ed3e9061236390339030906004016137ed565b60206040518083038186803b15801561237b57600080fd5b505afa15801561238f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906123b3919061346d565b905085670de0b6b3a7640000028110156123df5760405162461bcd60e51b81526004016108ba90613fa6565b600087815260d560205260409081902060d3549151630a6b9a7b60e21b815290916001600160a01b0316906329ae69ec9061242e9033908b906001908e906004808a019160038b019101613911565b600060405180830381600087803b15801561244857600080fd5b505af115801561245c573d6000803e3d6000fd5b505060d0546040516390596dd160e01b81526001600160a01b0390911692506390596dd1915061249c903390670de0b6b3a76400008c029060040161382b565b600060405180830381600087803b1580156124b657600080fd5b505af11580156124ca573d6000803e3d6000fd5b505050507fd8a1dd86a30634925097ada2447246c6bf78a10b800d964a19d8bd724b02304033898960405161250193929190613963565b60405180910390a15050505050505050565b61251b612e91565b506040805160e08101825260cd546001600160a01b03908116825260ce548116602083015260cf5481169282019290925260d0548216606082015260d1548216608082015260d254821660a082015260d35490911660c082015290565b60d454604080516080810182528681526020810186905260ff8516818301526001600160a01b0384811660608301529151638c0cd38d60e01b81526000939290921691638c0cd38d916125cd916004016142f0565b602060405180830381600087803b1580156125e757600080fd5b505af11580156125fb573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061261f919061323b565b95945050505050565b3390565b6001600160a01b0383166126525760405162461bcd60e51b81526004016108ba906140d8565b6001600160a01b0382166126785760405162461bcd60e51b81526004016108ba90613c6f565b6001600160a01b0380841660008181526034602090815260408083209487168084529490915290819020849055517f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925906126d3908590613a4a565b60405180910390a3505050565b6001600160a01b0383166127065760405162461bcd60e51b81526004016108ba9061405c565b6001600160a01b03821661272c5760405162461bcd60e51b81526004016108ba90613b64565b612737838383612ce0565b61277a8160405180606001604052806026815260200161444f602691396001600160a01b038616600090815260336020526040902054919063ffffffff61280116565b6001600160a01b0380851660009081526033602052604080822093909355908416815220546127af908263ffffffff61285b16565b6001600160a01b0380841660008181526033602052604090819020939093559151908516907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef906126d3908590613a4a565b600081848411156128255760405162461bcd60e51b81526004016108ba9190613ad1565b505050900390565b600061103360405161283e9061376f565b604051809103902061284e612ce5565b612856612ceb565b612cf1565b6000828201838110156128805760405162461bcd60e51b81526004016108ba90613d32565b9392505050565b60d054604051638a8d885f60e01b81526001600160a01b0390911690638a8d885f906128bb90869086908690600401613963565b600060405180830381600087803b1580156128d557600080fd5b505af11580156128e9573d6000803e3d6000fd5b50505050505050565b5490565b600081815260d560205260408120600681015490915b8181101561196a57600083600601600001828154811061292857fe5b60009182526020822001546007860180546001600160a01b039092169350908490811061295157fe5b60009182526020909120015460d1546040516387227ab160e01b81529192506001600160a01b0316906387227ab19061299290339086908690600401613807565b600060405180830381600087803b1580156129ac57600080fd5b505af11580156129c0573d6000803e3d6000fd5b50506001909401935061290c92505050565b60006060856001600160a01b03166323b872dd8686866040516024016129fa93929190613807565b6040516020818303038152906040529060e01b6020820180516001600160e01b038381831617835250505050604051612a339190613738565b6000604051808303816000865af19150503d8060008114612a70576040519150601f19603f3d011682016040523d82523d6000602084013e612a75565b606091505b5091509150818015612a9f575080511580612a9f575080806020019051810190612a9f919061321b565b612abb5760405162461bcd60e51b81526004016108ba90614179565b505050505050565b60006060846001600160a01b031663a9059cbb8585604051602401612ae992919061382b565b6040516020818303038152906040529060e01b6020820180516001600160e01b038381831617835250505050604051612b229190613738565b6000604051808303816000865af19150503d8060008114612b5f576040519150601f19603f3d011682016040523d82523d6000602084013e612b64565b606091505b5091509150818015612b8e575080511580612b8e575080806020019051810190612b8e919061321b565b612baa5760405162461bcd60e51b81526004016108ba90613ba7565b5050505050565b6000612bbb61282d565b82604051602001612bcd929190613754565b604051602081830303815290604052805190602001209050919050565b60007f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0821115612c2c5760405162461bcd60e51b81526004016108ba90613dd7565b8360ff16601b1480612c4157508360ff16601c145b612c5d5760405162461bcd60e51b81526004016108ba90613edb565b600060018686868660405160008152602001604052604051612c829493929190613ab3565b6020604051602081039080840390855afa158015612ca4573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b03811661261f5760405162461bcd60e51b81526004016108ba90613b2d565b80546001019055565b505050565b60655490565b60665490565b6000838383612cfe612d32565b30604051602001612d13959493929190613a87565b6040516020818303038152906040528051906020012090509392505050565b4690565b6040518060e00160405280606081526020016000815260200160608152602001606081526020016060815260200160608152602001612d73612ecd565b905290565b828054828255906000526020600020908101928215612db3579160200282015b82811115612db3578251825591602001919060010190612d98565b50612dbf929150612ee7565b5090565b828054828255906000526020600020908101928215612e18579160200282015b82811115612e1857825182546001600160a01b0319166001600160a01b03909116178255602090920191600190910190612de3565b50612dbf929150612f01565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f10612e6557805160ff1916838001178555612db3565b82800160010185558215612db35791820182811115612db3578251825591602001919060010190612d98565b6040805160e081018252600080825260208201819052918101829052606081018290526080810182905260a0810182905260c081019190915290565b604051806040016040528060608152602001606081525090565b61088d91905b80821115612dbf5760008155600101612eed565b61088d91905b80821115612dbf5780546001600160a01b0319168155600101612f07565b803561098e81614436565b600082601f830112612f40578081fd5b8135612f53612f4e826143ea565b6143c3565b818152915060208083019084810181840286018201871015612f7457600080fd5b60005b84811015612f9357813584529282019290820190600101612f77565b505050505092915050565b600082601f830112612fae578081fd5b813567ffffffffffffffff811115612fc4578182fd5b612fd7601f8201601f19166020016143c3565b9150808252836020828501011115612fee57600080fd5b8060208401602084013760009082016020015292915050565b600060408284031215613018578081fd5b61302260406143c3565b9050813567ffffffffffffffff8082111561303c57600080fd5b81840185601f82011261304e57600080fd5b8035925061305e612f4e846143ea565b80848252602080830192508084018982838902870101111561307f57600080fd5b600094505b868510156130aa576130968a82612f25565b845260019490940193928101928101613084565b50818752808801359550848611156130c157600080fd5b6130cd89878a01612f30565b8188015250505050505092915050565b803560ff8116811461098e57600080fd5b6000602082840312156130ff578081fd5b813561288081614436565b6000806040838503121561311c578081fd5b823561312781614436565b9150602083013561313781614436565b809150509250929050565b600080600060608486031215613156578081fd5b833561316181614436565b9250602084013561317181614436565b929592945050506040919091013590565b600080600080600080600060e0888a03121561319c578283fd5b87356131a781614436565b965060208801356131b781614436565b955060408801359450606088013593506131d48960808a016130dd565b925060a0880135915060c0880135905092959891949750929550565b60008060408385031215613202578182fd5b823561320d81614436565b946020939093013593505050565b60006020828403121561322c578081fd5b81518015158114612880578182fd5b60006020828403121561324c578081fd5b815161288081614436565b600060208284031215613268578081fd5b813567ffffffffffffffff8082111561327f578283fd5b81840160e08187031215613291578384fd5b61329b60e06143c3565b92508035828111156132ab578485fd5b6132b787828401612f9e565b845250602081013560208401526040810135828111156132d5578485fd5b6132e187828401612f9e565b6040850152506060810135828111156132f8578485fd5b61330487828401612f30565b60608501525060808101358281111561331b578485fd5b61332787828401612f30565b60808501525060a08101358281111561333e578485fd5b61334a87828401612f30565b60a08501525060c081013582811115613361578485fd5b61336d87828401613007565b60c0850152509195945050505050565b600080600060608486031215613391578081fd5b833567ffffffffffffffff808211156133a8578283fd5b818601608081890312156133ba578384fd5b6133c460806143c3565b92508035828111156133d4578485fd5b6133e089828401612f9e565b8452506020810135828111156133f4578485fd5b61340089828401612f9e565b60208501525061341388604083016130dd565b60408401526134258860608301612f25565b606084015250508093505061343d8560208601612f25565b915061344c8560408601612f25565b90509250925092565b600060208284031215613466578081fd5b5035919050565b60006020828403121561347e578081fd5b5051919050565b60008060408385031215613497578182fd5b82359150602083013561313781614436565b600080604083850312156134bb578182fd5b82359150602083013567ffffffffffffffff8111156134d8578182fd5b6134e485828601612f30565b9150509250929050565b60008060408385031215613500578182fd5b82359150602083013567ffffffffffffffff81111561351d578182fd5b6134e485828601613007565b6000806040838503121561353b578182fd5b50508035926020909101359150565b60008060006060848603121561355e578081fd5b8335925060208401359150604084013567ffffffffffffffff811115613582578182fd5b61358e86828701612f30565b9150509250925092565b6000815180845260208085019450808401835b838110156135c7578151875295820195908201906001016135ab565b509495945050505050565b6000815480845260208085019450838352808320835b838110156135c7578154875295820195600191820191016135e8565b6000815180845261361c81602086016020860161440a565b601f01601f19169290920160200192915050565b6000815160e0845261364560e0850182613604565b602084015160208601526040840151915084810360408601526136688183613604565b6060850151925085810360608701526136818184613598565b91505060808401519150848103608086015261369d8183613598565b60a0850151925085810360a08701526136b68184613598565b91505060c0840151915084810360c086015261261f81835b805160408084528151908401819052600091602091839160608701919084015b818410156137155780516001600160a01b03168352600193909301929184019184016136ee565b50508285015191508581038387015261372e8183613598565b9695505050505050565b6000825161374a81846020870161440a565b9190910192915050565b61190160f01b81526002810192909252602282015260420190565b7f454950373132446f6d61696e28737472696e67206e616d652c737472696e672081527f76657273696f6e2c75696e7432353620636861696e49642c6164647265737320602082015271766572696679696e67436f6e74726163742960701b604082015260520190565b6001600160a01b0391909116815260200190565b6001600160a01b0392831681529116602082015260400190565b6001600160a01b039384168152919092166020820152604081019190915260600190565b6001600160a01b03929092168252602082015260400190565b6001600160a01b039485168152602081019390935292166040820152606081019190915260800190565b600060018060a01b03861682528460208301526080604083015261389560808301856135d2565b82810360608401526138a78185613598565b979650505050505050565b600060018060a01b038816825286602083015260c060408301526138d960c08301876135d2565b82810360608401526138eb81876135d2565b85608085015283810360a08501526139038186613598565b9a9950505050505050505050565b600060018060a01b038816825286602083015285604083015284606083015260c0608083015261394460c08301856135d2565b82810360a084015261395681856135d2565b9998505050505050505050565b6001600160a01b039390931683526020830191909152604082015260600190565b6001600160a01b03978816815295871660208701529386166040860152918516606085015284166080840152831660a083015290911660c082015260e00190565b60006040820160408352808551808352606085019150602092506060838202860101838801855b83811015613a1a57605f19888403018552613a08838351613630565b948601949250908501906001016139ec565b50509290940194909452949350505050565b6000602082526128806020830184613598565b901515815260200190565b90815260200190565b9586526001600160a01b0394851660208701529290931660408501526060840152608083019190915260a082015260c00190565b9485526020850193909352604084019190915260608301526001600160a01b0316608082015260a00190565b93845260ff9290921660208401526040830152606082015260800190565b6000602082526128806020830184613604565b600060808252613af76080830187613604565b8560208401528281036040840152613b0f8186613604565b8381036060850152613b2181866136ce565b98975050505050505050565b60208082526018908201527f45434453413a20696e76616c6964207369676e61747572650000000000000000604082015260600190565b60208082526023908201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260408201526265737360e81b606082015260800190565b6020808252601f908201527f5472616e7366657248656c7065723a205452414e534645525f4641494c454400604082015260600190565b6020808252602b908201527f426c696e64426f78204572723a4f6e6c7920647261772074686520737065636960408201526a3334b2b210373ab6b132b960a91b606082015260800190565b60208082526026908201527f426c696e64426f78204572723a43616e206e6f742062652072652d696e697469604082015265185b1a5e995960d21b606082015260800190565b60208082526022908201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604082015261737360f01b606082015260800190565b6020808252818101527f426c696e64426f78204572723a20426f7820616c726561647920657869737473604082015260600190565b6020808252602c908201527f426c696e64426f78204572723a696e76697465722063616e6e6f74206571756160408201526b6c206164647265737328302960a01b606082015260800190565b6020808252601b908201527f536166654d6174683a206164646974696f6e206f766572666c6f770000000000604082015260600190565b6020808252601d908201527f45524332305065726d69743a206578706972656420646561646c696e65000000604082015260600190565b6020808252601e908201527f426c696e64426f78204572723a20736572696573206e6f7420666f756e640000604082015260600190565b60208082526022908201527f45434453413a20696e76616c6964207369676e6174757265202773272076616c604082015261756560f01b606082015260800190565b6020808252601b908201527f426c696e64426f78204572723a72657175657374206661696c65640000000000604082015260600190565b60208082526029908201527f426c696e64426f78204572723a204f6e6c7920726563656976652035206e6674604082015268081d1bdad95b881a5960ba1b606082015260800190565b60208082526022908201527f426c696e64426f7820204572723a477261646520646f6573206e6f74206578696040820152611cdd60f21b606082015260800190565b60208082526022908201527f45434453413a20696e76616c6964207369676e6174757265202776272076616c604082015261756560f01b606082015260800190565b60208082526032908201527f426c696e64426f78204572723a2072657761726420746f6b656e206e6f7420656040820152711c5d585b081c995dd85c9908185b5bdd5b9d60721b606082015260800190565b6020808252601e908201527f45524332305065726d69743a20696e76616c6964207369676e61747572650000604082015260600190565b60208082526029908201527f426c696e64426f78204572723a616d6f756e742063616e6e6f74207468616e20604082015268616c6c6f77616e636560b81b606082015260800190565b60208082526047908201527f426c696e64426f78204572723a20496d6167654c696e6b206c656e677468206d60408201527f75737420626520736d616c6c207468616e204d41585f494d4147455f4c494e4b6060820152660be988a9c8ea8960cb1b608082015260a00190565b60208082526025908201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604082015264647265737360d81b606082015260800190565b6020808252601a908201527f426c696e64426f78204572723a20556e617574686f72757a6564000000000000604082015260600190565b60208082526024908201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646040820152637265737360e01b606082015260800190565b60208082526039908201527f426c696e64426f78204572723a206e616d65206c656e677468206d757374206260408201527f65206c657373207468616e204d494e5f4e414d455f4e414d4500000000000000606082015260800190565b60208082526024908201527f5472616e7366657248656c7065723a205452414e534645525f46524f4d5f46416040820152631253115160e21b606082015260800190565b60208082526035908201527f426c696e64426f78204572723a64726177206e756d6265722063616e206f6e6c60408201527407920626520657175616c20746f2031206f7220313605c1b606082015260800190565b60208082526046908201527f426c696e64426f78204572723a20496d6167654c696e6b206c656e677468206d60408201527f757374206265206c657373207468616e204d494e5f494d4147455f4c494e4b5f6060820152650988a9c8ea8960d31b608082015260a00190565b6000602082526128806020830184613630565b81516001600160a01b03908116825260208084015182169083015260408084015182169083015260608084015182169083015260808084015182169083015260a08381015182169083015260c092830151169181019190915260e00190565b60006020825282516080602084015261430c60a0840182613604565b6020850151848203601f1901604086015291506143298183613604565b60ff604087015116606086015260018060a01b03606087015116608086015280935050505092915050565b60008382526040602083015261436d6040830184613598565b949350505050565b60008382526040602083015261436d6040830184613604565b60008382526040602083015261436d60408301846136ce565b918252602082015260400190565b60ff91909116815260200190565b60405181810167ffffffffffffffff811182821017156143e257600080fd5b604052919050565b600067ffffffffffffffff821115614400578081fd5b5060209081020190565b60005b8381101561442557818101518382015260200161440d565b8381111561196a5750506000910152565b6001600160a01b038116811461444b57600080fd5b5056fe45524332303a207472616e7366657220616d6f756e7420657863656564732062616c616e636545524332303a207472616e7366657220616d6f756e74206578636565647320616c6c6f77616e636545524332303a2064656372656173656420616c6c6f77616e63652062656c6f77207a65726fa26469706673582212201b13faaabebb7332f3e70bc37e50fb4aeee3c51453443b73aced911f47d380d364736f6c6343000605003300000000000000000000000036b398c09b130b558c23ab94b4146f8911d6a8f100000000000000000000000036b398c09b130b558c23ab94b4146f8911d6a8f10000000000000000000000009f9eaa5175988d45004a281588b65f9050e258730000000000000000000000002933bc1bd07cbbff8753f9d0f82c456a8ae64196000000000000000000000000c15213447375ce9aea14e5ff6b0d3733698ebf81",
         "contractAddress":"0x1a73c6c04bbc0ad52cd079b657553eaa30a26e61",
         "cumulativeGasUsed":"4154992",
         "gasUsed":"4023674",
         "confirmations":"200"
      },
      {
         "blockNumber":"12379932",
         "timeStamp":"1631686255",
         "hash":"0xfe84c0b9ea35b8ac0a6cc9a0c18dd325f75d3633f7e6200a5a39d553f46a8848",
         "nonce":"34648",
         "blockHash":"0x115c419f260fc3182821f4672ba6acc50e16b86864552e6946a359daed59910b",
         "transactionIndex":"5",
         "from":"0x36b398c09b130b558c23ab94b4146f8911d6a8f1",
         "to":"0x1a73c6c04bbc0ad52cd079b657553eaa30a26e61",
         "value":"0",
         "gas":"10500000",
         "gasPrice":"10000000000",
         "isError":"0",
         "txreceipt_status":"1",
         "input":"0x076ac3230000000000000000000000000000000000000000000000000000000000000060000000000000000000000000b2283c4ab3430aa8436c15ebd991707091d6f959000000000000000000000000e533ff8d8a71e106c2340dccba89eb3a8bad1191000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000000120000000000000000000000001a73c6c04bbc0ad52cd079b657553eaa30a26e610000000000000000000000000000000000000000000000000000000000000007506978204b65790000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000065069784b65790000000000000000000000000000000000000000000000000000",
         "contractAddress":"",
         "cumulativeGasUsed":"984495",
         "gasUsed":"333594",
         "confirmations":"83"
      }
   ]
}

Get a list of 'Internal' Transactions by Address

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-testnet.bscscan.com/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 🔗

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":"90",
         "timeStamp":"1594281741",
         "hash":"0x26869ad98bdd302e5fd545e56b4288e1c0e87e5ba1223ccda6615d65e0d5596b",
         "from":"0x0000000000000000000000000000000000002000",
         "to":"0x0000000000000000000000000000000000001004",
         "value":"0",
         "contractAddress":"",
         "input":"",
         "type":"call",
         "gas":"4544051",
         "gasUsed":"46105",
         "traceId":"0_1",
         "isError":"0",
         "errCode":""
      },
      {
         "blockNumber":"90",
         "timeStamp":"1594281741",
         "hash":"0x26869ad98bdd302e5fd545e56b4288e1c0e87e5ba1223ccda6615d65e0d5596b",
         "from":"0x0000000000000000000000000000000000001004",
         "to":"0xfa5e36a04eef3152092099f352ddbe88953bb540",
         "value":"300000000000000000000",
         "contractAddress":"",
         "input":"",
         "type":"call",
         "gas":"2300",
         "gasUsed":"0",
         "traceId":"0_1_1",
         "isError":"0",
         "errCode":""
      }
   ]
}

Get 'Internal Transactions' by Transaction Hash

Returns the list of internal transactions performed within a transaction.

📝 Note : This API endpoint returns a maximum of 10000 records only.

https://api-testnet.bscscan.com/api
   ?module=account
   &action=txlistinternal
   &txhash=0x409f02de7e636d38f7e17fe00ead583fe146399fef50d6b52fa380b247b1ccba
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

Parameter

Description

txhash

the string representing the transaction hash to check for internal transactions

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "blockNumber":"12380027",
         "timeStamp":"1631686540",
         "from":"0xae13d989dac2f0debff460ac112a837c89baa7cd",
         "to":"0x9ac64cc6e4415144c455bd8e4837fea55603e5c3",
         "value":"15064384117144",
         "contractAddress":"",
         "input":"",
         "type":"call",
         "gas":"2300",
         "gasUsed":"95",
         "isError":"0",
         "errCode":""
      },
      {
         "blockNumber":"12380027",
         "timeStamp":"1631686540",
         "from":"0x9ac64cc6e4415144c455bd8e4837fea55603e5c3",
         "to":"0x0e27e6f4b86ef027bfc21ed7d2acb3747d3d84aa",
         "value":"15064384117144",
         "contractAddress":"",
         "input":"",
         "type":"call",
         "gas":"1071188",
         "gasUsed":"55",
         "isError":"0",
         "errCode":""
      }
   ]
}

The isError field returns 0 for successful transactions and 1 for rejected/cancelled transactions.

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-testnet.bscscan.com/api
   ?module=account
   &action=txlistinternal
   &startblock=0
   &endblock=2702578
   &page=1
   &offset=10
   &sort=asc
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

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":"90",
         "timeStamp":"1594281741",
         "hash":"0xd12ceb6c6a51296de5ffa5cb9a0b82a1eefd0c42d2294a9b8ec53ea0a12a3ad5",
         "from":"0x0000000000000000000000000000000000001003",
         "to":"0x0000000000000000000000000000000000001006",
         "value":"0",
         "contractAddress":"",
         "input":"",
         "type":"staticcall",
         "gas":"4577834",
         "gasUsed":"1200",
         "traceId":"0_1",
         "isError":"0",
         "errCode":""
      },
      {
         "blockNumber":"90",
         "timeStamp":"1594281741",
         "hash":"0x26869ad98bdd302e5fd545e56b4288e1c0e87e5ba1223ccda6615d65e0d5596b",
         "from":"0x0000000000000000000000000000000000002000",
         "to":"0x0000000000000000000000000000000000001006",
         "value":"0",
         "contractAddress":"",
         "input":"",
         "type":"staticcall",
         "gas":"4589844",
         "gasUsed":"1200",
         "traceId":"0_1",
         "isError":"0",
         "errCode":""
      }
   ]
}

The isError field returns 0 for successful transactions and 1 for rejected/cancelled transactions.

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.

https://api-testnet.bscscan.com/api
   ?module=account
   &action=tokentx
   &contractaddress=0xe02df9e3e622debdd69fb838bb799e3f168902c5
   &address=0x0c82922944350ffe0ec8ad1f08995ae0eed10e75
   &page=1
   &offset=5
   &sort=asc
   &apikey=YourApiKeyToken

Usage:

BEP-20 transfers from an address, specify the address parameter
BEP-20 transfers from a contract address, specify the contract address parameter
BEP-20 transfers from an address filtered by a token contract, specify both address and contract address parameters.

Try this endpoint in your browser 🔗

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

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "blockNumber":"3282661",
         "timeStamp":"1604226469",
         "hash":"0x8ca90f80233d94500462d7044ff4e98206f1fc3036b0654944437ca0117de88c",
         "nonce":"12",
         "blockHash":"0x8fa82d2129cd9627d322b26adb8309c110bcea535cadb5b9aa844092a5c27e95",
         "from":"0x47d34fd4f095767e718f110afef030bb18e8c48f",
         "to":"0x0c82922944350ffe0ec8ad1f08995ae0eed10e75",
         "contractAddress":"0xe02df9e3e622debdd69fb838bb799e3f168902c5",
         "value":"50000000000000000000",
         "tokenName":"BakeryToken",
         "tokenSymbol":"BAKE",
         "tokenDecimal":"18",
         "transactionIndex":"0",
         "gas":"172953",
         "gasPrice":"20000000000",
         "gasUsed":"131952",
         "cumulativeGasUsed":"131952",
         "input":"deprecated",
         "confirmations":"9097506"
      },
      {
         "blockNumber":"3282745",
         "timeStamp":"1604226721",
         "hash":"0xdbd57a6e059595ad7ff8e1976559305be268eda49d788d76b582d57f7ec41993",
         "nonce":"13",
         "blockHash":"0xa0a305cf59427e5646fd60151455253e7d33f3fc5cf69430089a9b6e5a1d34c7",
         "from":"0x47d34fd4f095767e718f110afef030bb18e8c48f",
         "to":"0x0c82922944350ffe0ec8ad1f08995ae0eed10e75",
         "contractAddress":"0xe02df9e3e622debdd69fb838bb799e3f168902c5",
         "value":"60000000000000000000",
         "tokenName":"BakeryToken",
         "tokenSymbol":"BAKE",
         "tokenDecimal":"18",
         "transactionIndex":"0",
         "gas":"156453",
         "gasPrice":"20000000000",
         "gasUsed":"116952",
         "cumulativeGasUsed":"116952",
         "input":"deprecated",
         "confirmations":"9097422"
      },
      {
         "blockNumber":"3282822",
         "timeStamp":"1604226952",
         "hash":"0x204e2ac33a9d82621245954bc535f5284ab9c5f9566ecb40bcf235ff86b75427",
         "nonce":"15",
         "blockHash":"0xef3d324ce0948fab049baa4a0cd05a563f38b6fd8f7216766088e448e1e9bbd5",
         "from":"0x0c82922944350ffe0ec8ad1f08995ae0eed10e75",
         "to":"0x47d34fd4f095767e718f110afef030bb18e8c48f",
         "contractAddress":"0xe02df9e3e622debdd69fb838bb799e3f168902c5",
         "value":"110000000000000000000",
         "tokenName":"BakeryToken",
         "tokenSymbol":"BAKE",
         "tokenDecimal":"18",
         "transactionIndex":"0",
         "gas":"230481",
         "gasPrice":"20000000000",
         "gasUsed":"168209",
         "cumulativeGasUsed":"168209",
         "input":"deprecated",
         "confirmations":"9097345"
      },
      {
         "blockNumber":"3313168",
         "timeStamp":"1604324243",
         "hash":"0x42de16f1d5d4f1e9b7695b3cc79f69bc287fa059eee8ac007599844b2ff0628b",
         "nonce":"24",
         "blockHash":"0x4cd4b2d491a28a48557dcbee8e56ed52b944a675197ff49ddd9e0d4fe0cdbf09",
         "from":"0x20ec291bb8459b6145317e7126532ce7ece5056f",
         "to":"0x0c82922944350ffe0ec8ad1f08995ae0eed10e75",
         "contractAddress":"0xe02df9e3e622debdd69fb838bb799e3f168902c5",
         "value":"8086453083926055672998",
         "tokenName":"BakeryToken",
         "tokenSymbol":"BAKE",
         "tokenDecimal":"18",
         "transactionIndex":"0",
         "gas":"219513",
         "gasPrice":"20000000000",
         "gasUsed":"146342",
         "cumulativeGasUsed":"146342",
         "input":"deprecated",
         "confirmations":"9066999"
      },
      {
         "blockNumber":"3313231",
         "timeStamp":"1604324432",
         "hash":"0x261c1b4dbf9ee6c4e4799bbc80bd9f568f1282d22698acc338e3a6b7ea3cab4a",
         "nonce":"26",
         "blockHash":"0x423fd1b62ee6d3ecc265a59c8c9d127b48f7077eeaf7f0f1b1fbfbdf260c223b",
         "from":"0x0c82922944350ffe0ec8ad1f08995ae0eed10e75",
         "to":"0xf9e89b5aca2e6061d22ea98cbcc2d826e3f9e4b1",
         "contractAddress":"0xe02df9e3e622debdd69fb838bb799e3f168902c5",
         "value":"61700000000000000000",
         "tokenName":"BakeryToken",
         "tokenSymbol":"BAKE",
         "tokenDecimal":"18",
         "transactionIndex":"1",
         "gas":"411316",
         "gasPrice":"20000000000",
         "gasUsed":"154211",
         "cumulativeGasUsed":"205293",
         "input":"deprecated",
         "confirmations":"9066936"
      }
   ]
}

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.

https://api-testnet.bscscan.com/api
   ?module=account
   &action=tokennfttx
   &contractaddress=0xc0fed25b8f04f6205308ccb72d19aaf647a4ef36
   &address=0x238cab5406ca9d66982f8eceb85e3034dd01f865
   &page=1
   &offset=100
   &sort=asc
   &apikey=YourApiKeyToken

Usage:

BEP-721 transfers from an address, specify the address parameter
BEP-721 transfers from a contract address, specify the contract address parameter
BEP-721 transfers from an address filtered by a token contract, specify both address and contract address parameters.

Try this endpoint in your browser 🔗

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

sort

the sorting preference, use asc to sort by ascending and desc to sort by descending

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "blockNumber":"9583651",
         "timeStamp":"1623248278",
         "hash":"0xdb640eab4c4df13631db86917260a6e3376b7101c77b62bb01fc77cfb97f50bf",
         "nonce":"1107",
         "blockHash":"0x7bbea468ef172e45da16913facae1f678941c935a0ace65372cca6a74250a718",
         "from":"0x0000000000000000000000000000000000000000",
         "contractAddress":"0xc0fed25b8f04f6205308ccb72d19aaf647a4ef36",
         "to":"0x238cab5406ca9d66982f8eceb85e3034dd01f865",
         "tokenID":"1",
         "tokenName":"wazirXNFT",
         "tokenSymbol":"WRXNFT",
         "tokenDecimal":"0",
         "transactionIndex":"5",
         "gas":"404880",
         "gasPrice":"10000000000",
         "gasUsed":"266153",
         "cumulativeGasUsed":"621310",
         "input":"deprecated",
         "confirmations":"2796582"
      },
      {
         "blockNumber":"9583672",
         "timeStamp":"1623248341",
         "hash":"0xf3f833580c4a796b3e514c3839b9fa5dd0e5c23f45a25d98659dd9637f6aadd5",
         "nonce":"1109",
         "blockHash":"0xa32b9d915799db7c2ac3bf3d5e66d1152262693a91780201996927ecde976e34",
         "from":"0x238cab5406ca9d66982f8eceb85e3034dd01f865",
         "contractAddress":"0xc0fed25b8f04f6205308ccb72d19aaf647a4ef36",
         "to":"0xf5c7257029362e9c44cf1eea917b13bc6a5d208b",
         "tokenID":"1",
         "tokenName":"wazirXNFT",
         "tokenSymbol":"WRXNFT",
         "tokenDecimal":"0",
         "transactionIndex":"7",
         "gas":"356616",
         "gasPrice":"10000000000",
         "gasUsed":"185439",
         "cumulativeGasUsed":"2821124",
         "input":"deprecated",
         "confirmations":"2796561"
      }
   ]
}

Get list of Blocks Validated by Address

Returns the list of blocks validated by an address.

https://api-testnet.bscscan.com/api
   ?module=account
   &action=getminedblocks
   &address=0xa2959d3f95eae5dc7d70144ce1b73b403b7eb6e0
   &blocktype=blocks
   &page=1
   &offset=10
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

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":"12380238",
         "timeStamp":"1631687173",
         "blockReward":"8944870000000000"
      },
      {
         "blockNumber":"12380231",
         "timeStamp":"1631687152",
         "blockReward":"5686530000000000"
      },
      {
         "blockNumber":"12380224",
         "timeStamp":"1631687131",
         "blockReward":"12808230000000000"
      }
   ]
}

⌛ Note : The timeStamp is represented in Unix timestamp.

PreviousTestnet BscScan NextContracts

Last updated 2 years ago