Comment on page

Account

?module=account

Page is under construction. For a full description of RPC endpoints, visit https://blockscout.com/xdai/mainnet/api-docs​
https://instance_base_url/api?module=account
Return balance from a provided block
eth_get_balance
Mimics Ethereum JSON RPC's eth_getBalance
Example:
https://instance_base_url/api
   ?module=account
   &action=eth_get_balance
   &address={addressHash}
Request Params
Example Result
Parameter
 Description
address
string containing the address hash.
block
optional. Block number as a string, or latest, earliest or pending 

Latest is the latest balance in a consensus block. Earliest is the first recorded balance for the address. Pending is the latest balance in a consensus or nonconsensus block.
{
  "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:
https://instance_base_url/api
   ?module=account
   &action=balance
   &address={addressHash}
Request Params
Example Result
Parameter
 Description
address
string containing the address hash.
{
  "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 balancemulti 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:
https://instance_base_url/api
   ?module=account
   &action=balancemulti
   &address={addressHash1,addressHash2,addressHash3}
Request Params
Example Result
Parameter
 Description
address
string containing the address hash, comma separated. Max 20 addresses.
​
{
  "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:
https://instance_base_url/api
   ?module=account
   &action=pendingtxlist
   &address={addressHash}
   &page=1
   &offset=5
Request Params
Example Result
Parameter
 Description
address
string containing the address hash.
page
optional integer representing the page number used for pagination. 'offset' must also be provided.
offset
optional  integer representing number of transactions returned per page. page must also be provided.
​
  "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:
https://instance_base_url/api
   ?module=account
   &action=txlist
   &address={addressHash}
   &startblock=555555
   &endblock=666666
   &page=1
   &offset=5
   &sort=asc
Request Params
Example Result
Parameter
 Description
address
string containing the address hash.
sort
optional sorting preference, asc for ascending and desc for descending. Descending is default.
start_block
optional integer block number to start transaction search
end_block
optionalinteger block number to stop transaction search.
page
optional integer representing the page number used for pagination. offset must also be provided.
offset
optional  integer representing number of transactions returned per page. page must also be provided.
filter_by
optional string representing the field to filter by. Values include to and from. If none provided returns transactions that match to, from, or contract address.
start_timestamp
optional starting block unix timestamp.
end_timestamp
optional ending block unix timestamp.
{
  "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:
https://instance_base_url/api
   ?module=account
   &action=txlistinternal
   &txhash={transactionHash}
   &startblock=555555
   &endblock=666666
   &page=1
   &offset=5
   &sort=asc
Request Params
Example Result
​
Parameter
 Description
txhash
string representing the transaction hash to check for internal transactions
address
optional string containing the address hash.
sort
optional sorting preference, asc for ascending and desc for descending. Descending is default. Only available if 'address' is provided.
start_block
optional integer block number to start transaction search. Only available if 'address' is provided.
end_block
optionalinteger block number to stop transaction search. Only available if 'address' is provided.
page
optional integer representing the page number used for pagination. offset must also be provided. Only available if 'address' is provided.
offset
optional  integer representing number of transactions returned per page. page must also be provided. Only available if 'address' is provided.
{
  "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 transfer events by address
tokentx
Up to a maximum of 10,000 token transfer events. Also available through the GraphQL token_transfers query.
Example:
https://instance_base_url/api
   ?module=account
   &action=tokentx
   &address={addressHash}
   &page=1
   &offset=10
   &sort=asc
Request Params
Example Result
​
Parameter
 Description
address
string containing the address hash.
contract address
optional string with the token contract address to identify a contract.
sort
optional sorting preference, asc for ascending and desc for descending. Descending is default.
start_block
optional integer block number to start transaction search
end_block
optionalinteger block number to stop transaction search.
page
optional integer representing the page number used for pagination. offset must also be provided.
offset
optional  integer representing number of transactions returned per page. page must also be provided.
{
  "message": "OK",
  "result": [
    {
      "blockHash": "0x6169c5dc05d0051564ba3eae8ebfbdefda640c5f5ffc095846b8aed0b44f64ea",
      "blockNumber": "5997843",
      "confirmations": "199384",
      "contractAddress": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
      "cumulativeGasUsed": "1043649",
      "from": "0x4e83362442b8d1bec281594cea3050c8eb01311c",
      "gas": "44758",
      "gasPrice": "7000000000",
      "gasUsed": "37298",
      "hash": "0xd65b788c610949704a5f9aac2228c7c777434dfe11c863a12306f57fcbd8cdbb",
      "input": "0xa9059cbb00000000000000000000000021e21ba085289f81a86921de890eed30f1ad23750000000000000000000000000000000000000000000000008ac7230489e80000",
      "logIndex": "0",
      "nonce": "765",
      "timeStamp": "1532086946",
      "to": "0x21e21ba085289f81a86921de890eed30f1ad2375",
      "tokenDecimal": "18",
      "tokenName": "Maker",
      "tokenSymbol": "MKR",
      "transactionIndex": "27",
      "value": "10000000000000000000"
    }
  ],
  "status": "1"
}
Get token account balance for token contract address
tokenbalance
Example:
https://instance_base_url/api
   ?module=account
   &action=tokenbalance
   &contractaddress={contractAddressHash}
   &address={addressHash}
Request Params
Example Result
​
Parameter
 Description
contract address
string containing the contract address hash.
address
string containing the account address hash to retrieve balance for.
{
  "message": "OK",
  "result": "135499",
  "status": "1"
}
Get list of tokens owned by address
tokenlist
Example:
https://instance_base_url/api
   ?module=account
   &action=tokenlist
   &address={addressHash}
Request Params
Example Result
Parameter
 Description
address
string containing the account address hash.
{
  "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:
https://instance_base_url/api
   ?module=account
   &action=getminedblocks
   &address={addressHash}
Request Params
Example Result
Parameter
 Description
address
string containing the address hash.
page
optional integer representing the page number used for pagination. 'offset' must also be provided.
offset
optional  integer representing number of transactions returned per page. page must also be provided.
{
  "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
   ?module=account
   &action=listaccounts
   &address={addressHash}
   &page=1
   &offset=3
Request Params
Example Result
​
Parameter
 Description
page
optional integer representing the page number used for pagination. 'offset' must also be provided.
offset
optional  integer representing number of transactions returned per page. page must also be provided.
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.
{
  "message": "OK",
  "result": [
    {
      "address": "0x3870c57fbf1d7e49b154269331c7bc66c64d8857",
      "balance": "3790064387342000000",
      "stale": false
    },
    {
      "address": "0x497d69ae30d7cca0aa84d647c6d85a59a82c16ef",
      "balance": "2047176464264000000",
      "stale": false
    },
    {
      "address": "0x9233042b8e9e03d5dc6454bbbe5aee83818ff103",
      "balance": "444111960222208758647",
      "stale": false
    }
  ],
  "status": "1"
}

Parameter	Description
address	`string` containing the address hash.
block	optional. Block number as a string, or `latest`, `earliest` or `pending` Latest is the latest balance in a consensus block. Earliest is the first recorded balance for the address. Pending is the latest balance in a consensus or nonconsensus block.

Parameter	Description
address	`string` containing the address hash.

Parameter	Description
address	`string` containing the address hash, comma separated. Max 20 addresses.

Parameter	Description
address	`string` containing the address hash.
page	optional `integer` representing the page number used for pagination. 'offset' must also be provided.
offset	optional `integer` representing number of transactions returned per page. `page` must also be provided.

Parameter	Description
address	`string` containing the address hash.
sort	optional sorting preference, `asc` for ascending and `desc` for descending. Descending is default.
start_block	optional `integer` block number to start transaction search
end_block	optional`integer` block number to stop transaction search.
page	optional `integer` representing the page number used for pagination. `offset` must also be provided.
offset	optional `integer` representing number of transactions returned per page. `page` must also be provided.
filter_by	optional string representing the field to filter by. Values include `to` and `from`. If none provided returns transactions that match to, from, or contract address.
start_timestamp	optional starting block unix timestamp.
end_timestamp	optional ending block unix timestamp.

Parameter	Description
txhash	`string` representing the transaction hash to check for internal transactions
address	optional `string` containing the address hash.
sort	optional sorting preference, `asc` for ascending and `desc` for descending. Descending is default. Only available if 'address' is provided.
start_block	optional `integer` block number to start transaction search. Only available if 'address' is provided.
end_block	optional`integer` block number to stop transaction search. Only available if 'address' is provided.
page	optional `integer` representing the page number used for pagination. `offset` must also be provided. Only available if 'address' is provided.
offset	optional `integer` representing number of transactions returned per page. `page` must also be provided. Only available if 'address' is provided.

Parameter	Description
address	`string` containing the address hash.
contract address	optional `string` with the token contract address to identify a contract.
sort	optional sorting preference, `asc` for ascending and `desc` for descending. Descending is default.
start_block	optional `integer` block number to start transaction search
end_block	optional`integer` block number to stop transaction search.
page	optional `integer` representing the page number used for pagination. `offset` must also be provided.
offset	optional `integer` representing number of transactions returned per page. `page` must also be provided.

Parameter	Description
contract address	`string` containing the contract address hash.
address	`string` containing the account address hash to retrieve balance for.

Parameter	Description
address	`string` containing the account address hash.

Parameter	Description
address	`string` containing the address hash.
page	optional `integer` representing the page number used for pagination. 'offset' must also be provided.
offset	optional `integer` representing number of transactions returned per page. `page` must also be provided.

Parameter	Description
page	optional `integer` representing the page number used for pagination. 'offset' must also be provided.
offset	optional `integer` representing number of transactions returned per page. `page` must also be provided.

Last modified 6mo ago