Etherscan APIs

https://docs.etherscan.io/
Admin
Etherscan APIs provide developers with direct access to Etherscan's block explorer data and services...
Tokens:357,801
Snippets:2,216
Trust Score:9.9
Update:1 week ago
Show doc for...
Tokens:
Raw
### Go example for Get Plasma Deposits by Address

Source: https://docs.etherscan.io/api-reference/endpoint/txnbridge

Go example using net/http to call the endpoint and print the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?module=account&action=txnbridge&apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Ruby example for forwardresolve

Source: https://docs.etherscan.io/api-reference/endpoint/forwardresolve

Ruby example using `net/http` to call the forwardresolve endpoint. It sets up an HTTPS GET request and prints the response body.

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?module=ens&action=forwardresolve&apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### Go example for Export Label Master List

Source: https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist

Go example using net/http to GET the label master list endpoint. It creates a request, executes it, reads the body, and prints it. The apikey parameter is empty in the example.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-metadata.etherscan.io/v1/api.ashx?module=nametag&action=getlabelmasterlist&apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### JavaScript fetch example for Get Plasma Deposits by Address

Source: https://docs.etherscan.io/api-reference/endpoint/txnbridge

JavaScript example using fetch to call the endpoint and log the JSON response.

```javascript
const options = {method: 'GET'};

fetch('https://api.etherscan.io/v2/api?module=account&action=txnbridge&apikey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

--------------------------------

### Go request for getcontractcreation

Source: https://docs.etherscan.io/api-reference/endpoint/getcontractcreation

Go example using net/http to send a GET request and print the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?module=contract&action=getcontractcreation&apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Python requests example for Get Plasma Deposits by Address

Source: https://docs.etherscan.io/api-reference/endpoint/txnbridge

Python example using the requests library to call the endpoint. Prints the response text.

```python
import requests

url = "https://api.etherscan.io/v2/api?module=account&action=txnbridge&apikey="

response = requests.get(url)

print(response.text)
```

--------------------------------

### Go example for getminedblocks

Source: https://docs.etherscan.io/api-reference/endpoint/getminedblocks

Go example using net/http to make a GET request to the Etherscan API v2 endpoint. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?module=account&action=getminedblocks&apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Example prompt: Get ERC-20 transfers and save as CSV

Source: https://docs.etherscan.io/build-with-ai/skills/etherscan

Example user prompt that asks the skill to retrieve all ERC-20 transfers for a specific address and save them as CSV. The skill confirms the chain and routes to the connected interface.

```text
Get all ERC-20 transfers for 0x9fC3dc011b461664c835F2527fffb1169b3C213e and save them as CSV. use etherscan skill

```

--------------------------------

### Go example for getblockreward with net/http

Source: https://docs.etherscan.io/api-reference/endpoint/getblockreward

Go example using the standard `net/http` package to perform a GET request to the Etherscan v2 API `module=block&action=getblockreward`. It reads the response body and prints it. Error handling is omitted in the sample.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?module=block&action=getblockreward&apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go HTTP example for getlabelmasterlist

Source: https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist-v2

Use Go's net/http package to perform a GET request to the Etherscan API and print the response body. Replace the apikey parameter with your API key. The example uses http.DefaultClient.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-metadata.etherscan.io/v2/api?module=nametag&action=getlabelmasterlist&apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Ruby request for getcontractcreation

Source: https://docs.etherscan.io/api-reference/endpoint/getcontractcreation

Ruby example using net/http to send a GET request and print the response body.

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?module=contract&action=getcontractcreation&apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### Example prompt: Build a wallet snapshot

Source: https://docs.etherscan.io/build-with-ai/mcp

Ask the agent to build a wallet snapshot for a given address on Ethereum and Arbitrum, including native balance, top token holdings, and the 10 most recent transactions.

```text
Build a wallet snapshot for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum and Arbitrum: native balance, top token holdings, and the 10 most recent transactions.

```

--------------------------------

### Java Unirest example for Get Plasma Deposits by Address

Source: https://docs.etherscan.io/api-reference/endpoint/txnbridge

Java example using the Unirest HTTP library to call the endpoint and get the response as a string.

```java
HttpResponse<String> response = Unirest.get("https://api.etherscan.io/v2/api?module=account&action=txnbridge&apikey=")
  .asString();
```

--------------------------------

### Ruby Net::HTTP example for Export Label Master List

Source: https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist

Ruby example using Net::HTTP to GET the label master list endpoint. It sets use_ssl to true, sends a GET request, and prints the response body. The apikey parameter is empty in the example.

```ruby
require 'uri'
require 'net/http'

url = URI("https://api-metadata.etherscan.io/v1/api.ashx?module=nametag&action=getlabelmasterlist&apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### Run first trace with etherscan-flow skill

Source: https://docs.etherscan.io/build-with-ai/skills/etherscan-flow

Example prompt to start a trace by describing a case in plain language. The agent pulls live transactions and returns an import-ready Flow Case.

```text
trace this scam 0x<txhash>. use etherscan-flow skill
```

--------------------------------

### Install Etherscan CLI (Homebrew, npm, script, PowerShell, Go)

Source: https://docs.etherscan.io/llms-full.txt

Install the Etherscan CLI using Homebrew, npm, a shell script, PowerShell, or Go. The npm command also shows how to run without installing via npx. The Go install requires Go 1.25+ and GOBIN (or GOPATH/bin) on your PATH.

```bash
brew install etherscan/etherscan-cli/etherscan
```

```bash
npm install -g @etherscan/cli

# Or run without installing
npx @etherscan/cli version
```

```bash
curl -fsSL https://raw.githubusercontent.com/etherscan/etherscan-cli/master/scripts/install.sh | sh
```

```powershell
# PowerShell
irm https://raw.githubusercontent.com/etherscan/etherscan-cli/master/scripts/install.ps1 | iex

# Command Prompt
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/etherscan/etherscan-cli/master/scripts/install.ps1 | iex"
```

```bash
# Requires Go 1.25+; ensure GOBIN (or GOPATH/bin) is on your PATH
go install github.com/etherscan/etherscan-cli/cmd/etherscan@latest
```

--------------------------------

### Get ERC1155 Token Transfers by Address - API Request Examples

Source: https://docs.etherscan.io/api-reference/endpoint/token1155tx

Example requests for the Etherscan v2 API endpoint `module=account&action=token1155tx`. Each snippet sends a GET request to `https://api.etherscan.io/v2/api?module=account&action=token1155tx&apikey=` and prints or returns the response. The `apikey` parameter is left empty in the examples; you must supply your own API key.

```bash
curl --request GET \
  --url 'https://api.etherscan.io/v2/api?module=account&action=token1155tx&apikey='
```

```python
import requests

url = "https://api.etherscan.io/v2/api?module=account&action=token1155tx&apikey="

response = requests.get(url)

print(response.text)
```

```javascript
const options = {method: 'GET'};

fetch('https://api.etherscan.io/v2/api?module=account&action=token1155tx&apikey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.etherscan.io/v2/api?module=account&action=token1155tx&apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?module=account&action=token1155tx&apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.etherscan.io/v2/api?module=account&action=token1155tx&apikey=")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?module=account&action=token1155tx&apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### Go net/http example for eth_gasPrice

Source: https://docs.etherscan.io/api-reference/endpoint/ethgasprice

Go example using the net/http package to call the eth_gasPrice endpoint. Replace the apikey parameter with your Etherscan API key. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?module=proxy&action=eth_gasPrice&apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Install via Go

Source: https://docs.etherscan.io/build-with-ai/cli

Installs the Etherscan CLI using Go, requiring Go 1.25+ and GOBIN (or GOPATH/bin) on your PATH.

```bash
# Requires Go 1.25+; ensure GOBIN (or GOPATH/bin) is on your PATH
go install github.com/etherscan/etherscan-cli/cmd/etherscan@latest

```

--------------------------------

### Profile DAO or protocol prompts

Source: https://docs.etherscan.io/build-with-ai/skills/etherscan-flow

Example prompts to profile a DAO, protocol, or business from a verified scope. Supports optional inline apikey=YOUR_KEY parameter.

```text
show ENS DAO as a business
show ENS DAO as a business using these treasury, controller, and timelock addresses: 0x<address> 0x<address>
map income and spending for this protocol treasury 0x<address>
show where this DAO gets income and how it spends money, with totals, apikey=YOUR_KEY 0x<address>

```

--------------------------------

### PHP cURL example for Get Plasma Deposits by Address

Source: https://docs.etherscan.io/api-reference/endpoint/txnbridge

PHP example using cURL to call the endpoint. Handles errors and prints the response.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.etherscan.io/v2/api?module=account&action=txnbridge&apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

--------------------------------

### Show module help

Source: https://docs.etherscan.io/llms-full.txt

Shows the options available for a given module. Run this to see the flags for any command.

```bash
etherscan <module> --help
```

--------------------------------

### Run first review prompt

Source: https://docs.etherscan.io/build-with-ai/skills/etherscan-contract-review

Example prompt to run a first review. Provide a contract address and chain, then ask for a review using the skill.

```text
review 0xdAC17F958D2ee523a2206206994597C13D831ec7 on Ethereum. use etherscan-contract-review skill

```

--------------------------------

### Python requests example for Export Label Master List

Source: https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist

Python example using the requests library to GET the label master list endpoint. It prints the response text. The apikey parameter is empty in the example.

```python
import requests

url = "https://api-metadata.etherscan.io/v1/api.ashx?module=nametag&action=getlabelmasterlist&apikey="

response = requests.get(url)

print(response.text)
```

--------------------------------

### Claude Desktop Sample Documentation Query

Source: https://docs.etherscan.io/build-with-ai/docs-mcp

A sample question to ask the agent after connecting. The agent uses search_etherscan to find the account module's addresstokenbalance action.

```text
Which Etherscan endpoint returns an address's ERC-20 token balances, and what parameters does it take?
```

--------------------------------

### Ruby Net::HTTP example for Get Plasma Deposits by Address

Source: https://docs.etherscan.io/api-reference/endpoint/txnbridge

Ruby example using Net::HTTP to call the endpoint and print the response body.

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?module=account&action=txnbridge&apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### Install via script (Windows)

Source: https://docs.etherscan.io/build-with-ai/cli

Installs the Etherscan CLI on Windows using PowerShell or Command Prompt.

```powershell
# PowerShell
irm https://raw.githubusercontent.com/etherscan/etherscan-cli/master/scripts/install.ps1 | iex

# Command Prompt
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/etherscan/etherscan-cli/master/scripts/install.ps1 | iex"

```

--------------------------------

### Java Unirest example for getminedblocks

Source: https://docs.etherscan.io/api-reference/endpoint/getminedblocks

Java example using Unirest to make a GET request to the Etherscan API v2 endpoint. Returns an HttpResponse<String>.

```java
HttpResponse<String> response = Unirest.get("https://api.etherscan.io/v2/api?module=account&action=getminedblocks&apikey=")
  .asString();
```

--------------------------------

### Go example for forwardresolve

Source: https://docs.etherscan.io/api-reference/endpoint/forwardresolve

Go example using the standard `net/http` package to call the forwardresolve endpoint. It reads the response body and prints it.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?module=ens&action=forwardresolve&apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### PHP cURL example for forwardresolve

Source: https://docs.etherscan.io/api-reference/endpoint/forwardresolve

PHP example using cURL to call the forwardresolve endpoint. It sets up a GET request and prints the response or any cURL error.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.etherscan.io/v2/api?module=ens&action=forwardresolve&apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

--------------------------------

### Clone repo and copy skill to ~/.claude/skills

Source: https://docs.etherscan.io/build-with-ai/skills/etherscan-contract-review

Alternative installation by cloning the repository and copying the skill folder into the agent's skills directory (~/.claude/skills/).

```bash
git clone https://github.com/etherscan/skills.git etherscan-skills
cp -r etherscan-skills/skills/etherscan-contract-review ~/.claude/skills/

```

--------------------------------

### Import draft or link prompts

Source: https://docs.etherscan.io/build-with-ai/skills/etherscan-flow

Example prompts to import a draft, notes, or any link and have every claim verified onchain. Supports optional inline apikey=YOUR_KEY parameter.

```text
extract the flows from this gist and build the case: https://gist.github.com/<user>/<id> apikey=YOUR_KEY
someone reported this scam on X — verify it and build the case: https://x.com/<user>/status/<id>
build a case from the addresses in this article: https://<news-site>/<path>
here's my draft case JSON — validate it and produce a verified version: <pasted draft>

```

--------------------------------

### Java Unirest example for Export Label Master List

Source: https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist

Java example using the Unirest HTTP library to GET the label master list endpoint. It returns an HttpResponse<String> object. The apikey parameter is empty in the example.

```java
HttpResponse<String> response = Unirest.get("https://api-metadata.etherscan.io/v1/api.ashx?module=nametag&action=getlabelmasterlist&apikey=")
  .asString();
```

--------------------------------

### JavaScript fetch example for Export Label Master List

Source: https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist

JavaScript example using fetch to GET the label master list endpoint. It parses the response as JSON and logs it, with error handling. The apikey parameter is empty in the example.

```javascript
const options = {method: 'GET'};

fetch('https://api-metadata.etherscan.io/v1/api.ashx?module=nametag&action=getlabelmasterlist&apikey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

--------------------------------

### Go example to verify Stylus source code

Source: https://docs.etherscan.io/api-reference/endpoint/verifystylus

Uses net/http to POST the verification payload. Prints the response body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?module=contract&action=verifysourcecode&apikey="

	payload := strings.NewReader("codeformat=stylus&sourceCode=https%3A%2F%2Fgithub.com%2FOffchainLabs%2Fstylus-hello-world&contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&contractname=stylus_hello_world&compilerversion=stylus%3A0.5.3&licenseType=3")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/x-www-form-urlencoded")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### GET /v2/api?module=stats&action=dailyblockrewards

Source: https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards

Documentation for the Get Daily Block Rewards endpoint, including request parameters, example requests in multiple languages, and the response structure.

```APIDOC
## GET /v2/api

### Description
Get the amount of block rewards distributed to miners for a specified date range. This endpoint returns the daily block rewards in Ether for each day.

### Method
GET

### Endpoint
https://api.etherscan.io/v2/api?module=stats&action=dailyblockrewards&apikey=

### Parameters
#### Query Parameters
- **module** (string) - Required - Must be set to `stats`.
- **action** (string) - Required - Must be set to `dailyblockrewards`.
- **apikey** (string) - Required - Your Etherscan API key.

### Request Example
```
curl --request GET \
  --url 'https://api.etherscan.io/v2/api?module=stats&action=dailyblockrewards&apikey='
```

### Response
#### Success Response (200)
- **status** (string) - Status code of the response.
- **message** (string) - Message describing the response.
- **result** (array) - Array of daily block reward records.
  - **UTCDate** (string) - The date in UTC format (YYYY-MM-DD).
  - **unixTimeStamp** (string) - The Unix timestamp for the date.
  - **blockRewards_Eth** (string) - The total block rewards in Ether for that day.

#### Response Example
```
{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "UTCDate": "2019-02-01",
      "unixTimeStamp": "1548979200",
      "blockRewards_Eth": "15300.65625"
    },
    {
      "UTCDate": "2019-02-02",
      "unixTimeStamp": "1549065600",
      "blockRewards_Eth": "15611.625"
    }
  ]
}
```

### Notes
- This is a PRO endpoint, available to the Standard Plan and above.
```

--------------------------------

### Example response for Get Plasma Deposits by Address

Source: https://docs.etherscan.io/api-reference/endpoint/txnbridge

Example JSON response showing a successful request with status '1' and a result array containing deposit details.

```json
{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "hash": "0xf645deb2b6fbb8b76ccbcf4bde782e28d3520e8a30e9a568b9b8c526e2fd8434",
      "blockNumber": "51844560",
      "timeStamp": "1704181285",
      "from": "0x0000000000000000000000000000000000000000",
      "address": "0x4880bd4695a8e59dc527d124085749744b6c988e",
      "amount": "2341706540000000000",
      "tokenName": "Polygon Token",
      "symbol": "POL",
      "contractAddress": "0x0000000000000000000000000000000000001010",
      "divisor": "18"
    }
  ]
}
```

--------------------------------

### Go example for ethprice

Source: https://docs.etherscan.io/api-reference/endpoint/ethprice

Uses Go's net/http package to send a GET request to the ethprice endpoint and prints the response body. Ignores errors for brevity.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?module=stats&action=ethprice&apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### cURL request to get event logs

Source: https://docs.etherscan.io/api-reference/endpoint/getlogs

Sends a GET request to the Etherscan V2 API to retrieve event logs for an address. The apikey parameter is left empty in the example.

```bash
curl --request GET \
  --url 'https://api.etherscan.io/v2/api?module=logs&action=getLogs&apikey='
```

--------------------------------

### Example response for GET /api/v1/trades/display

Source: https://docs.etherscan.io/api-reference/endpoint/get-prediction-market-trades-by-address

Example JSON response showing a successful request with trade data. The response includes fields like time, action, price, quantity, and trader.

```json
{
  "success": true,
  "code": "0",
  "message": "success",
  "data": {
    "items": [
      {
        "time": 1780455348,
        "action": "Buy",
        "recordType": "TRADE",
        "actionType": 0,
        "price": 93.000002030000088000,
        "quantity": 42.857141000000000000,
        "fee": 0E-18,
        "grossValue": 39.857142000000000000,
        "perLegTxValue": 0E-18,
        "transferNetAmount": 42.857141000000000000,
        "txHash": "0x86659cd0973c7054662ea373f4aef5e902534a83bc101423bcbfb5903911481c",
        "tokenId": "99712600321456820436514549846085788583993494623577833658394864438542452432374",
        "marketId": "2394628",
        "marketSlug": "nhl-las-car-2026-06-02",
        "eventSlug": "nhl-las-car-2026-06-02",
        "conditionId": "",
        "marketTitle": "Golden Knights vs. Hurricanes",
        "positionSide": "Golden Knights",
        "outcomeIndex": 0,
        "logo": "https://polymarket-upload.s3.us-east-2.amazonaws.com/nhl.png",
        "quantityPercentage": 100.0000,
        "trader": "0x6a72f61820b26b1fe4d956e17b6dc2a1ea3033ee",
        "liquidityRole": "MAKER",
        "counterpartyCount": 1,
        "counterpartyTrades": null
      },
      {
        "time": 1780455346,
        "action": "Buy",
        "recordType": "TRADE",
        "actionType": 0,
        "price": 93.000000000000000000,
        "quantity": 24.850000000000000000,
        "fee": 0E-18,
        "grossValue": 23.110500000000000000,
        "perLegTxValue": 0E-18,
        "transferNetAmount": 24.850000000000000000,
        "txHash": "0x0edf7fc704fd4de58d90a3891bccca0442f8ce14d485bcaa603748a86079c3e9",
        "tokenId": "99712600321456820436514549846085788583993494623577833658394864438542452432374",
        "marketId": "2394628",
        "marketSlug": "nhl-las-car-2026-06-02",
        "eventSlug": "nhl-las-car-2026-06-02",
        "conditionId": "",
        "marketTitle": "Golden Knights vs. Hurricanes",
        "positionSide": "Golden Knights",
        "outcomeIndex": 0,
        "logo": "https://polymarket-upload.s3.us-east-2.amazonaws.com/nhl.png",
        "quantityPercentage": 100.0000,
        "trader": "0x6a72f61820b26b1fe4d956e17b6dc2a1ea3033ee",
        "liquidityRole": "MAKER",
        "counterpartyCount": 1,
        "counterpartyTrades": null
      }
    ],
    "nextCursor": "MTc4MDQ1NTM0Nnw4NzgzNzUwMHwxMDY0fDB4MGVkZjdmYzcwNGZkNGRlNThkOTBhMzg5MWJjY2NhMDQ0MmY4Y2UxNGQ0ODViY2FhNjAzNzQ4YTg2MDc5YzNlOToxMDY0"
  }
}
```

--------------------------------

### Install via Homebrew

Source: https://docs.etherscan.io/build-with-ai/cli

Installs the Etherscan CLI using Homebrew on macOS or Linux.

```bash
brew install etherscan/etherscan-cli/etherscan

```

--------------------------------

### Verify Proxy Contract Example Response

Source: https://docs.etherscan.io/api-reference/endpoint/verifyproxycontract

Example JSON response from the verifyproxycontract endpoint. The result field contains a GUID for the proxy verification submission, which can be used with checkproxyverification to poll the result.

```json
{
    "status": "1",
    "message": "OK",
    "result": "a7lpxkm9kpcpicx7daftmjifrfhiuhf5vqqnawhkfhzfrcpnxj"
}

```

--------------------------------

### Install Etherscan skill by cloning repository

Source: https://docs.etherscan.io/build-with-ai/skills/etherscan

Clones the Etherscan skills repository and copies the etherscan skill folder into the agent's skills directory (~/.claude/skills/).

```bash
git clone https://github.com/etherscan/skills.git etherscan-skills
cp -r etherscan-skills/skills/etherscan ~/.claude/skills/

```

--------------------------------

### PHP cURL example for Export Label Master List

Source: https://docs.etherscan.io/api-reference/endpoint/getlabelmasterlist

PHP example using cURL to GET the label master list endpoint. It sets CURLOPT_RETURNTRANSFER and other options, executes the request, and prints the response or a cURL error. The apikey parameter is empty in the example.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-metadata.etherscan.io/v1/api.ashx?module=nametag&action=getlabelmasterlist&apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

--------------------------------

### GET eth_getTransactionByBlockNumberAndIndex

Source: https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyblocknumberandindex

Documentation for the eth_getTransactionByBlockNumberAndIndex endpoint, including parameters, request example, and response schema.

```APIDOC
## [GET] https://api.etherscan.io/v2/api?module=proxy&action=eth_getTransactionByBlockNumberAndIndex&apikey=

### Description
Returns the information of a transaction identified by its block number and transaction index position. This endpoint uses the proxy module to access the Ethereum JSON-RPC method eth_getTransactionByBlockNumberAndIndex.

### Method
GET

### Endpoint
https://api.etherscan.io/v2/api?module=proxy&action=eth_getTransactionByBlockNumberAndIndex&apikey=

### Parameters
#### Query Parameters
- **apikey** (string) - Required - Enter your Etherscan API key, or set one up if you don't have one.
- **chainid** (string) - Required - Chain ID to query, eg 1 for Ethereum, 42161 for Arbitrum from our supported chains.
- **module** (string) - Required - Set to proxy for this endpoint. Default: proxy.
- **action** (string) - Required - Set to eth_getTransactionByBlockNumberAndIndex for this endpoint. Default: eth_getTransactionByBlockNumberAndIndex.
- **tag** (string) - Block number in hex format.
- **index** (string) - Transaction index position in the block, in hex.

### Request Example
```ruby
require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?module=proxy&action=eth_getTransactionByBlockNumberAndIndex&apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

### Response
#### Success Response (200)
- **jsonrpc** (string) - JSON-RPC protocol version.
- **id** (integer) - Request identifier, echoed back from the request.
- **result** (object) - The transaction object with the following child attributes:
  - **blockHash** (string) - Hash of the block containing the transaction.
  - **blockNumber** (string) - Block number in hex format.
  - **from** (string) - Address of the sender.
  - **gas** (string) - Gas provided by the sender.
  - **gasPrice** (string) - Gas price provided by the sender in wei.
  - **maxFeePerGas** (string) - Maximum fee per gas.
  - **maxPriorityFeePerGas** (string) - Maximum priority fee per gas.
  - **hash** (string) - Transaction hash.
  - **input** (string) - Data sent with the transaction.
  - **nonce** (string) - Number of transactions made by the sender prior to this one.
  - **to** (string) - Address of the receiver.
  - **transactionIndex** (string) - Transaction index position in the block.
  - **value** (string) - Value transferred in wei.
  - **type** (string) - Transaction type.
  - **accessList** (array) - Access list for the transaction.
  - **chainId** (string) - Chain ID.
  - **v** (string) - ECDSA recovery id.
  - **r** (string) - ECDSA signature r.
  - **s** (string) - ECDSA signature s.
  - **yParity** (string) - Parity of the y-coordinate of the signature.

#### Response Example
```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0x13c5311a78b9a8790c58f1d0d0660226352a498cc98b06e1861f1967d3a9d1b4",
    "blockNumber": "0xc6331d",
    "from": "0xd1af036d589b6ebfbaa184b339a30d32ef611708",
    "gas": "0x11170",
    "gasPrice": "0x5b7e259a7",
    "maxFeePerGas": "0x5b7e259a7",
    "maxPriorityFeePerGas": "0x5b7e259a7",
    "hash": "0xc7ef51f0bfe85eefbb1d4d88f5a39e82fbfc94987d8cbcb515f74d80b6e44902",
    "input": "0x2d2da806000000000000000000000000d1af036d589b6ebfbaa184b339a30d32ef611708",
    "nonce": "0x0",
    "to": "0xabea9132b05a70803a4e85094fd0e1800777fbef",
    "transactionIndex": "0x11a",
    "value": "0x57930b5db6a000",
    "type": "0x2",
    "accessList": [],
    "chainId": "0x1",
    "v": "0x0",
    "r": "0x595619be17755f7427d07626275e4c89b8f9d5a0a668515165ea000d30f26325",
    "s": "0x33d4b22c7c779fc9f04c81788cb4268d2c3f8dc9e219245570bdd384c6ca6690",
    "yParity": "0x0"
  }
}
```
```

--------------------------------

### Install etherscan-flow skill via CLI or clone

Source: https://docs.etherscan.io/llms-full.txt

Install the Etherscan Flow skill globally for all agents using the skills.sh CLI, or clone the repository and copy the skill folder into your agent's skills directory.

```bash
npx skills add https://github.com/etherscan/skills --skill etherscan-flow -g -a '*' -y
```

```bash
git clone https://github.com/etherscan/skills.git etherscan-skills
cp -r etherscan-skills/skills/etherscan-flow ~/.claude/skills/
```

--------------------------------

### List supported chains

Source: https://docs.etherscan.io/build-with-ai/cli

Lists every supported chain built into the release.

```bash
etherscan chains

```

--------------------------------

### HTTP request examples for Get Historical Native Balance for an Address

Source: https://docs.etherscan.io/api-reference/endpoint/balancehistory

Foundation for the balancehistory endpoint.

```shell
curl --request GET \
  --url 'https://api.etherscan.io/v2/api?module=account&action=balancehistory&apikey='
```

```python
import requests

url = "https://api.etherscan.io/v2/api?module=account&action=balancehistory&apikey="

response = requests.get(url)

print(response.text)
```

```javascript
const options = {method: 'GET'};

fetch('https://api.etherscan.io/v2/api?module=account&action=balancehistory&apikey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.etherscan.io/v2/api?module=account&action=balancehistory&apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?module=account&action=balancehistory&apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.etherscan.io/v2/api?module=account&action=balancehistory&apikey=")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?module=account&action=balancehistory&apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
```

--------------------------------

### Example response for Get Gas Oracle

Source: https://docs.etherscan.io/api-reference/endpoint/gasoracle

Example JSON response from the gas oracle endpoint. Shows status, message, and result fields including SafeGasPrice, ProposeGasPrice, FastGasPrice, suggestBaseFee, and gasUsedRatio.

```json
{
  "status": "1",
  "message": "OK",
  "result": {
    "LastBlock": "23467872",
    "SafeGasPrice": "0.496839934",
    "ProposeGasPrice": "0.496840168",
    "FastGasPrice": "0.55411917",
    "suggestBaseFee": "0.496839934",
    "gasUsedRatio": "0.405942555555556,0.784013777777778,0.502624148542588,0.719479644444444,0.45673524947105"
  }
}
```

--------------------------------

### Install via npm

Source: https://docs.etherscan.io/build-with-ai/cli

Installs the Etherscan CLI globally via npm, or runs it without installing using npx.

```bash
npm install -g @etherscan/cli

# Or run without installing
npx @etherscan/cli version

```

--------------------------------

### Example response for Get Address Funded By

Source: https://docs.etherscan.io/api-reference/endpoint/fundedby

Example JSON response from the Etherscan API for the 'fundedby' action. It includes the block number, timestamp, funding address, funding transaction hash, and value.

```json
{
  "status": "1",
  "message": "OK",
  "result": {
    "block": 53708500,
    "timeStamp": "1708349932",
    "fundingAddress": "0x6969174fd72466430a46e18234d0b530c9fd5f49",
    "fundingTxn": "0xbc0ca4a67eb1555920552246409626cd60df01314dd2bcdb99718b506d9c9946",
    "value": "1000000000000000"
  }
}
```
Tokens:
Raw