Page is under construction.
https://instance_base_url/api?module=account
Return balance from a provided block
eth_get_balance
Mimics Ethereum JSON RPC's eth_getBalance
Example:
Copy https://instance_base_url/api
?module=account
&action=eth_get_balance
&address={addressHash}
Example
Request Params Example Results
Copy {
"id": 1,
"jsonrpc": "2.0",
"result": "0x0234c8a3397aab58"
}
Get the native token balance for an address
balance
Many chains use their own native tokens. On Ethereum, this will return the result in "Ether", on Gnosis it will be "xDai", etc. Results are returned in wei.
Example:
Copy https://instance_base_url/api
?module=account
&action=balance
&address={addressHash}
Request Params Example Result
Copy {
"message": "OK",
"result": "663046792267785498951364",
"status": "1"
}
Also available through a GraphQL address
query.If the balance hasn't been updated recently, the node is double-checked to fetch the absolute latest balance. This will not be reflected in the current request, but once it is updated, subsequent requests will show the updated balance. If you want to know if there is a check for another balance, use the balancemult
i action. That contains a property called stale
that will let you know to recheck that balance in the near future.
Get balance for multiple addresses
balancemulti
Example:
Copy https://instance_base_url/api
?module=account
&action=balancemulti
&address={addressHash1,addressHash2,addressHash3}
Request Params Example Result
Copy {
"message": "OK",
"result": [
{
"account": "0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a",
"balance": "40807168566070000000000",
"stale": true
},
{
"account": "0x63a9975ba31b0b9626b34300f7f627147df1f526",
"balance": "332567136222827062478",
"stale": false
},
{
"account": "0x198ef1ec325a96cc354c7266a038be8b5c558f67",
"balance": "185178830000000000",
"stale": false
}
],
"status": "1"
}
Also available through a GraphQL 'addresses' query
If the balance hasn't been updated in a long time, the node is double checked to fetch the absolute latest balance. This is not reflected in the current request, but once it is updated, subsequent requests will show the updated balance. The stale
attribute will be set to true
if a new balance is being fetched.
Get pending transactions by address
pendingtxlist
Example:
Copy https://instance_base_url/api
?module=account
&action=pendingtxlist
&address={addressHash}
&page=1
&offset=5
Requested Params Example Result
Copy "message": "OK",
"result": [
{
"contractAddress": "",
"cumulativeGasUsed": "122207",
"from": "0x3fb1cd2cd96c6d5c0b5eb3322d807b34482481d4",
"gas": "122261",
"gasPrice": "50000000000",
"gasUsed": "122207",
"hash": "0x98beb27135aa0a25650557005ad962919d6a278c4b3dde7f4f6a3a1e65aa746c",
"input": "0xf00d4b5d000000000000000000000000036c8cecce8d8bbf0831d840d7f29c9e3ddefa63000000000000000000000000c5a96db085dda36ffbe390f455315d30d6d3dc52",
"nonce": "0",
"to": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
"value": "0"
}
],
"status": "1"
}
Get transactions by address
txlist
Maximum of 10,000 transactions. Also available through a GraphQL 'address' query. For faster results, specify a smaller block range to search using the start_block and end_block parameters
Example:
Copy https://instance_base_url/api
?module=account
&action=txlist
&address={addressHash}
&startblock=555555
&endblock=666666
&page=1
&offset=5
&sort=asc
Requested Params Example Result
Copy {
"message": "OK",
"result": [
{
"blockHash": "0x373d339e45a701447367d7b9c7cef84aab79c2b2714271b908cda0ab3ad0849b",
"blockNumber": "65204",
"confirmations": "5994246",
"contractAddress": "",
"cumulativeGasUsed": "122207",
"from": "0x3fb1cd2cd96c6d5c0b5eb3322d807b34482481d4",
"gas": "122261",
"gasPrice": "50000000000",
"gasUsed": "122207",
"hash": "0x98beb27135aa0a25650557005ad962919d6a278c4b3dde7f4f6a3a1e65aa746c",
"input": "0xf00d4b5d000000000000000000000000036c8cecce8d8bbf0831d840d7f29c9e3ddefa63000000000000000000000000c5a96db085dda36ffbe390f455315d30d6d3dc52",
"isError": "0",
"nonce": "0",
"timeStamp": "1439232889",
"to": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
"transactionIndex": "0",
"txreceipt_status": "1",
"value": "0"
}
],
"status": "1"
}
Get internal transactions by transaction or address hash
txlistinternal
Up to a maximum of 10,000 internal transactions. Also available through a GraphQL 'transaction' query. For faster results, specify a smaller block range to search using the start_block and end_block parameters.
Example:
Copy https://instance_base_url/api
?module=account
&action=txlistinternal
&txhash={transactionHash}
&startblock=555555
&endblock=666666
&page=1
&offset=5
&sort=asc
Requested Params Example Result
Get token transfer events by address
tokentx
Up to a maximum of 10,000 token transfer events. Also available through the GraphQL token_transfers
query.
Example:
Copy https://instance_base_url/api
?module=account
&action=tokentx
&address={addressHash}
&page=1
&offset=10
&sort=asc
Requested Params Example Result
Copy {
"message": "OK",
"result": [
{
"blockNumber": "6153702",
"callType": "delegatecall",
"contractAddress": "0x883103875d905c11f9ac7dacbfc16deb39655361",
"errCode": "",
"from": "0x2ca1e3f250f56f1761b9a52bc42db53986085eff",
"gas": "814937",
"gasUsed": "536262",
"index": "0",
"input": "",
"isError": "0",
"timeStamp": "1534362606",
"to": "",
"transactionHash": "0xd65b788c610949704a5f9aac2228c7c777434dfe11c863a12306f57fcbd8cdbb",
"type": "call",
"value": "5488334153118633"
}
],
"status": "1"
}
Get token account balance for token contract address
tokenbalance
Example:
Copy https://instance_base_url/api
?module=account
&action=tokenbalance
&contractaddress={contractAddressHash}
&address={addressHash}
Requested Params Example Result
Copy {
"message": "OK",
"result": "135499",
"status": "1"
}
Get list of tokens owned by address
tokenlist
Example:
Copy https://instance_base_url/api
?module=account
&action=tokenlist
&address={addressHash}
Requested Params Example Result
Copy {
"message": "OK",
"result": [
{
"balance": "135499",
"contractAddress": "0x0000000000000000000000000000000000000000",
"decimals": "18",
"name": "Example Token",
"symbol": "ET",
"type": "ERC-20"
},
{
"balance": "1",
"contractAddress": "0x0000000000000000000000000000000000000001",
"decimals": "18",
"name": "Example ERC-721 Token",
"symbol": "ET7",
"type": "ERC-721"
}
],
"status": "1"
}
Get list of blocks mined by address
getminedblocks
Example:
Copy https://instance_base_url/api
?module=account
&action=getminedblocks
&address={addressHash}
Requested Params Example Result
Copy {
"message": "OK",
"result": [
{
"blockNumber": "3462296",
"blockReward": "5194770940000000000",
"timeStamp": "1491118514"
}
],
"status": "1"
}
Get a list of accounts and their balances
listaccounts
Lists accounts and native balances, sorted ascending by the time they were first seen by the explorer.
Example:
https://instance_base_url/api
Copy ?module=account
&action=listaccounts
&address={addressHash}
&page=1
&offset=3
Requested Params Example Result
Copy {
"message": "OK",
"result": [
{
"address": "0x3870c57fbf1d7e49b154269331c7bc66c64d8857",
"balance": "3790064387342000000",
"stale": false
},
{
"address": "0x497d69ae30d7cca0aa84d647c6d85a59a82c16ef",
"balance": "2047176464264000000",
"stale": false
},
{
"address": "0x9233042b8e9e03d5dc6454bbbe5aee83818ff103",
"balance": "444111960222208758647",
"stale": false
}
],
"status": "1"
}
If the balance hasn't been updated in a long time, the node is double checked to fetch the absolute latest balance. This is not reflected in the current request, but once it is updated, subsequent requests will show the updated balance. The stale
attribute will be set to true
if a new balance is being fetched.