Accounts
Last updated
Last updated
Returns the Ether balance of a given address.
https://api.basescan.org/api
?module=account
&action=balance
&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae
&tag=latest
&apikey=YourApiKeyTokenTry this endpoint in your browser
Query Parameters
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":"1000000000000000"
} Tip: The result is returned in wei.
Convert Ethereum units using our Unit Converter.
Returns the balance of the accounts from a list of addresses.
https://api.basescan.org/api
?module=account
&action=balancemulti
&address=0x449E1f27Af28b603bDcf3D13d46d68090723536b,0xB8FF877ed78Ba520Ece21B1de7843A8a57cA47Cb,0x198ef1ec325a96cc354c7266a038be8b5c558f67
&tag=latest
&apikey=YourApiKeyTokenQuery Parameters
address
the strings representing the addresses to check for balance, separated by ,
up to 20 addresses per call
tag
the integer pre-defined block parameter, either earliest, pending or latest
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"account":"0x449E1f27Af28b603bDcf3D13d46d68090723536b",
"balance":"7147856994619854"
},
{
"account":"0xB8FF877ed78Ba520Ece21B1de7843A8a57cA47Cb",
"balance":"7441490536986433596"
},
{
"account":"0x198ef1ec325a96cc354c7266a038be8b5c558f67",
"balance":"0"
}
]
}📖 Tip: The result is returned in wei.
Convert Ethereum units using our Unit Converter.
Returns the list of transactions performed by an address, with optional pagination.
https://api.basescan.org/api
?module=account
&action=txlist
&address=0xc5102fE9359FD9a28f877a67E36B0F050d81a3CC
&startblock=0
&endblock=99999999
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyTokenQuery Parameters
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 descendin Tip: Specify a smaller startblock and endblock range for faster search results.
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"1801040",
"timeStamp":"1690391427",
"hash":"0x4272e90c6253ff30add0e6cc18309639437d37e639ad7d8d13a62d7c0619ae25",
"nonce":"1",
"blockHash":"0x3733c3df6d36dd2f080b94a36e77f9598d3239e821d3649a194d775e2e65bf2c",
"transactionIndex":"1",
"from":"0x9aa99c23f67c81701c772b106b4f83f6e858dd2e",
"to":"",
"value":"0",
"gas":"5000000",
"gasPrice":"10000000000",
"isError":"0",
"txreceipt_status":"1",
"input":"0x6101606040527f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9610140908152503480156200003a57600080fd5b506040518060400160405280600381526020017f486f700000000000000000000000000000000000000000000000000000000000815250806040518060400160405280600181526020017f31000000000000000000000000000000000000000000000000000000000000008152506040518060400160405280600381526020017f486f7000000000000000000000000000000000000000000000000000000000008152506040518060400160405280600381526020017f484f500000000000000000000000000000000000000000000000000000000000815250816003908162000125919062000597565b50806004908162000137919062000597565b50505060008280519060200120905060008280519060200120905060007f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f90508260e081815250508161010081815250504660a08181525050620001a38184846200021360201b60201c565b608081815250503073ffffffffffffffffffffffffffffffffffffffff1660c08173ffffffffffffffffffffffffffffffffffffffff16815250508061012081815250505050505050506200020d620002016200024f60201b60201c565b6200025760201b60201c565b6200074c565b6000838383463060405160200162000230959493929190620006ef565b6040516020818303038152906040528051906020012090509392505050565b600033905090565b6000600960009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905081600960006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b600081519050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806200039f57607f821691505b602082108103620003b557620003b462000357565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b6000600883026200041f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82620003e0565b6200042b8683620003e0565b95508019841693508086168417925050509392505050565b6000819050919050565b6000819050919050565b600062000478620004726200046c8462000443565b6200044d565b62000443565b9050919050565b6000819050919050565b620004948362000457565b620004ac620004a3826200047f565b848454620003ed565b825550505050565b600090565b620004c3620004b4565b620004d081848462000489565b505050565b5b81811015620004f857620004ec600082620004b9565b600181019050620004d6565b5050565b601f82111562000547576200051181620003bb565b6200051c84620003d0565b810160208510156200052c578190505b620005446200053b85620003d0565b830182620004d5565b50505b505050565b600082821c905092915050565b60006200056c600019846008026200054c565b1980831691505092915050565b600062000587838362000559565b9150826002028217905092915050565b620005a2826200031d565b67ffffffffffffffff811115620005be57620005bd62000328565b5b620005ca825462000386565b620005d7828285620004fc565b600060209050601f8311600181146200060f5760008415620005fa578287015190505b62000606858262000579565b86555062000676565b601f1984166200061f86620003bb565b60005b82811015620006495784890151825560018201915060208501945060208101905062000622565b8683101562000669578489015162000665601f89168262000559565b8355505b6001600288020188555050505b505050505050565b6000819050919050565b62000693816200067e565b82525050565b620006a48162000443565b82525050565b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000620006d782620006aa565b9050919050565b620006e981620006ca565b82525050565b600060a08201905062000706600083018862000688565b62000715602083018762000688565b62000724604083018662000688565b62000733606083018562000699565b620007426080830184620006de565b9695505050505050565b60805160a05160c05160e051610100516101205161014051614072620007a76000396000610f780152600061188b015260006118cd015260006118ac015260006117e1015260006118370152600061186001526140726000f3fe608060405234801561001057600080fd5b50600436106101a95760003560e01c8063715018a6116100f9578063a457c2d711610097578063d505accf11610071578063d505accf1461051c578063dd62ed3e14610538578063f1127ed814610568578063f2fde38b14610598576101a9565b8063a457c2d7146104a0578063a9059cbb146104d0578063c3cda52014610500576101a9565b80638e539e8c116100d35780638e539e8c1461040657806395d89b41146104365780639ab24eb0146104545780639dc29fac14610484576101a9565b8063715018a6146103ae5780637ecebe00146103b85780638da5cb5b146103e8576101a9565b80633950935111610166578063587cde1e11610140578063587cde1e146103025780635c19a95c146103325780636fcfff451461034e57806370a082311461037e576101a9565b806339509351146102865780633a46b1a8146102b657806340c10f19146102e6576101a9565b806306fdde03146101ae578063095ea7b3146101cc57806318160ddd146101fc57806323b872dd1461021a578063313ce5671461024a5780633644e51514610268575b600080fd5b6101b66105b4565b6040516101c39190612aa3565b60405180910390f35b6101e660048036038101906101e19190612b5e565b610646565b6040516101f39190612bb9565b60405180910390f35b610204610669565b6040516102119190612be3565b60405180910390f35b610234600480360381019061022f9190612bfe565b610673565b6040516102419190612bb9565b60405180910390f35b6102526106a2565b60405161025f9190612c6d565b60405180910390f35b6102706106ab565b60405161027d9190612ca1565b60405180910390f35b6102a0600480360381019061029b9190612b5e565b6106ba565b6040516102ad9190612bb9565b60405180910390f35b6102d060048036038101906102cb9190612b5e565b610764565b6040516102dd9190612be3565b60405180910390f35b61030060048036038101906102fb9190612b5e565b6107f8565b005b61031c60048036038101906103179190612cbc565b610882565b6040516103299190612cf8565b60405180910390f35b61034c60048036038101906103479190612cbc565b6108eb565b005b61036860048036038101906103639190612cbc565b6108ff565b6040516103759190612d32565b60405180910390f35b61039860048036038101906103939190612cbc565b610953565b6040516103a59190612be3565b60405180910390f35b6103b661099b565b005b6103d260048036038101906103cd9190612cbc565b610a23565b6040516103df9190612be3565b60405180910390f35b6103f0610a73565b6040516103fd9190612cf8565b60405180910390f35b610420600480360381019061041b9190612d4d565b610a9d565b60405161042d9190612be3565b60405180910390f35b61043e610af3565b60405161044b9190612aa3565b60405180910390f35b61046e60048036038101906104699190612cbc565b610b85565b60405161047b9190612be3565b60405180910390f35b61049e60048036038101906104999190612b5e565b610c96565b005b6104ba60048036038101906104b59190612b5e565b610d20565b6040516104c79190612bb9565b60405180910390f35b6104ea60048036038101906104e59190612b5e565b610e0a565b6040516104f79190612bb9565b60405180910390f35b61051a60048036038101906105159190612dd2565b610e2d565b005b61053660048036038101906105319190612e5f565b610f31565b005b610552600480360381019061054d9190612f01565b611073565b60405161055f9190612be3565b60405180910390f35b610582600480360381019061057d9190612f6d565b6110fa565b60405161058f9190613022565b60405180910390f35b6105b260048036038101906105ad9190612cbc565b61120a565b005b6060600380546105c39061306c565b80601f01602080910402602001604051908101604052809291908181526020018280546105ef9061306c565b801561063c5780601f106106115761010080835404028352916020019161063c565b820191906000526020600020905b81548152906001019060200180831161061f57829003601f168201915b5050505050905090565b600080610651611301565b905061065e818585611309565b600191505092915050565b6000600254905090565b60008061067e611301565b905061068b8582856114d2565b61069685858561155e565b60019150509392505050565b60006012905090565b60006106b56117dd565b905090565b6000806106c5611301565b9050610759818585600160008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008973ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205461075491906130cc565b611309565b600191505092915050565b60004382106107a8576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161079f9061314c565b60405180910390fd5b6107f0600760008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020836118f7565b905092915050565b610800611301565b73ffffffffffffffffffffffffffffffffffffffff1661081e610a73565b73ffffffffffffffffffffffffffffffffffffffff1614610874576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161086b906131b8565b60405180910390fd5b61087e8282611a03565b5050565b6000600660008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b6108fc6108f6611301565b82611a11565b50565b600061094c600760008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002080549050611b2b565b9050919050565b60008060008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020549050919050565b6109a3611301565b73ffffffffffffffffffffffffffffffffffffffff166109c1610a73565b73ffffffffffffffffffffffffffffffffffffffff1614610a17576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610a0e906131b8565b60405180910390fd5b610a216000611b7e565b565b6000610a6c600560008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020611c44565b9050919050565b6000600960009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b6000438210610ae1576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610ad89061314c565b60405180910390fd5b610aec6008836118f7565b9050919050565b606060048054610b029061306c565b80601f0160208091040260200160405190810160405280929190818152602001828054610b2e9061306c565b8015610b7b5780601f10610b5057610100808354040283529160200191610b7b565b820191906000526020600020905b815481529060010190602001808311610b5e57829003601f168201915b5050505050905090565b600080600760008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002080549050905060008114610c6d57600760008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600182610c2191906131d8565b81548110610c3257610c3161320c565b5b9060005260206000200160000160049054906101000a90047bffffffffffffffffffffffffffffffffffffffffffffffffffffffff16610c70565b60005b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff16915050919050565b610c9e611301565b73ffffffffffffffffffffffffffffffffffffffff16610cbc610a73565b73ffffffffffffffffffffffffffffffffffffffff1614610d12576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610d09906131b8565b60405180910390fd5b610d1c8282611c52565b5050565b600080610d2b611301565b90506000600160008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054905083811015610df1576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610de8906132ad565b60405180910390fd5b610dfe8286868403611309565b60019250505092915050565b600080610e15611301565b9050610e2281858561155e565b600191505092915050565b83421115610e70576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610e6790613319565b60405180910390fd5b6000610ed2610eca7fe48329057bfd03d55e49b547132e39cffd9c1820ad7b9d4c5307691425d15adf898989604051602001610eaf9493929190613339565b60405160208183030381529060405280519060200120611c60565b858585611c7a565b9050610edd81611ca5565b8614610f1e576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610f15906133ca565b60405180910390fd5b610f288188611a11565b50505050505050565b83421115610f74576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610f6b90613436565b60405180910390fd5b60007f0000000000000000000000000000000000000000000000000000000000000000888888610fa38c611ca5565b89604051602001610fb996959493929190613456565b6040516020818303038152906040528051906020012090506000610fdc82611c60565b90506000610fec82878787611c7a565b90508973ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff161461105c576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161105390613503565b60405180910390fd5b6110678a8a8a611309565b50505050505050505050565b6000600160008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054905092915050565b6111026129d5565b600760008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000208263ffffffff16815481106111595761115861320c565b5b906000526020600020016040518060400160405290816000820160009054906101000a900463ffffffff1663ffffffff1663ffffffff1681526020016000820160049054906101000a90047bffffffffffffffffffffffffffffffffffffffffffffffffffffffff167bffffffffffffffffffffffffffffffffffffffffffffffffffffffff167bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1681525050905092915050565b611212611301565b73ffffffffffffffffffffffffffffffffffffffff16611230610a73565b73ffffffffffffffffffffffffffffffffffffffff1614611286576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161127d906131b8565b60405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16036112f5576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016112ec90613595565b60405180910390fd5b6112fe81611b7e565b50565b600033905090565b600073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1603611378576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161136f90613627565b60405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16036113e7576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016113de906136b9565b60405180910390fd5b80600160008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925836040516114c59190612be3565b60405180910390a3505050565b60006114de8484611073565b90507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8114611558578181101561154a576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161154190613725565b60405180910390fd5b6115578484848403611309565b5b50505050565b600073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16036115cd576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016115c4906137b7565b60405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff160361163c576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161163390613849565b60405180910390fd5b611647838383611d03565b60008060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020549050818110156116cd576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016116c4906138db565b60405180910390fd5b8181036000808673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002081905550816000808573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825461176091906130cc565b925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040516117c49190612be3565b60405180910390a36117d7848484611d08565b50505050565b60007f000000000000000000000000000000000000000000000000000000000000000073ffffffffffffffffffffffffffffffffffffffff163073ffffffffffffffffffffffffffffffffffffffff1614801561185957507f000000000000000000000000000000000000000000000000000000000000000046145b15611886577f000000000000000000000000000000000000000000000000000000000000000090506118f4565b6118f17f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f0000000000000000000000000000000000000000000000000000000000000000611d18565b90505b90565b6000808380549050905060005b818110156119765760006119188284611d52565b90508486828154811061192e5761192d61320c565b5b9060005260206000200160000160009054906101000a900463ffffffff1663ffffffff16111561196057809250611970565b60018161196d91906130cc565b91505b50611904565b600082146119d8578460018361198c91906131d8565b8154811061199d5761199c61320c565b5b9060005260206000200160000160049054906101000a90047bffffffffffffffffffffffffffffffffffffffffffffffffffffffff166119db565b60005b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff169250505092915050565b611a0d8282611d78565b5050565b6000611a1c83610882565b90506000611a2984610953565b905082600660008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508273ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff167f3134e8a2e6d97e929a7e54011ea5485d7d196dd5f0ba4d4ef95803e8e3fc257f60405160405180910390a4611b25828483611e05565b50505050565b600063ffffffff8016821115611b76576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611b6d9061396d565b60405180910390fd5b819050919050565b6000600960009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905081600960006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b600081600001549050919050565b611c5c8282611ffe565b5050565b6000611c73611c6d6117dd565b8361201c565b9050919050565b6000806000611c8b8787878761204f565b91509150611c988161215b565b8192505050949350505050565b600080600560008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000209050611cf281611c44565b9150611cfd81612327565b50919050565b505050565b611d1383838361233d565b505050565b60008383834630604051602001611d3395949392919061398d565b6040516020818303038152906040528051906020012090509392505050565b60006002828418611d639190613a0f565b828416611d7091906130cc565b905092915050565b611d828282612368565b611d8a6124c7565b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff16611db0610669565b1115611df1576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611de890613ab2565b60405180910390fd5b611dff60086124eb83612501565b50505050565b8173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614158015611e415750600081115b15611ff957600073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614611f1f57600080611ec8600760008773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002061277985612501565b915091508473ffffffffffffffffffffffffffffffffffffffff167fdec2bacdd2f05b59de34da9b523dff8be42e5e38e818c82fdb0bae774387a7248383604051611f14929190613ad2565b60405180910390a250505b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614611ff857600080611fa1600760008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206124eb85612501565b915091508373ffffffffffffffffffffffffffffffffffffffff167fdec2bacdd2f05b59de34da9b523dff8be42e5e38e818c82fdb0bae774387a7248383604051611fed929190613ad2565b60405180910390a250505b5b505050565b612008828261278f565b612016600861277983612501565b50505050565b60008282604051602001612031929190613b73565b60405160208183030381529060405280519060200120905092915050565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a08360001c111561208a576000600391509150612152565b601b8560ff16141580156120a25750601c8560ff1614155b156120b4576000600491509150612152565b6000600187878787604051600081526020016040526040516120d99493929190613baa565b6020604051602081039080840390855afa1580156120fb573d6000803e3d6000fd5b505050602060405103519050600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff160361214957600060019250925050612152565b80600092509250505b94509492505050565b6000600481111561216f5761216e613bef565b5b81600481111561218257612181613bef565b5b0315612324576001600481111561219c5761219b613bef565b5b8160048111156121af576121ae613bef565b5b036121ef576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016121e690613c6a565b60405180910390fd5b6002600481111561220357612202613bef565b5b81600481111561221657612215613bef565b5b03612256576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161224d90613cd6565b60405180910390fd5b6003600481111561226a57612269613bef565b5b81600481111561227d5761227c613bef565b5b036122bd576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016122b490613d68565b60405180910390fd5b6004808111156122d0576122cf613bef565b5b8160048111156122e3576122e2613bef565b5b03612323576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161231a90613dfa565b60405180910390fd5b5b50565b6001816000016000828254019250508190555050565b612348838383612965565b61236361235484610882565b61235d84610882565b83611e05565b505050565b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16036123d7576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016123ce90613e66565b60405180910390fd5b6123e360008383611d03565b80600260008282546123f591906130cc565b92505081905550806000808473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825461244a91906130cc565b925050819055508173ffffffffffffffffffffffffffffffffffffffff16600073ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef836040516124af9190612be3565b60405180910390a36124c360008383611d08565b5050565b60007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff905090565b600081836124f991906130cc565b905092915050565b6000806000858054905090506000811461256f578560018261252391906131d8565b815481106125345761253361320c565b5b9060005260206000200160000160049054906101000a90047bffffffffffffffffffffffffffffffffffffffffffffffffffffffff16612572565b60005b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1692506125a083858763ffffffff16565b91506000811180156125f3575043866001836125bc91906131d8565b815481106125cd576125cc61320c565b5b9060005260206000200160000160009054906101000a900463ffffffff1663ffffffff16145b15612680576126018261296a565b8660018361260f91906131d8565b815481106126205761261f61320c565b5b9060005260206000200160000160046101000a8154817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff02191690837bffffffffffffffffffffffffffffffffffffffffffffffffffffffff160217905550612770565b85604051806040016040528061269543611b2b565b63ffffffff1681526020016126a98561296a565b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff168152509080600181540180825580915050600190039060005260206000200160009091909190915060008201518160000160006101000a81548163ffffffff021916908363ffffffff16021790555060208201518160000160046101000a8154817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff02191690837bffffffffffffffffffffffffffffffffffffffffffffffffffffffff16021790555050505b50935093915050565b6000818361278791906131d8565b905092915050565b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16036127fe576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016127f590613ef8565b60405180910390fd5b61280a82600083611d03565b60008060008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054905081811015612890576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161288790613f8a565b60405180910390fd5b8181036000808573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000208190555081600260008282546128e791906131d8565b92505081905550600073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8460405161294c9190612be3565b60405180910390a361296083600084611d08565b505050565b505050565b60007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff80168211156129cd576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016129c49061401c565b60405180910390fd5b819050919050565b6040518060400160405280600063ffffffff16815260200160007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1681525090565b600081519050919050565b600082825260208201905092915050565b60005b83811015612a4d578082015181840152602081019050612a32565b60008484015250505050565b6000601f19601f8301169050919050565b6000612a7582612a13565b612a7f8185612a1e565b9350612a8f818560208601612a2f565b612a9881612a59565b840191505092915050565b60006020820190508181036000830152612abd8184612a6a565b905092915050565b600080fd5b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000612af582612aca565b9050919050565b612b0581612aea565b8114612b1057600080fd5b50565b600081359050612b2281612afc565b92915050565b6000819050919050565b612b3b81612b28565b8114612b4657600080fd5b50565b600081359050612b5881612b32565b92915050565b60008060408385031215612b7557612b74612ac5565b5b6000612b8385828601612b13565b9250506020612b9485828601612b49565b9150509250929050565b60008115159050919050565b612bb381612b9e565b82525050565b6000602082019050612bce6000830184612baa565b92915050565b612bdd81612b28565b82525050565b6000602082019050612bf86000830184612bd4565b92915050565b600080600060608486031215612c1757612c16612ac5565b5b6000612c2586828701612b13565b9350506020612c3686828701612b13565b9250506040612c4786828701612b49565b9150509250925092565b600060ff82169050919050565b612c6781612c51565b82525050565b6000602082019050612c826000830184612c5e565b92915050565b6000819050919050565b612c9b81612c88565b82525050565b6000602082019050612cb66000830184612c92565b92915050565b600060208284031215612cd257612cd1612ac5565b5b6000612ce084828501612b13565b91505092915050565b612cf281612aea565b82525050565b6000602082019050612d0d6000830184612ce9565b92915050565b600063ffffffff82169050919050565b612d2c81612d13565b82525050565b6000602082019050612d476000830184612d23565b92915050565b600060208284031215612d6357612d62612ac5565b5b6000612d7184828501612b49565b91505092915050565b612d8381612c51565b8114612d8e57600080fd5b50565b600081359050612da081612d7a565b92915050565b612daf81612c88565b8114612dba57600080fd5b50565b600081359050612dcc81612da6565b92915050565b60008060008060008060c08789031215612def57612dee612ac5565b5b6000612dfd89828a01612b13565b9650506020612e0e89828a01612b49565b9550506040612e1f89828a01612b49565b9450506060612e3089828a01612d91565b9350506080612e4189828a01612dbd565b92505060a0612e5289828a01612dbd565b9150509295509295509295565b600080600080600080600060e0888a031215612e7e57612e7d612ac5565b5b6000612e8c8a828b01612b13565b9750506020612e9d8a828b01612b13565b9650506040612eae8a828b01612b49565b9550506060612ebf8a828b01612b49565b9450506080612ed08a828b01612d91565b93505060a0612ee18a828b01612dbd565b92505060c0612ef28a828b01612dbd565b91505092959891949750929550565b60008060408385031215612f1857612f17612ac5565b5b6000612f2685828601612b13565b9250506020612f3785828601612b13565b9150509250929050565b612f4a81612d13565b8114612f5557600080fd5b50565b600081359050612f6781612f41565b92915050565b60008060408385031215612f8457612f83612ac5565b5b6000612f9285828601612b13565b9250506020612fa385828601612f58565b9150509250929050565b612fb681612d13565b82525050565b60007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff82169050919050565b612fed81612fbc565b82525050565b6040820160008201516130096000850182612fad565b50602082015161301c6020850182612fe4565b50505050565b60006040820190506130376000830184612ff3565b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b6000600282049050600182168061308457607f821691505b6020821081036130975761309661303d565b5b50919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b60006130d782612b28565b91506130e283612b28565b92508282019050808211156130fa576130f961309d565b5b92915050565b7f4552433230566f7465733a20626c6f636b206e6f7420796574206d696e656400600082015250565b6000613136601f83612a1e565b915061314182613100565b602082019050919050565b6000602082019050818103600083015261316581613129565b9050919050565b7f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572600082015250565b60006131a2602083612a1e565b91506131ad8261316c565b602082019050919050565b600060208201905081810360008301526131d181613195565b9050919050565b60006131e382612b28565b91506131ee83612b28565b92508282039050818111156132065761320561309d565b5b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b7f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f7760008201527f207a65726f000000000000000000000000000000000000000000000000000000602082015250565b6000613297602583612a1e565b91506132a28261323b565b604082019050919050565b600060208201905081810360008301526132c68161328a565b9050919050565b7f4552433230566f7465733a207369676e61747572652065787069726564000000600082015250565b6000613303601d83612a1e565b915061330e826132cd565b602082019050919050565b60006020820190508181036000830152613332816132f6565b9050919050565b600060808201905061334e6000830187612c92565b61335b6020830186612ce9565b6133686040830185612bd4565b6133756060830184612bd4565b95945050505050565b7f4552433230566f7465733a20696e76616c6964206e6f6e636500000000000000600082015250565b60006133b4601983612a1e565b91506133bf8261337e565b602082019050919050565b600060208201905081810360008301526133e3816133a7565b9050919050565b7f45524332305065726d69743a206578706972656420646561646c696e65000000600082015250565b6000613420601d83612a1e565b915061342b826133ea565b602082019050919050565b6000602082019050818103600083015261344f81613413565b9050919050565b600060c08201905061346b6000830189612c92565b6134786020830188612ce9565b6134856040830187612ce9565b6134926060830186612bd4565b61349f6080830185612bd4565b6134ac60a0830184612bd4565b979650505050505050565b7f45524332305065726d69743a20696e76616c6964207369676e61747572650000600082015250565b60006134ed601e83612a1e565b91506134f8826134b7565b602082019050919050565b6000602082019050818103600083015261351c816134e0565b9050919050565b7f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160008201527f6464726573730000000000000000000000000000000000000000000000000000602082015250565b600061357f602683612a1e565b915061358a82613523565b604082019050919050565b600060208201905081810360008301526135ae81613572565b9050919050565b7f45524332303a20617070726f76652066726f6d20746865207a65726f2061646460008201527f7265737300000000000000000000000000000000000000000000000000000000602082015250565b6000613611602483612a1e565b915061361c826135b5565b604082019050919050565b6000602082019050818103600083015261364081613604565b9050919050565b7f45524332303a20617070726f766520746f20746865207a65726f20616464726560008201527f7373000000000000000000000000000000000000000000000000000000000000602082015250565b60006136a3602283612a1e565b91506136ae82613647565b604082019050919050565b600060208201905081810360008301526136d281613696565b9050919050565b7f45524332303a20696e73756666696369656e7420616c6c6f77616e6365000000600082015250565b600061370f601d83612a1e565b915061371a826136d9565b602082019050919050565b6000602082019050818103600083015261373e81613702565b9050919050565b7f45524332303a207472616e736665722066726f6d20746865207a65726f20616460008201527f6472657373000000000000000000000000000000000000000000000000000000602082015250565b60006137a1602583612a1e565b91506137ac82613745565b604082019050919050565b600060208201905081810360008301526137d081613794565b9050919050565b7f45524332303a207472616e7366657220746f20746865207a65726f206164647260008201527f6573730000000000000000000000000000000000000000000000000000000000602082015250565b6000613833602383612a1e565b915061383e826137d7565b604082019050919050565b6000602082019050818103600083015261386281613826565b9050919050565b7f45524332303a207472616e7366657220616d6f756e742065786365656473206260008201527f616c616e63650000000000000000000000000000000000000000000000000000602082015250565b60006138c5602683612a1e565b91506138d082613869565b604082019050919050565b600060208201905081810360008301526138f4816138b8565b9050919050565b7f53616665436173743a2076616c756520646f65736e27742066697420696e203360008201527f3220626974730000000000000000000000000000000000000000000000000000602082015250565b6000613957602683612a1e565b9150613962826138fb565b604082019050919050565b600060208201905081810360008301526139868161394a565b9050919050565b600060a0820190506139a26000830188612c92565b6139af6020830187612c92565b6139bc6040830186612c92565b6139c96060830185612bd4565b6139d66080830184612ce9565b9695505050505050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601260045260246000fd5b6000613a1a82612b28565b9150613a2583612b28565b925082613a3557613a346139e0565b5b828204905092915050565b7f4552433230566f7465733a20746f74616c20737570706c79207269736b73206f60008201527f766572666c6f77696e6720766f74657300000000000000000000000000000000602082015250565b6000613a9c603083612a1e565b9150613aa782613a40565b604082019050919050565b60006020820190508181036000830152613acb81613a8f565b9050919050565b6000604082019050613ae76000830185612bd4565b613af46020830184612bd4565b9392505050565b600081905092915050565b7f1901000000000000000000000000000000000000000000000000000000000000600082015250565b6000613b3c600283613afb565b9150613b4782613b06565b600282019050919050565b6000819050919050565b613b6d613b6882612c88565b613b52565b82525050565b6000613b7e82613b2f565b9150613b8a8285613b5c565b602082019150613b9a8284613b5c565b6020820191508190509392505050565b6000608082019050613bbf6000830187612c92565b613bcc6020830186612c5e565b613bd96040830185612c92565b613be66060830184612c92565b95945050505050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602160045260246000fd5b7f45434453413a20696e76616c6964207369676e61747572650000000000000000600082015250565b6000613c54601883612a1e565b9150613c5f82613c1e565b602082019050919050565b60006020820190508181036000830152613c8381613c47565b9050919050565b7f45434453413a20696e76616c6964207369676e6174757265206c656e67746800600082015250565b6000613cc0601f83612a1e565b9150613ccb82613c8a565b602082019050919050565b60006020820190508181036000830152613cef81613cb3565b9050919050565b7f45434453413a20696e76616c6964207369676e6174757265202773272076616c60008201527f7565000000000000000000000000000000000000000000000000000000000000602082015250565b6000613d52602283612a1e565b9150613d5d82613cf6565b604082019050919050565b60006020820190508181036000830152613d8181613d45565b9050919050565b7f45434453413a20696e76616c6964207369676e6174757265202776272076616c60008201527f7565000000000000000000000000000000000000000000000000000000000000602082015250565b6000613de4602283612a1e565b9150613def82613d88565b604082019050919050565b60006020820190508181036000830152613e1381613dd7565b9050919050565b7f45524332303a206d696e7420746f20746865207a65726f206164647265737300600082015250565b6000613e50601f83612a1e565b9150613e5b82613e1a565b602082019050919050565b60006020820190508181036000830152613e7f81613e43565b9050919050565b7f45524332303a206275726e2066726f6d20746865207a65726f2061646472657360008201527f7300000000000000000000000000000000000000000000000000000000000000602082015250565b6000613ee2602183612a1e565b9150613eed82613e86565b604082019050919050565b60006020820190508181036000830152613f1181613ed5565b9050919050565b7f45524332303a206275726e20616d6f756e7420657863656564732062616c616e60008201527f6365000000000000000000000000000000000000000000000000000000000000602082015250565b6000613f74602283612a1e565b9150613f7f82613f18565b604082019050919050565b60006020820190508181036000830152613fa381613f67565b9050919050565b7f53616665436173743a2076616c756520646f65736e27742066697420696e203260008201527f3234206269747300000000000000000000000000000000000000000000000000602082015250565b6000614006602783612a1e565b915061401182613faa565b604082019050919050565b6000602082019050818103600083015261403581613ff9565b905091905056fea26469706673582212208f78491b842145dccbda65cd17915c7c7cdfb6972d8f62da350e44f3b8fe32b764736f6c63430008110033",
"contractAddress":"0xc5102fe9359fd9a28f877a67e36b0f050d81a3cc",
"cumulativeGasUsed":"3741349",
"gasUsed":"3694448",
"confirmations":"28771",
"methodId":"0x61016060",
"functionName":""
},
{
"blockNumber":"1801043",
"timeStamp":"1690391433",
"hash":"0xb1f9a7de6dbb64a07d0ec293ad4196e7edc0bbe59c7dd3f4f071e1aea442f998",
"nonce":"2",
"blockHash":"0x0f3718c1866de5e400a95c3354417f27a5224e1c2be2821a943152628ea5dbd5",
"transactionIndex":"1",
"from":"0x9aa99c23f67c81701c772b106b4f83f6e858dd2e",
"to":"0xc5102fe9359fd9a28f877a67e36b0f050d81a3cc",
"value":"0",
"gas":"5000000",
"gasPrice":"10000000000",
"isError":"0",
"txreceipt_status":"1",
"input":"0xf2fde38b000000000000000000000000924ac9910c09a0215b06458653b30471a152022f",
"contractAddress":"",
"cumulativeGasUsed":"79563",
"gasUsed":"29062",
"confirmations":"28768",
"methodId":"0xf2fde38b",
"functionName":"transferOwnership(address newOwner)"
}
]
}Returns the list of internal transactions performed by an address, with optional pagination.
https://api.basescan.org/api
?module=account
&action=txlistinternal
&address=0x4200000000000000000000000000000000000015
&startblock=0
&endblock=2702578
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyTokenQuery Parameters
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
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"1",
"timeStamp":"1686789349",
"hash":"0x68736fb400dc3b69ab1c4c2cbe75a600aa7ba7cd8d025797ebd8a0108955c91f",
"from":"0x4200000000000000000000000000000000000015",
"to":"0xc0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d30015",
"value":"0",
"contractAddress":"",
"input":"",
"type":"delegatecall",
"gas":"956917",
"gasUsed":"36084",
"traceId":"0_1",
"isError":"0",
"errCode":""
},
{
"blockNumber":"2",
"timeStamp":"1686789351",
"hash":"0x2e153fdb0c9226f5c036893f9285e0e90ebdb0829a2d93eb7c9c93b63e0fcfd4",
"from":"0x4200000000000000000000000000000000000015",
"to":"0xc0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d30015",
"value":"0",
"contractAddress":"",
"input":"",
"type":"delegatecall",
"gas":"956917",
"gasUsed":"18984",
"traceId":"0_1",
"isError":"0",
"errCode":""
}
]
}Returns the list of internal transactions performed within a transaction.
https://api.basescan.org/api
?module=account
&action=txlistinternal
&txhash=0x3190ee988c62654d52d15eb023d7b5727d2104024cad4625791281513127ffac
&apikey=YourApiKeyTokenQuery Parameters
txhash
the string representing the transaction hash to check for internal transactions
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"blockNumber":"1824790",
"timeStamp":"1690438927",
"from":"0x3491fe4c3ababdfee894b1a2ecd042827ddb893d",
"to":"0xb6319cc6c8c27a8f5daf0dd3df91ea35c4720dd7",
"value":"109558668139425",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"87093",
"gasUsed":"84929",
"isError":"0",
"errCode":""
},
{
"blockNumber":"1824790",
"timeStamp":"1690438927",
"from":"0xb6319cc6c8c27a8f5daf0dd3df91ea35c4720dd7",
"to":"0x38de71124f7a447a01d67945a51edce9ff491251",
"value":"109558668139425",
"contractAddress":"",
"input":"",
"type":"call",
"gas":"66756",
"gasUsed":"65330",
"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.
https://api.basescan.org/api
?module=account
&action=txlistinternal
&startblock=1000013
&endblock=1001013
&page=1
&offset=10
&sort=asc
&apikey=YourApiKeyTokenQuery Parameters
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":"1000013",
"timeStamp":"1688789373",
"hash":"0x32d96bd248a30e4c279ca97555c5c9d9bd42b8578a562ca10d47e692a51b250e",
"from":"0x4200000000000000000000000000000000000015",
"to":"0xc0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d30015",
"value":"0",
"contractAddress":"",
"input":"",
"type":"delegatecall",
"gas":"956929",
"gasUsed":"18984",
"traceId":"0_1",
"isError":"0",
"errCode":""
},
{
"blockNumber":"1000014",
"timeStamp":"1688789375",
"hash":"0x2f5a3a4b933a1a51f46f2aef2d16d713de8309718140e4f394461abc451d5581",
"from":"0x4200000000000000000000000000000000000015",
"to":"0xc0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d30015",
"value":"0",
"contractAddress":"",
"input":"",
"type":"delegatecall",
"gas":"956929",
"gasUsed":"27384",
"traceId":"0_1",
"isError":"0",
"errCode":""
}
]
}The isError field returns 0 for successful transactions and 1 for rejected/cancelled transactions.
Returns the list of ERC-20 tokens transferred by an address, with optional filtering by token contract.
https://api.basescan.org/api
?module=account
&action=tokentx
&contractaddress=0x4200000000000000000000000000000000000006
&address=0xfcd3842f85ed87ba2889b4d35893403796e67ff1
&page=1
&offset=100
&startblock=0
&endblock=27025780
&sort=asc
&apikey=YourApiKeyTokenUsage:
ERC-20 transfers from an address, specify the address parameter
ERC-20 transfers from a contract address, specify the contract address parameter
ERC-20 transfers from an address filtered by a token contract, specify both address and contract address parameters.
Query Parameters
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":"1798354",
"timeStamp":"1690386055",
"hash":"0xdb838eaaa510e3d34effdc8c43d8cc07af4a21ee8b8f70f3e6a2852f60942baf",
"nonce":"5",
"blockHash":"0x7b4774a4e9acb9f9b3e6c051552e9bd5032146b6e21c3c7fc53c228b7dc979fb",
"from":"0xfcd3842f85ed87ba2889b4d35893403796e67ff1",
"contractAddress":"0x4200000000000000000000000000000000000006",
"to":"0xd02d69c0ab8f5b9201198bde104ab4923b53630e",
"value":"200000000000000000",
"tokenName":"Wrapped Ether",
"tokenSymbol":"WETH",
"tokenDecimal":"18",
"transactionIndex":"1",
"gas":"418716",
"gasPrice":"1000000000",
"gasUsed":"322410",
"cumulativeGasUsed":"369323",
"input":"deprecated",
"confirmations":"31671"
},
{
"blockNumber":"1798364",
"timeStamp":"1690386075",
"hash":"0x76043f355916523c49ee15988319340da023f293021c77bf102afa3a16865030",
"nonce":"1",
"blockHash":"0x68a99cfec6ca05b318421ff86cb39bae251a6a86da2d7d642410d9562c4427e2",
"from":"0xfcd3842f85ed87ba2889b4d35893403796e67ff1",
"contractAddress":"0x4200000000000000000000000000000000000006",
"to":"0xd02d69c0ab8f5b9201198bde104ab4923b53630e",
"value":"2000000000000000",
"tokenName":"Wrapped Ether",
"tokenSymbol":"WETH",
"tokenDecimal":"18",
"transactionIndex":"1",
"gas":"412089",
"gasPrice":"1500000050",
"gasUsed":"315315",
"cumulativeGasUsed":"362228",
"input":"deprecated",
"confirmations":"31661"
}
]
}Returns the list of ERC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract.
https://api.basescan.org/api
?module=account
&action=tokennfttx
&contractaddress=0x1fc10ef15e041c5d3c54042e52eb0c54cb9b710c
&address=0xb82880e217478907cc9b1e5795d75d3257608ce0
&page=1
&offset=100
&startblock=0
&endblock=27025780
&sort=asc
&apikey=YourApiKeyTokenUsage:
ERC-721 transfers from an address, specify the address parameter
ERC-721 transfers from a contract address, specify the contract address parameter
ERC-721 transfers from an address filtered by a token contract, specify both address and contract address parameters.
Query Parameters
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":"1830023",
"timeStamp":"1690449393",
"hash":"0x66485621605e8c8d60ab7ddac0f75ee9c397e24bc3c1e87069b01409a01ec6ad",
"nonce":"1",
"blockHash":"0x5a7e2bc24e43181298e19e82c2984f5014ef595caf752036e887fd2a63a04f2f",
"from":"0x0000000000000000000000000000000000000000",
"contractAddress":"0x1fc10ef15e041c5d3c54042e52eb0c54cb9b710c",
"to":"0xb82880e217478907cc9b1e5795d75d3257608ce0",
"tokenID":"81180",
"tokenName":"Base is for builders",
"tokenSymbol":"BASEBUILDERS",
"tokenDecimal":"0",
"transactionIndex":"1",
"gas":"118857",
"gasPrice":"1500000050",
"gasUsed":"79238",
"cumulativeGasUsed":"126151",
"input":"deprecated",
"confirmations":"33"
}
]
}Returns the list of ERC-1155 ( Multi Token Standard ) tokens transferred by an address, with optional filtering by token contract.
https://api.basescan.org/api
?module=account
&action=token1155tx
&contractaddress=0xba5e05cb26b78eda3a2f8e3b3814726305dcac83
&address=0x8cd98dea4e95170f068e6d5aed1e7f1c285e7f77
&page=1
&offset=100
&startblock=0
&endblock=99999999
&sort=asc
&apikey=YourApiKeyTokenUsage:
ERC-1155 transfers from an address, specify the address parameter
ERC-1155 transfers from a contract address, specify the contract address parameter
ERC-1155 transfers from an address filtered by a token contract, specify both address and contract address parameters.
Returns the historical ETH balance of an address at a certain block height.
https://api.basescan.org/api
?module=account
&action=balancehistory
&address=0xf977814e90da44bfa03b6295a0616a897441acec
&blockno=10000000
&apikey=YourApiKeyTokenQuery Parameters
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
{
"status":"1",
"message":"OK",
"result":"24095801991560885658761"
}Convert ETH units using our Unit Converter.
Try this endpoint in your browser
Note : This API endpoint returns a maximum of 10000 records, and 1000 records without an API Key
Try this endpoint in your browser
Note : This API endpoint returns a maximum of 10000 records, and 1000 records without an API Key
Try this endpoint in your browser
Tip: Specify a smaller startblock and endblock range for faster search results
Note : This API endpoint returns a maximum of 10000 records, and 1000 records without an API Key
Try this endpoint in your browser
Note : This API endpoint returns a maximum of 10000 records, and 1000 records without an API Key
Try this endpoint in your browser
Try this endpoint in your browser
Try this endpoint in your browser
Try this endpoint in your browser
Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.
Try this endpoint in your browser
Tip: The result is returned in wei.
