API Documentation
Use the EtherAura API to access EVM JSON-RPC, or simplified API
Getting started
To get started, create a new account in the EtherAura dashboard and grab your API key in the overview page, then read about how to make requests for the resources you need to access using our HTTP APIs.
Quickstart
This guide will get you all set up and ready to use the EtherauraAPI. We'll cover how to get started using one of our API clients and how to make your first API request. We'll also look at where to go next to find all the information you need to take full advantage of our powerful REST API.
Choose your client
Before making your first API request, you need to pick which API client you will use. In addition to good ol' cURL HTTP requests, Etheraura offers clients for JavaScript, Python, and PHP. In the following example, you can see how to install each client.
cURL is most likely already installed on your machine
curl --version
Making your first API request
After picking your preferred client, you are ready to make your first call to the EtherAura API. Below, you can see how to send a GET request to the chains endpoint to get a list of all available chains.
curl https://api.etheraura.net/chains -H "x-api-key: {token}"
What's next?
Great, you're now set up with an API client and have made your first request to the API. Here are a few links that might be handy as you venture further into the EtherAura API:
Authentication
Even if all endpoints are free to use, using the API key will remove any request limit. You'll need to authenticate your requests to access any of the endpoints in the EtherAura API. In this guide, we'll look at how authentication works. EtherAura uses two methods to authenticate your API requests.
JSON-RPC endpoints Auth
The recommended way to authenticate with the EtherAura API is by passing your access token directly in the URL — you will find it in the EtherAura dashboard homepage. Here's how you can use curl to perform a request:
curl -X POST https://eth.etheraura.net/eth/xTa32wRK9ax22RDSVDxxZfLtNCPiH3ibraJySmzqj1R0mytvNCcn7Nh5FKCbjOSZ -H 'Content-Type: application/json' -d '{"method":"eth_syncing","params":[],"id":67,"jsonrpc":"2.0"}'
Using the simplified API
In case you prefer to use our simplified API, you need to include the token in the request headers. Here is how to add the token to the request header using cURL:
curl https://api.etheraura.net/chains -H "x-api-key: {token}"
Simple API
As the name suggests, the simplified API returns EVM data in a simplified way, values are decoded server-side for you.
List all chains
This endpoint allows you to retrieve a list of all available networks
curl https://api.etheraura.net/chains -H "x-api-key: {token}"
[
{
"chain_id": 1
},
{
"chain_id": 56
},
{
"chain_id": 137
}
]
Get Block
This endpoint allows you to fetch a block by number.
Required params
chainId - number - The network chain ID
blockNumber - number - The block number
Optional params
includeLogs - boolean - Include block logs (default: false)
curl https://api.etheraura.net/getblock?chainId=1&blockNumber=4719569&includeLogs=true -H "x-api-key: {token}"
{
"block":{
"chain_id":1,
"block_number":"4719569",
"block_hash":"0x3796b5a449d2a888ee214f70613981e036beef741f9916e2e1e6653721b406d2",
"parent_hash":"0xd6e5f60d6b2367e74cd2aa520dbeb104826c3932eb482cc16e7f7ef5f8f74799",
"block_timestamp":"2017-12-12T11:17:39.000Z"
},
"logs":[
{
"chain_id":1,
"block_number":"4719569",
"log_index":0,
"block_hash":"0x3796b5a449d2a888ee214f70613981e036beef741f9916e2e1e6653721b406d2",
"transaction_hash":"0xadb7fc2d92c0ed83da86636d48dc5604815e1379b94d99fc8c270862ddbb70d4",
"transaction_index":1,
"address":"0x93e682107d1e9defb0b5ee701c71707a4b2e46bc",
"topic0":"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1":"0x000000000000000000000000d2c263b8a82820809b2fe41bc20ac1daff0d7e9f",
"topic2":"0x0000000000000000000000004d519a67063ae26a1e78c9e7a0a1189acc7da0c3",
"topic3":"0x",
"data":"0x000000000000000000000000000000000000000000000000000000021348ec88"
}
]
}
Get Logs
This endpoint allows you to fetch logs .
Required params
chainId - number - The network chain ID
fromBlock - number - The starting block number
toBlock - number - The ending block number
Optional params
address - text - Filter by contract address
topic - text - Filter by topic0
curl https://api.etheraura.net/getlogs?chainId=1&fromBlock=4719569&toBlock=4719650 -H "x-api-key: {token}"
[
{
"chain_id": 1,
"block_number": "4719569",
"log_index": 0,
"block_hash": "0x3796b5a449d2a888ee214f70613981e036beef741f9916e2e1e6653721b406d2",
"transaction_hash": "0xadb7fc2d92c0ed83da86636d48dc5604815e1379b94d99fc8c270862ddbb70d4",
"transaction_index": 1,
"address": "0x93e682107d1e9defb0b5ee701c71707a4b2e46bc",
"topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1": "0x000000000000000000000000d2c263b8a82820809b2fe41bc20ac1daff0d7e9f",
"topic2": "0x0000000000000000000000004d519a67063ae26a1e78c9e7a0a1189acc7da0c3",
"topic3": "0x",
"data": "0x000000000000000000000000000000000000000000000000000000021348ec88"
}
]
Get Transaction
This endpoint allows you to fetch a transaction by hash
Required params
chainId - number - The network chain ID
txHash - text - The transaction hash
Optional params
includeLogs - boolean - Include tx logs (default: false)
curl https://api.etheraura.net/gettx?chainId=1&txHash=0xb80b4cade2d5d7a7cc6a501ed69ea240db38fe89033ce4863d4be83a6458ef1f -H "x-api-key: {token}"
{
"transaction": {
"chain_id": 1,
"block_number": "4741117",
"tx_index": 291,
"block_hash": "0x9de0f467be686e6733a9eb11764027fcde0783ae54185a218d0fbfdea79af698",
"transaction_hash": "0xb80b4cade2d5d7a7cc6a501ed69ea240db38fe89033ce4863d4be83a6458ef1f",
"nonce": 107630,
"selector": "0x",
"creates": "0x",
"value": "1028720000000000",
"gas_limit": "30000",
"gas_price": "10000000000",
"max_priority_fee_per_gas": null,
"max_fee_per_gas": null,
"from": "0x5f42801ac21677008433d70f1060831ff2a04602",
"to": "0x9930c18ff2f6ae31b7c70b90b0ed69ac8fc42ef3",
"data": "0x"
},
"logs": []
}
Get Token Transfers
This endpoint allows you to fetch a token transfers
Required params
chainId - number - The network chain ID
fromBlock - number - The starting block
toBlock - number - The ending block
address - text - The from or to address
curl https://api.etheraura.net/gettokentransfers?chainId=1&address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&fromBlock=15000000&toBlock=15000010 -H "x-api-key: {token}"
[
{
"chain_id": 1,
"block_number": "19420662",
"transaction_hash": "0xb3381f7f7278f5706983322eb964b31b2227b3b73e734a1cd4201b2f924b271f",
"log_index": 292,
"token": "0xcb5ab3f47bef834722c51a793f2e3a4d1b75a791",
"from": "0x089d496fe44686fefe81fe19bf38b77b01d5ddcb",
"to": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"amount": "14912900553004566"
}
]
Get Token Transfers
This endpoint allows you to fetch a token transfers
Required params
chainId - number - The network chain ID
address - text - The address
curl https://api.etheraura.net/gettokenbalances?chainId=1&address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -H "x-api-key: {token}"
[
{
"balance": "14912900553004566",
"decimals": 8,
"symbol": "GPUAI",
"name": "NVIDIA GPU AI",
"token": "0xcb5ab3f47bef834722c51a793f2e3a4d1b75a791"
}
]
Get Token by Address
This endpoint allows you to fetch a token transfers
Required params
chainId - number - The network chain ID
address- text - The token address
curl https://api.etheraura.net/gettokenbyaddress?chainId=1&address=0x090185f2135308bad17527004364ebcc2d37e5f6 -H "x-api-key: {token}"
{
"chain_id": 1,
"symbol": "SPELL",
"name": "Spell Token",
"decimals": 18,
"address": "0x090185f2135308bad17527004364ebcc2d37e5f6"
}