# EtherAura Docs

**Published by:** [EtherAura](https://paragraph.com/@etheraura/)
**Published on:** 2024-03-13
**URL:** https://paragraph.com/@etheraura/etheraura-docs

## Content

API DocumentationUse the EtherAura API to access EVM JSON-RPC, or simplified APIGetting startedTo 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.QuickstartThis 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 clientBefore 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 requestAfter 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:AuthenticationEven 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 AuthThe 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 APIIn 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 APIAs the name suggests, the simplified API returns EVM data in a simplified way, values are decoded server-side for you.List all chainsThis endpoint allows you to retrieve a list of all available networkscurl https://api.etheraura.net/chains -H "x-api-key: {token}" [{"chain_id": 1},{"chain_id": 56},{"chain_id": 137}] Get BlockThis endpoint allows you to fetch a block by number.Required paramschainId - number - The network chain ID blockNumber - number - The block numberOptional paramsincludeLogs - 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 LogsThis endpoint allows you to fetch logs .Required paramschainId - number - The network chain ID fromBlock - number - The starting block number toBlock - number - The ending block numberOptional paramsaddress - text - Filter by contract address topic - text - Filter by topic0curl 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 TransactionThis endpoint allows you to fetch a transaction by hashRequired paramschainId - number - The network chain ID txHash - text - The transaction hashOptional paramsincludeLogs - 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 TransfersThis endpoint allows you to fetch a token transfersRequired paramschainId - number - The network chain ID fromBlock - number - The starting block toBlock - number - The ending block address - text - The from or to addresscurl 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 TransfersThis endpoint allows you to fetch a token transfersRequired paramschainId - number - The network chain ID address - text - The addresscurl 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 AddressThis endpoint allows you to fetch a token transfersRequired paramschainId - number - The network chain ID address- text - The token addresscurl 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" }

## Publication Information

- [EtherAura](https://paragraph.com/@etheraura/): Publication homepage
- [All Posts](https://paragraph.com/@etheraura/): More posts from this publication
- [RSS Feed](https://api.paragraph.com/blogs/rss/@etheraura): Subscribe to updates
- [Twitter](https://twitter.com/EtherAuraNet): Follow on Twitter