---
title: "Get raw event logs via Etherscan v2"
method: GET
path: "/v1/eth/logs/{network}"
tags: ["Etherscan Proxy"]
---

# Get raw event logs via Etherscan v2

`GET /v1/eth/logs/{network}`

Proxies Etherscan v2 logs/getLogs server-side so the Launchpad ships no Etherscan API key in its bundle. module/action are pinned server-side and chainid is derived from :network. Logs are returned raw/undecoded. Upstream status '0' (no records) is echoed as HTTP 200 with empty logs — the frontend treats it as "fall back to RPC".

## Path parameters

- `network` string, required

## Query parameters

- `address` string, required
- `topic0` string
- `topic1` string
- `fromBlock` string
- `toBlock` string

## Response `200`

Raw undecoded logs with upstream status echoed

- EtherscanLogsResponse
  - `status` '1' | '0', required — Upstream Etherscan status echoed through: '1' = records found, '0' = no records (the frontend treats '0' as 'fall back to RPC', never an error)
  - `logs` EtherscanLogDto[], required — Raw undecoded log entries
    - `address` string, required — Emitting contract address
    - `topics` string[], required — Log topics (raw, undecoded)
    - `data` string, required — Log data (raw, undecoded)
    - `blockNumber` string, required — Block number (hex, as returned upstream)
    - `transactionHash` string, required — Transaction hash
    - `logIndex` string, required — Log index (hex, as returned upstream)
  - `truncated` boolean — Present and true when the upstream pagination cap was reached and older records may be missing; callers should not treat the log set as exhaustive.

## Other responses

- `400` — Unsupported network or malformed address/topics/blocks
- `429` — Rate limited (either this API or the upstream)
- `500` — An unknown error occurred
- `502` — Upstream Etherscan request failed

---

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