Subscribe to EtherAura

<100 subscribers

Subscribe to EtherAura

<100 subscribers

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"
}

API Documentation

Use the EtherAura API to access EVM JSON-RPC, or simplified API

Getting started

Quickstart

Choose your client

cURL is most likely already installed on your machine

curl --version

Making your first API request

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

JSON-RPC endpoints Auth

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"
}

More from EtherAura

More from EtherAura

No activity yet

EtherAura

More from EtherAura

No activity yet

More from EtherAura

No activity yet

No activity yet

EtherAura Docs

EtherAura Docs

API Documentation

Getting started

Quickstart

Authentication

Simple API

Required params

Optional params

Required params

Optional params

Get Transaction

Required params

Optional params

Required params

Required params

Required params

API Documentation

Getting started

Quickstart

Authentication

Simple API

Required params

Optional params

Required params

Optional params

Get Transaction

Required params

Optional params

Required params

Required params

Required params