eth_getLogs

Get Logs

POSThttps://site1.moralis-nodes.com/:chain/:apiKey

Returns an array of logs matching a specified filter condition. This can include logs for specific addresses, block number ranges, or topics. Logs are used by smart contracts to record events and can be queried to retrieve historical state or transaction outcomes.

Note

Please refer to RPC schema page for more details on the RPC params and RPC response definitions of the RPC method.

PATH PARAMS

chainstringrequired

The blockchain to interact with.

ethsepoliaholeskybasebase-sepoliapolygonamoybscbsc-testnetarbitrumarbitrum-sepoliaoptimismoptimism-sepoliagnosisgnosis-testnetlinealinea-sepoliaavalanchemoonbeammoonrivermoonbaseblastblast-sepoliamantlemantle-sepoliapolygon-zkevmpolygon-zkevm-cardonazksynczksync-sepoliazetachainzetachain-testnetfantomopbnb

apiKeystringrequired

Your API key for authentication.

BODY PARAM

jsonrpcstringrequired

JSON-RPC version (typically 2.0).

idnumberrequired

The request identifier.

methodstringrequired

The JSON-RPC method being invoked.

paramsrpcArrayrequired

A single object representing the filter options for the logs. This can include fromBlock, toBlock, address, and topics.

[ { "fromBlock": "0x12b39a9", "toBlock": "latest", "address": "0x8888f1f195afa192cfee860698584c030f4c9db1", "topics": [ "0x0000000000000000000000000000000000000000000000000000000000000000" ] } ]

Responses

Node.js

// Dependencies to install:
// $ npm install node-fetch --save
// add "type": "module" to package.json

import fetch from 'node-fetch';

const options = {
  method: 'POST',
  headers: {
    accept: 'application/json',
    'content-type': 'application/json'
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_getLogs"
  })
};

fetch('https://site1.moralis-nodes.com/eth/YOUR_API_KEY', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Python

# Dependencies to install:

# $ python -m pip install requests

import requests

url = "https://site1.moralis-nodes.com/eth/YOUR_API_KEY"

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_getLogs"
}
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

cURL

curl --request POST \
     --url 'https://site1.moralis-nodes.com/eth/YOUR_API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_getLogs"
}
'

Go

package main

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

func main() {

  url := "https://site1.moralis-nodes.com/eth/YOUR_API_KEY"

  payload := strings.NewReader("{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\"}")

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

  req.Header.Add("Accept", "application/json")
  req.Header.Add("Content-Type", "application/json")

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

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

  fmt.Println(res)
  fmt.Println(string(body))

}

PHP

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://site1.moralis-nodes.com/eth/YOUR_API_KEY', [
  'body' => '{"jsonrpc":"2.0","id":1,"method":"eth_getLogs"}',
  'headers' => [
    'Accept' => 'application/json',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();

Response Example

200 Returns logs matching the filter condition.

[
  {
    "address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
    "topics": [
      "0x0000000000000000000000000000000000000000000000000000000000000000"
    ],
    "data": "0x...",
    "blockNumber": "0x1a4",
    "transactionHash": "0x...",
    "transactionIndex": "0x3",
    "blockHash": "0x...",
    "logIndex": "0x1",
    "removed": ""
  }
]