---
title: "GET /v1/{chainName}/events/"
method: GET
path: "/v1/{chainName}/events/"
tags: ["get-logs"]
---

# GET /v1/{chainName}/events/

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

Commonly used to get all the event logs of the latest block, or for a range of blocks. Includes sender contract metadata as well as decoded logs.

## Path parameters

- `chainName` string, required

## Query parameters

- `starting-block` integer
- `ending-block` string
- `address` string
- `topics` string
- `block-hash` string
- `skip-decode` boolean

## 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`.
  - `chain_tip_height` integer — The latest block height of the blockchain at the time this response was provided.
  - `chain_tip_signed_at` string, date-time — The timestamp of the latest signed block at the time this response was provided.
  - `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.
    - `block_hash` string — The hash 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 — The ticker symbol for the sender. This field is set by a developer and non-unique across a network.
    - `sender_address` string — The address of the sender.
    - `supports_erc` string[] — A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`.
    - `sender_logo_url` string — The contract logo URL.
    - `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

---

[API](https://skmtc.net/covalenthq/apis/goldrush-multichain-data-apis.md) · [All operations](https://skmtc.net/covalenthq/apis/goldrush-multichain-data-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/covalenthq/goldrush-multichain-data-apis/revisions/c099830c76a0/schema)