---
title: "GET /v1/{chainName}/events/address/{contractAddress}/"
method: GET
path: "/v1/{chainName}/events/address/{contractAddress}/"
tags: ["get-log-events-by-contract-address"]
---

# GET /v1/{chainName}/events/address/{contractAddress}/

`GET /v1/{chainName}/events/address/{contractAddress}/`

## Request

- Base URL: `https://api.covalenthq.com`
- URL: `https://api.covalenthq.com/v1/{chainName}/events/address/{contractAddress}/`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/docs/v1/:chainName/events/address/:contractAddress/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns all the event logs emitted from a particular contract address. Useful for building dashboards that examine on-chain interactions.

## Path parameters

- `chainName` string, required
- `contractAddress` string, required

## Query parameters

- `starting-block` integer
- `ending-block` string
- `page-size` integer
- `page-number` integer

## Response `200`

Successful response

- object
  - `updated_at` string, date-time: The timestamp when the response was generated. Useful to show data staleness to users.
  - `chain_id` integer: The requested chain ID eg: `1`.
  - `chain_name` string: The requested chain name eg: `eth-mainnet`.
  - `items` object[]: List of response items.
    - `block_signed_at` string, date-time: The block signed timestamp in UTC.
    - `block_height` integer: The height of the block.
    - `tx_offset` integer: The offset is the position of the tx in the block.
    - `log_offset` integer: The offset is the position of the log entry within an event log.
    - `tx_hash` string: The requested transaction hash.
    - `raw_log_topics` string[]: The log topics in raw data.
    - `sender_contract_decimals` integer: Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`.
    - `sender_name` string: The name of the sender.
    - `sender_contract_ticker_symbol` string
    - `sender_address` string: The address of the sender.
    - `sender_logo_url` string: The contract logo URL.
    - `supports_erc` string[]: A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`.
    - `sender_factory_address` string: The address of the deployed UniswapV2 like factory contract for this DEX.
    - `raw_log_data` string: The log events in raw.
    - `decoded` object: The decoded item.
      - `name` string
      - `signature` string
      - `params` object[]
        - `name` string
        - `type` string
        - `indexed` boolean
        - `decoded` boolean
        - `value` string
  - `pagination` object: Pagination metadata.
    - `has_more` boolean: True if there is another page.
    - `page_number` integer: The requested page number.
    - `page_size` integer: The requested number of items on the current page.
    - `total_count` integer: The total number of items across all pages for this request.

---

[API](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis.md) - [All operations](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/revisions/31713d2c30bc?raw)