GET
/
insights
/
v1
/
events
/
{contractAddress}
Get contract events
curl --request GET \
  --url https://data-api.b3.fun/insights/v1/events/{contractAddress}
{
  "data": [
    {
      "chain_id": "<string>",
      "block_number": 123,
      "block_hash": "<string>",
      "block_timestamp": 123,
      "transaction_hash": "<string>",
      "transaction_index": 123,
      "log_index": 123,
      "address": "<string>",
      "data": "<string>",
      "topics": [
        "<string>"
      ],
      "decoded": {
        "name": "<string>",
        "signature": "<string>",
        "indexed_params": {},
        "non_indexed_params": {}
      }
    }
  ],
  "aggregations": "<any>",
  "meta": {
    "chain_ids": [
      123
    ],
    "address": "<string>",
    "signature": "<string>",
    "page": 123,
    "limit_per_chain": 123,
    "total_items": 123,
    "total_pages": 123
  }
}

Path Parameters

​
contract_address
string
required
Example:

"vitalik.eth"

Query Parameters

​
chain
number[]
deprecated

Use chain_id instead

Example:
[20, 56, 1]
​
chain_id
number[]

The chain ID(s) to request the data for. You can specify multiple chain IDs, up to a maximum of 55. Use repeated query parameters, e.g., ?chain_id=20&chain_id=56. Optional, because a single chain can as well be specified as a subdomain

Example:
[20, 56, 1]
​
filter_block_number
number | null

Filter by block number

Example:

1000000

​
filter_block_number_gte
number | null

Filter by block number greater than or equal to

Example:

1000000

​
filter_block_number_gt
number | null

Filter by block number greater than

Example:

1000000

​
filter_block_number_lte
number | null

Filter by block number less than or equal to

Example:

1000000

​
filter_block_number_lt
number | null

Filter by block number less than

Example:

1000000

​
filter_block_hash
string

Filter by block hash

Example:

"0x3a1fba5abd9d41457944e91ed097e039b7b12d3d7ba324a3f422db2277a48e28"

​
filter_block_timestamp
number | null

Filter by block timestamp

Example:

1715222400

​
filter_block_timestamp_gte
number | null

Filter by block timestamp greater than or equal to

Example:

1715222400

​
filter_block_timestamp_gt
number | null

Filter by block timestamp greater than

Example:

1715222400

​
filter_block_timestamp_lte
number | null

Filter by block timestamp less than or equal to

Example:

1715222400

​
filter_block_timestamp_lt
number | null

Filter by block timestamp less than

Example:

1715222400

​
sort_by

Field to sort results by

Available options:
block_number
Example:

"block_number"

​
sort_order
enum<string>

Sort order (asc or desc)

Available options:
asc,
desc
Example:

"desc"

​
group_by
string | null

Field(s) to group by. You can specify multiple with repeated query parameters, e.g., ?group_by=chain_id&group_by=block_number

​
aggregate
string | null

Aggregation(s). You can specify multiple with repeated query parameters, e.g., ?aggregate=count()&aggregate=sum(gas_used)

Example:

"count() as count"

​
filter_transaction_index
number | null

Filter by transaction index

Example:

5

​
filter_transaction_index_gte
number | null

Filter by transaction index greater than or equal to

Example:

5

​
filter_transaction_index_gt
number | null

Filter by transaction index greater than

Example:

5

​
filter_transaction_index_lte
number | null

Filter by transaction index less than or equal to

Example:

5

​
filter_transaction_index_lt
number | null

Filter by transaction index less than

Example:

5

​
decode
boolean | null

Enable ABI decoding of the transactions/events data

Example:

true

​
filter_transaction_hash
string

Filter by transaction hash

Example:

"0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e"

​
filter_log_index
number | null

Filter by log index

Example:

5

​
filter_log_index_gte
number | null

Filter by log index greater than or equal to

Example:

5

​
filter_log_index_gt
number | null

Filter by log index greater than

Example:

5

​
filter_log_index_lte
number | null

Filter by log index less than or equal to

Example:

5

​
filter_log_index_lt
number | null

Filter by log index less than

Example:

5

​
filter_topic_1
string

Filter by topic 1

Example:

"0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc"

​
filter_topic_2
string

Filter by topic 2

Example:

"0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc"

​
filter_topic_3
string

Filter by topic 3

Example:

"0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc"

​
filter_topic_0
string

Filter by topic 0

Example:

"0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc"

​
limit
integer
default:20

The number of items to return

Required range: 0 < x <= 1000
Example:

20

​
page
integer | null
default:0

Page number (0-indexed). Maximum value depends on query parameters: 20 for regular queries, 500 when using aggregate or group_by parameters.

Required range: x >= 0
Example:

0

Response

200
application/json

Successful response

The response is of type object.