---
title: "Get events by contract address"
method: GET
path: "/v1/contracts/{address}/events"
---

# Get events by contract address

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

## Request

- Base URL: `https://api.shasta.trongrid.io`
- URL: `https://api.shasta.trongrid.io/v1/contracts/{address}/events`
- Auth: none declared
- TypeScript: <https://skmtc.dev/trongrid/apis/trongrid-v1-api/docs/v1/contracts/:address/events/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `address` string, required

## Query parameters

- `event_name` string
- `block_number` string
- `only_unconfirmed` boolean
- `only_confirmed` boolean
- `min_timestamp` integer
- `max_timestamp` integer
- `order_by` string
- `fingerprint` string
- `limit` integer

## Response `200`

200

- object
  - `data` object[]
    - `block_number` integer: The block number
    - `block_timestamp` integer: The block timestamp. (Unit: millisecond)
    - `caller_contract_address` string: Same as data.[0].contract_address for backward compatibility.
    - `contract_address` string: The address of the contract that emitted the event.
    - `event_index` integer: The event's index within the transaction's event log.
    - `event_name` string: The event name
    - `event` string: The event signature used to parse indexed and non-indexed parameters. (e.g., `Transfer(address,address,uint256)`)
    - `transaction_id` string: Transaction hash.
    - `result` object: The event's parameters, including both indexed and non-indexed parameters.
    - `result_type` object: The type of parameter
    - `_unconfirmed` boolean: Whether the transaction is unconfirmed. `true` means unconfirmed.
  - `success` boolean: Whether the request was successful.
  - `meta` object
    - `page_size` integer: The number of items returned on the current page.
    - `at` integer: The response timestamp. (Unit: millisecond)
    - `fingerprint` string: Pagination cursor (present when a full page is returned).
    - `links` object
      - `next` string: URL for the next page (conditional).

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/trongrid/apis/trongrid-v1-api.md) - [All operations](https://skmtc.dev/trongrid/apis/trongrid-v1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trongrid/apis/trongrid-v1-api/revisions/22cc4dd60c4c?raw)