Get Event Logs by Topics

curl --request GET \
  --url 'https://api.etherscan.io/v2/api?apikey='

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.etherscan.io/v2/api?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;
}

package main

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

func main() {

	url := "https://api.etherscan.io/v2/api?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))

}

require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?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

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "address": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x0000000000000000000000000000000000000000000000000000000000000000",
        "0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d",
        "0x00000000000000000000000000000000000000000000000000000000000000b5"
      ],
      "data": "0x",
      "blockNumber": "0xc48174",
      "blockHash": "0x837e109ab8b1b40ec7d1032bff82397325d85e719b97d900fa0d9aa9745b2c27",
      "timeStamp": "0x60f9ce56",
      "gasPrice": "0x2e90edd000",
      "gasUsed": "0x247205",
      "logIndex": "0x",
      "transactionHash": "0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",
      "transactionIndex": "0x"
    }
  ]
}

GET

api

Get Event Logs by Topics

curl --request GET \
  --url 'https://api.etherscan.io/v2/api?apikey='

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.etherscan.io/v2/api?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;
}

package main

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

func main() {

	url := "https://api.etherscan.io/v2/api?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))

}

require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?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

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "address": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x0000000000000000000000000000000000000000000000000000000000000000",
        "0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d",
        "0x00000000000000000000000000000000000000000000000000000000000000b5"
      ],
      "data": "0x",
      "blockNumber": "0xc48174",
      "blockHash": "0x837e109ab8b1b40ec7d1032bff82397325d85e719b97d900fa0d9aa9745b2c27",
      "timeStamp": "0x60f9ce56",
      "gasPrice": "0x2e90edd000",
      "gasUsed": "0x247205",
      "logIndex": "0x",
      "transactionHash": "0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",
      "transactionIndex": "0x"
    }
  ]
}

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "address": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x0000000000000000000000000000000000000000000000000000000000000000",
        "0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d",
        "0x00000000000000000000000000000000000000000000000000000000000000b5"
      ],
      "data": "0x",
      "blockNumber": "0xc48174",
      "blockHash": "0x837e109ab8b1b40ec7d1032bff82397325d85e719b97d900fa0d9aa9745b2c27",
      "timeStamp": "0x60f9ce56",
      "gasPrice": "0x2e90edd000",
      "gasUsed": "0x247205",
      "logIndex": "0x",
      "transactionHash": "0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",
      "transactionIndex": "0x"
    }
  ]
}

Authorizations

apikey

string

query

required

Enter your Etherscan API key, or set one up if you don't have one.

Query Parameters

chainid

string

required

Chain ID to query, eg 1 for Ethereum, 42161 for Arbitrum from our supported chains.

module

string

default:logs

required

Set to logs for this endpoint.

action

string

default:getLogs

required

Set to getLogs for this endpoint.

fromBlock

integer

required

Starting block number to search from.

toBlock

integer

required

Ending block number to search to.

topic0

string

The first topic to filter by. Provide at least one of topic0, topic1, topic2, or topic3.

topic0_1_opr

string

Topic operator between topic0 and topic1, either and or or.

topic1

string

Second topic to filter by.

topic1_2_opr

string

Topic operator between topic1 and topic2, either and or or.

topic2

string

Third topic to filter by.

topic2_3_opr

string

Topic operator between topic2 and topic3, either and or or.

topic3

string

Fourth topic to filter by.

topic0_2_opr

string

Topic operator between topic0 and topic2, either and or or.

topic0_3_opr

string

Topic operator between topic0 and topic3, either and or or.

topic1_3_opr

string

Topic operator between topic1 and topic3, either and or or.

page

integer

Page number for pagination.

offset

integer

Number of records per page. Use the page parameter for subsequent records.

Response

200 - application/json

Successful response

status

string

1 if the request returned data, 0 otherwise. A status of 0 can indicate an error or a valid request that returned no records.

message

string

OK on success, otherwise an error description such as NOTOK. See common error messages.

result

object[]

Show child attributes

API Endpoints

Beta Endpoints

Get Event Logs by Topics

Authorizations

Query Parameters

Response