---
title: "Get Contract Events"
method: GET
path: "/v1/contracts/{chainId}/{address}/events"
tags: ["Gateway"]
---

# Get Contract Events

`GET /v1/contracts/{chainId}/{address}/events`

Retrieves events emitted by a specific smart contract address on a specific blockchain network. This endpoint provides comprehensive event data including block information, transaction details, event topics, and optional ABI decoding. Results can be filtered, paginated, and sorted to meet specific requirements.

**Authentication**: Pass `x-client-id` header for frontend usage from allowlisted origins or `x-secret-key` for backend usage.

## Path parameters

- `chainId` integer, required — The blockchain network identifier where the contract is deployed.
- `address` string, required — The smart contract address or ENS name.

## Query parameters

- `signature` string — Filter by event signature hash, e.g., '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef' for Transfer event
- `filterTopic0` string — Filter by event topic 0 (event signature hash)
- `filterTopic1` string — Filter by event topic 1
- `filterTopic2` string — Filter by event topic 2
- `filterTopic3` string — Filter by event topic 3
- `filterBlockTimestampGte` integer, nullable — Filter by block timestamp (Unix timestamp) greater than or equal to this value
- `filterBlockTimestampLte` integer, nullable — Filter by block timestamp (Unix timestamp) less than or equal to this value
- `filterBlockNumberGte` integer, nullable — Filter by block number greater than or equal to this value
- `filterBlockNumberLte` integer, nullable — Filter by block number less than or equal to this value
- `page` number, nullable — Current page number
- `limit` number, nullable — Number of items per page
- `sortOrder` 'asc' | 'desc' — Sort order: 'asc' for ascending, 'desc' for descending

## Response `200`

Contract events retrieved successfully. Returns event data with metadata including pagination information. Includes decoded event parameters when ABI is available.

- object
  - `result` object, required
    - `events` object[], required — Array of contract events.
      - `address` string, required — The contract address that emitted the event.
      - `blockHash` string, required — The hash of the block containing this event.
      - `blockNumber` number, required — The block number where the event was emitted.
      - `blockTimestamp` number, required — The timestamp of the block (Unix timestamp).
      - `chainId` string, required — The chain ID where the event occurred.
      - `data` string, required — The non-indexed event data as a hex string.
      - `decoded` object — Decoded event data (included when ABI is available).
        - `name` string, required — The event name.
        - `params` object, required — Object containing decoded parameters.
        - `signature` string, required — The event signature.
      - `logIndex` number, required — The index of the log within the transaction.
      - `topics` string[], required — Array of indexed event topics (including event signature).
      - `transactionHash` string, required — The hash of the transaction containing this event.
      - `transactionIndex` number, required — The index of the transaction within the block.
    - `pagination` object, required
      - `hasMore` boolean — Whether there are more items available
      - `limit` number, nullable — Number of items per page
      - `page` number, nullable — Current page number
      - `totalCount` number, nullable — Total number of items available

## Other responses

- `400` — Invalid request parameters. This occurs when the contract address or chainId format is invalid, or pagination parameters are out of range.
- `401` — Authentication required. The request must include a valid `x-client-id` header for frontend usage or `x-secret-key` for backend usage.
- `404` — Contract not found or no events available for the specified contract address on the given blockchain network.
- `500` — Internal server error. This may occur due to network connectivity issues, external service unavailability, or unexpected server errors.

---

[API](https://skmtc.net/thirdweb/apis/thirdweb-api.md) · [All operations](https://skmtc.net/thirdweb/apis/thirdweb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thirdweb/thirdweb-api/revisions/fb4cb67da1c7/schema)