# EtherAura Docs

By [EtherAura](https://paragraph.com/@etheraura) · 2024-03-13

---

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](https://docs.etheraura.net/quickstart#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](https://docs.etheraura.net/quickstart#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?](https://docs.etheraura.net/quickstart#whats-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](https://docs.etheraura.net/authentication#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](https://docs.etheraura.net/authentication#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](https://docs.etheraura.net/simple#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](https://docs.etheraura.net/simple#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](https://docs.etheraura.net/simple#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](https://docs.etheraura.net/simple#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](https://docs.etheraura.net/simple#get-token-transfers-2)
------------------------------------------------------------------------------

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](https://docs.etheraura.net/simple#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"
    }

---

*Originally published on [EtherAura](https://paragraph.com/@etheraura/etheraura-docs)*