eth_getLogs

Overview

The "eth_getLogs" method returns an array of all the logs matching the given filter object.

Request

shell

curl --request POST \
     --url https://ethereum-mainnet-geth-archive.node.coinapi.io \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \     
     --header 'X-CoinAPI-Key: 73034021-THIS-IS-SAMPLE-KEY' \
     --data '
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "address": [
        "0xb59f67a8bff5d8cd03f6ac17265c550ed8f33907"
      ],
      "fromBlock": "0x429d3b",
      "toBlock": "latest",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x00000000000000000000000000b46c2526e227482e2ebb8f4c69e4674d262e75",
        "0x00000000000000000000000054a2d42a40f51259dedd1978f6c118a0f0eff078"
      ]
    }
  ]
}'

csharp

using RestSharp; {

var options = new RestClientOptions("https://ethereum-mainnet-geth-archive.node.coinapi.io");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json","X-CoinAPI-Key: 73034021-THIS-IS-SAMPLE-KEY");
request.AddJsonBody("{\"id\":1,\"jsonrpc\":\"2.0\",\"method\":\"eth_getLogs\",\"params\":[{\"address\":[\"0xb59f67a8bff5d8cd03f6ac17265c550ed8f33907\"],\"fromBlock\":\"0x429d3b\",\"toBlock\":\"latest\",\"topics\":[\"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\",\"0x00000000000000000000000000b46c2526e227482e2ebb8f4c69e4674d262e75\",\"0x00000000000000000000000054a2d42a40f51259dedd1978f6c118a0f0eff078\"]}]}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content); }

php

<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://ethereum-mainnet-geth-archive.node.coinapi.io",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'id' => 1,
'jsonrpc' => '2.0',
'method' => 'eth_getLogs',
'params' => [
[
'address' => [
'0xb59f67a8bff5d8cd03f6ac17265c550ed8f33907'
],
'fromBlock' => '0x429d3b',
'toBlock' => 'latest',
'topics' => [
'0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
'0x00000000000000000000000000b46c2526e227482e2ebb8f4c69e4674d262e75',
'0x00000000000000000000000054a2d42a40f51259dedd1978f6c118a0f0eff078'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"accept: application/json",
"content-type: application/json",
"X-CoinAPI-Key": "73034021-THIS-IS-SAMPLE-KEY"
],
]);

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

curl_close($curl);

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

python

import requests

url = "https://ethereum-mainnet-geth-archive.node.coinapi.io"

payload = {
    "id": 1,
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [
        {
            "address": ["0xb59f67a8bff5d8cd03f6ac17265c550ed8f33907"],
            "fromBlock": "0x429d3b",
            "toBlock": "latest",
            "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x00000000000000000000000000b46c2526e227482e2ebb8f4c69e4674d262e75", "0x00000000000000000000000054a2d42a40f51259dedd1978f6c118a0f0eff078"]
        }
    ]
}
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "X-CoinAPI-Key" : "73034021-THIS-IS-SAMPLE-KEY"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

javascript

    const options = {
  method: 'POST',
  headers: {accept: 'application/json', 'content-type': 'application/json', 'X-CoinAPI-Key': '73034021-THIS-IS-SAMPLE-KEY'},
  body: JSON.stringify({
    id: 1,
    jsonrpc: '2.0',
    method: 'eth_getLogs',
    params: [
      {
        address: ['0xb59f67a8bff5d8cd03f6ac17265c550ed8f33907'],
        fromBlock: '0x429d3b',
        toBlock: 'latest',
        topics: [
          '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
          '0x00000000000000000000000000b46c2526e227482e2ebb8f4c69e4674d262e75',
          '0x00000000000000000000000054a2d42a40f51259dedd1978f6c118a0f0eff078'
        ]
      }
    ]
  })
};

fetch('https://ethereum-mainnet-geth-archive.node.coinapi.io', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

go

package main

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

func main() {

	url := "https://ethereum-mainnet-geth-archive.node.coinapi.io"

	payload := strings.NewReader("{\"id\":1,\"jsonrpc\":\"2.0\",\"method\":\"eth_getLogs\",\"params\":[{\"address\":[\"0xb59f67a8bff5d8cd03f6ac17265c550ed8f33907\"],\"fromBlock\":\"0x429d3b\",\"toBlock\":\"latest\",\"topics\":[\"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\",\"0x00000000000000000000000000b46c2526e227482e2ebb8f4c69e4674d262e75\",\"0x00000000000000000000000054a2d42a40f51259dedd1978f6c118a0f0eff078\"]}]}")

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

	req.Header.Add("accept", "application/json")
	req.Header.Add("content-type", "application/json")
  req.Header.Add("X-CoinAPI-Key", "73034021-THIS-IS-SAMPLE-KEY")

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

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

	fmt.Println(string(body))

}

ruby

require 'uri'
require 'net/http'

url = URI("https://ethereum-mainnet-geth-archive.node.coinapi.io")

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

request = Net::HTTP::Post.new(url)
request["accept"] = 'application/json'
request["content-type"] = 'application/json'
request["X-CoinAPI-Key"] = '73034021-THIS-IS-SAMPLE-KEY'
request.body = "{\"id\":1,\"jsonrpc\":\"2.0\",\"method\":\"eth_getLogs\",\"params\":[{\"address\":[\"0xb59f67a8bff5d8cd03f6ac17265c550ed8f33907\"],\"fromBlock\":\"0x429d3b\",\"toBlock\":\"latest\",\"topics\":[\"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\",\"0x00000000000000000000000000b46c2526e227482e2ebb8f4c69e4674d262e75\",\"0x00000000000000000000000054a2d42a40f51259dedd1978f6c118a0f0eff078\"]}]}"

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

java

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"id\":1,\"jsonrpc\":\"2.0\",\"method\":\"eth_getLogs\",\"params\":[{\"address\":[\"0xb59f67a8bff5d8cd03f6ac17265c550ed8f33907\"],\"fromBlock\":\"0x429d3b\",\"toBlock\":\"latest\",\"topics\":[\"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef\",\"0x00000000000000000000000000b46c2526e227482e2ebb8f4c69e4674d262e75\",\"0x00000000000000000000000054a2d42a40f51259dedd1978f6c118a0f0eff078\"]}]}");
Request request = new Request.Builder()
  .url("https://ethereum-mainnet-geth-archive.node.coinapi.io")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("content-type", "application/json")
  .addHeader("X-CoinAPI-Key", "73034021-THIS-IS-SAMPLE-KEY")
  .build();

Response response = client.newCall(request).execute();

Request Parameters

A filter object containing the following:

• address: (Optional) Contract address (20 bytes) or a list of addresses from which logs should originate.
• fromBlock: (Optional, default is "'latest'") A hexadecimal block number, or the string 'latest', 'earliest' or 'pending'.
• toBlock: (Optional, default is "'latest'") A hexadecimal block number, or the string 'latest', 'earliest' or 'pending'.
• topics: (Optional) Array of 32 bytes DATA topics. Topics are order-dependent.
• blockhash: (Optional) Restricts the logs returned to the single block referenced in the 32-byte hash blockHash. Using blockHash is equivalent to setting fromBlock and toBlock to the block number referenced in the blockHash. If blockHash is present in the filter criteria, then neither fromBlock nor toBlock are allowed.

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0xb59f67a8bff5d8cd03f6ac17265c550ed8f33907",
      "blockHash": "0x8243343df08b9751f5ca0c5f8c9c0460d8a9b6351066fae0acbd4d3e776de8bb",
      "blockNumber": "0x429d3b",
      "data": "0x000000000000000000000000000000000000000000000000000000012a05f200",
      "logIndex": "0x56",
      "removed": false,
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x00000000000000000000000000b46c2526e227482e2ebb8f4c69e4674d262e75",
        "0x00000000000000000000000054a2d42a40f51259dedd1978f6c118a0f0eff078"
      ],
      "transactionHash": "0xab059a62e22e230fe0f56d8555340a29b2e9532360368f810595453f6fdd213b",
      "transactionIndex": "0xac"
    }
  ]
}

An array of log objects, or an empty array if nothing has changed since the last poll. Log objects contain the following keys and their values:

• removed: (Boolean) true when the log was removed, due to a chain reorganization. false if it's a valid log.
• logIndex: Hexadecimal of the log index position in the block. 'Null' when it is a pending log.
• transactionIndex: Hexadecimal of the transactions index position from which the log was created. 'Null' when it is a pending log.
• transactionHash: 32 bytes. Hash of the transactions from which this log was created. 'Null' when it is a pending log.
• blockHash: 32 bytes. Hash of the block where this log was in. 'Null' when it is a pending log.
• blockNumber: Block number where this log was in. 'Null' when it is a pending log.
• address: 20 bytes. Address from which this log originated.
• data: Contains one or more 32-bytes non-indexed arguments of the log.
• topics: An array of 0 to 4 indexed log arguments, each 32 bytes.

Constraints

To ensure efficient use of resources, 'eth_getLogs' requests are subject to the following constraints:

• A maximum of 5,000 parameters in a single request.
• A maximum of 10,000 results can be returned by a single query.
• Query duration must not exceed 10 seconds.

If a query returns too many results or exceeds the max query duration, one of the following errors is returned:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32005,
    "message": "query returned more than 10000 results"
  }
}

or

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32005,
    "message": "query timeout exceeded"
  }
}

If this happens:

• Limit your query to a smaller number of blocks using fromBlock and toBlock.
• If querying for commonly used topics, consider limiting to a single smart contract address.

Was this section helpful?

• 1
• 2
• 3
• 4
• 5