Account

module = account

Discover the full scope of Ethereum account information with ethVM's dedicated API endpoints. Tailored to provide detailed insights into Ethereum accounts, our API offers a range of endpoints designed to empower developers with comprehensive account data

URL ENDPOINT:

?module=account&action=$ACTION

Query Parameters:

Name

Type

Description

address

string

required

Ethereum address to look up related transactions

startblock

number

default: 0

The beginning of the block range to inspect.

endblock

number

default 99999999

The end of the block range to inspect.

offset

number

default 10000

The maximum number of records to be returned.

page

number

default 1

The page number (assuming each page has a size of offset)

sort

string

values: asc , desc

default: asc

Whether records should be sorted ascending or descending

asc - earliest records first

desc - oldest records first

Get Account Transaction List

$ACTION = txlist

Returns transactions and receipt data where the specified address is either the sender, recipient, or the contract created by a transaction.

Example:

https://rest-api.ethvm.dev/?module=account&action=txlist&address=0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97&startblock=0&endblock=999999999999&offset=2&page=1&sort=desc

Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "19863970",
      "timeStamp": "1715637983",
      "hash": "0x15155e89347029073ac2caa56392084b7d417b502dd71cff5cb4afb3d9a795df",
      "nonce": "327461",
      "blockHash": "0xca54b150fd9e0d845c6358812dae70a534d631871b96fc7a121fbdbb1a0ca6db",
      "transactionIndex": "164",
      "from": "0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97",
      "to": "0x09de84ea4c30695d4899290cdc7305191e9c4b79",
      "value": "16105507611074388",
      "gas": "21000",
      "gasPrice": "4686262528",
      "isError": "0",
      "txreceipt_status": "1",
      "contractAddress": "",
      "gasUsed": "21000",
      "confirmations": "8"
    },
    {
      "blockNumber": "19863961",
      "timeStamp": "1715637875",
      "hash": "0xfbd121907ff3e7886f4b7ddae32794ad5a71298a50f10b0a9cfdf67366557183",
      "nonce": "327460",
      "blockHash": "0xab0c6ae2fec92203a5dd322715fd2f42e11bb46983d816b41039ca7f49499849",
      "transactionIndex": "272",
      "from": "0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97",
      "to": "0x2bf916f8169ed2a77324d3e168284fc252ae4087",
      "value": "107190914536989255",
      "gas": "27329",
      "gasPrice": "4208702930",
      "isError": "0",
      "txreceipt_status": "1",
      "contractAddress": "",
      "gasUsed": "27329",
      "confirmations": "17"
    }
  ]
}

{
"status": "0",
"message": "NOTOK-invalid arguments",
"result": "Error! Invalid account address"
}

Get Account Token Transfer List

$ACTION = tokentx

Returns information about ERC20 token transfers, including several pieces of information about the transaction in which the token transfer occurred.

Example:

https://rest-api.ethvm.dev/?module=account&action=tokentx&address=0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97&startblock=0&endblock=999999999999&offset=2&page=1&sort=desc

Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "19863793",
      "timeStamp": "1715635847",
      "hash": "0x3af7e7d515be9ab0811e7dc537600400a29570b204139a98c8edfeec559fc136",
      "nonce": "327424",
      "blockHash": "0xef2682a79d85b7b8ee81add51c764acbb275e91383e2c59c9144e74afc5b4a60",
      "from": "0x0000000000000000000000000000000000000000",
      "contractAddress": "0x74f306d64244319f642bf405054743a5a8400302",
      "to": "0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97",
      "value": "50436024114842381",
      "tokenName": "",
      "tokenSymbol": "",
      "tokenDecimal": "",
      "transactionIndex": "192",
      "gas": "27527",
      "gasPrice": "5709213495",
      "gasUsed": "27527",
      "confirmations": "360"
    },
    {
      "blockNumber": "19863762",
      "timeStamp": "1715635475",
      "hash": "0x461ce69e488fdc00c598d721282de1f5a18fe1fc3b6bcdd089f04fc16455c885",
      "nonce": "327404",
      "blockHash": "0x76c4dafa59d88443c33eaae2cf9702dcd400ebb9c807767f6c5a1a7e2f09c768",
      "from": "0x0000000000000000000000000000000000000000",
      "contractAddress": "0x74f306d64244319f642bf405054743a5a8400302",
      "to": "0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97",
      "value": "56647433759507158",
      "tokenName": "",
      "tokenSymbol": "",
      "tokenDecimal": "",
      "transactionIndex": "166",
      "gas": "27527",
      "gasPrice": "6827968043",
      "gasUsed": "27527",
      "confirmations": "391"
    }
  
  ]
}

{
"status": "0",
"message": "NOTOK-invalid arguments",
"result": "Error! Invalid account address"
}

Get Account NFT Token Transfer List

$ACTION = tokennfttx

Returns information about ERC721 token transfers, including several pieces of information about the transaction in which the token transfer occurred.

Example

https://rest-api.ethvm.dev/?module=account&action=tokennfttx&address=0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97&startblock=0&endblock=999999999999&offset=2&page=1&sort=desc

Response

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "blockNumber": "19545352",
      "timeStamp": "1711784423",
      "hash": "0x8bc5db33234d67b5cf2013d63f1997aecd397439ffb9e58c6e179ad20037fb63",
      "nonce": "11095",
      "blockHash": "0x6cc857e3ff30d315b40595da691e21f54e2e45f3ad9b44d28f3f0f61468c276a",
      "from": "0xc821d3d24c27c713a9e2758086bd29b23f7381e2",
      "contractAddress": "0x085f81803db511dc19d0ce93f74e6a8937b58b81",
      "to": "0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97",
      "tokenID": "7914",
      "tokenName": "Eggi",
      "tokenSymbol": "Eggi",
      "tokenDecimal": "",
      "transactionIndex": "68",
      "gas": "1238822",
      "gasPrice": "19304711927",
      "gasUsed": "892551",
      "confirmations": "318857"
    },
    {
      "blockNumber": "19545352",
      "timeStamp": "1711784423",
      "hash": "0x8bc5db33234d67b5cf2013d63f1997aecd397439ffb9e58c6e179ad20037fb63",
      "nonce": "11095",
      "blockHash": "0x6cc857e3ff30d315b40595da691e21f54e2e45f3ad9b44d28f3f0f61468c276a",
      "from": "0xc821d3d24c27c713a9e2758086bd29b23f7381e2",
      "contractAddress": "0xc6c31e615fd4ec927292ad35198d78843d96efdb",
      "to": "0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97",
      "tokenID": "9529",
      "tokenName": "Stone",
      "tokenSymbol": "STN",
      "tokenDecimal": "",
      "transactionIndex": "68",
      "gas": "1238822",
      "gasPrice": "19304711927",
      "gasUsed": "892551",
      "confirmations": "318857"
    }
  ]
}

{
  "error": "Invalid request"
}

Get Account' Mined Blocks

$ACTION = getminedblocks

Get mined blocks by account, including block number, timestamp, and reward. Note that at this time Bolt does not support retrieving uncles with this method.

Example

https://rest-api.ethvm.dev/?module=account&action=getminedblocks&address=0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97&startblock=0&endblock=999999999999&offset=2&page=1&sort=desc

Response

https://rivet-etherscan-api.ethvm.dev/?module=account&action=tokennfttx&address=0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97&startblock=0&endblock=999999999999&offset=2&page=1&sort=desc

{
  "error": "Invalid request"
}

PreviousAPI Endpoints NextToken

Last updated 1 year ago