GuideReference
1.0.0
OAS 3.0.0

Insight service

Client Libraries
cURL Shell

events​

events Endpoints

Get events​

Get events

Query Parameters
  • filter_block_number
    number | nullable

    Filter by block number

    Example1000000
  • filter_block_number_gte
    number | nullable

    Filter by block number greater than or equal to

    Example1000000
  • filter_block_number_gt
    number | nullable

    Filter by block number greater than

    Example1000000
  • filter_block_number_lte
    number | nullable

    Filter by block number less than or equal to

    Example1000000
  • filter_block_number_lt
    number | nullable

    Filter by block number less than

    Example1000000
  • filter_block_hash
    string

    Filter by block hash

    Example0x3a1fba5abd9d41457944e91ed097e039b7b12d3d7ba324a3f422db2277a48e28
  • filter_block_timestamp
    number | nullable

    Filter by block timestamp

    Example1715222400
  • filter_block_timestamp_gte
    number | nullable

    Filter by block timestamp greater than or equal to

    Example1715222400
  • filter_block_timestamp_gt
    number | nullable

    Filter by block timestamp greater than

    Example1715222400
  • filter_block_timestamp_lte
    number | nullable

    Filter by block timestamp less than or equal to

    Example1715222400
  • filter_block_timestamp_lt
    number | nullable

    Filter by block timestamp less than

    Example1715222400
  • filter_transaction_index
    number | nullable

    Filter by transaction index

    Example5
  • filter_transaction_index_gte
    number | nullable

    Filter by transaction index greater than or equal to

    Example5
  • filter_transaction_index_gt
    number | nullable

    Filter by transaction index greater than

    Example5
  • filter_transaction_index_lte
    number | nullable

    Filter by transaction index less than or equal to

    Example5
  • filter_transaction_index_lt
    number | nullable

    Filter by transaction index less than

    Example5
  • sort_by
    string enum

    Field to sort results by

    Exampleblock_number
    • block_number
    • block_timestamp
    • transaction_index
  • sort_order
    string enum

    Sort order (asc or desc)

    Exampledesc
    • asc
    • desc
  • group_by
    string
  • aggregate
    array string[]
  • filter_transaction_hash
    string

    Filter by transaction hash

    Example0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e
  • filter_log_index
    number | nullable

    Filter by log index

    Example5
  • filter_log_index_gte
    number | nullable

    Filter by log index greater than or equal to

    Example5
  • filter_log_index_gt
    number | nullable

    Filter by log index greater than

    Example5
  • filter_log_index_lte
    number | nullable

    Filter by log index less than or equal to

    Example5
  • filter_log_index_lt
    number | nullable

    Filter by log index less than

    Example5
  • filter_topic_1
    string

    Filter by topic 1

    Example0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc
  • filter_topic_2
    string

    Filter by topic 2

    Example0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc
  • filter_topic_3
    string

    Filter by topic 3

    Example0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc
  • filter_topic_0
    string

    Filter by topic 0

    Example0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc
  • filter_address
    string

    Filter by address

    Example0x5564886ca2c518d1964e5fcea4f423b41db9f561
  • limit
    integer
    greater than: 
    0
    default: 
    20

    The number of items to return

    Example20
  • page
    integer | nullable
    min: 
    0
    default: 
    0

    Integer numbers.

Responses
GET/v1/events
curl https://1.insight.thirdweb.com/v1/events

{
  "data": [
    {
      "chain_id": 1,
      "block_number": "…",
      "block_hash": "…",
      "block_timestamp": "…",
      "transaction_hash": "…",
      "transaction_index": 1,
      "log_index": 1,
      "address": "…",
      "data": "…",
      "topics": [
        "…"
      ]
    }
  ],
  "meta": {
    "chain_id": 1,
    "address": "…",
    "signature": "…",
    "page": 1,
    "limit": 1,
    "total_items": 1,
    "total_pages": 1
  }
}

Successful response