Ethereum Mainnet

Network Information

Network ID: ethereum-mainnet
Chain ID: 1
Portal Status: ✓ Available
Real-time Streaming: ⚡ Yes
State Diffs: ✓ Available
Traces: ✓ Available

Endpoints

V2 archives will be sunset soon. Migrate to Portal →

Portal (Recommended)
V2 Archive (Legacy)

Portal Endpoint

https://portal.sqd.dev/datasets/ethereum-mainnet

Usage

curl --compress -X POST 'https://portal.sqd.dev/datasets/ethereum-mainnet/stream' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "evm",
    "fromBlock": 20000000,
    "toBlock": 20001000,
    "fields": {
      "block": { "number": true, "hash": true },
      "log": { "address": true, "topics": true, "data": true }
    },
    "logs": [{
      "address": ["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"]
    }]
  }'

V2 Archive Endpoint

https://v2.archive.subsquid.io/network/ethereum-mainnet

Legacy: Rate limited at 50 req/10s per IP. Will be sunset soon.

Usage

import { EvmBatchProcessor } from "@subsquid/evm-processor";

const processor = new EvmBatchProcessor()
  .setGateway("https://v2.archive.subsquid.io/network/ethereum-mainnet")
  .setRpcEndpoint("<your_rpc_endpoint>")
  .setFinalityConfirmation(75)
  .setBlockRange({ from: 0 });

Quick Start

Get started indexing Ethereum data in minutes:

Pipes SDK Quickstart

Build a high-performance indexer with the Pipes SDK

Squid SDK Quickstart

Create a full-stack indexer with GraphQL API

Schema Reference

View Schema

See complete field definitions for blocks, transactions, logs, traces, and state diffs

EVM API Reference

Complete API documentation

Migration Guide

Migrate from v2 archives to Portal

Portal Overview

Learn about Portal infrastructure

Overview

Portal API Reference

Local Setup

Supported Networks

Network Information

Endpoints

Portal Endpoint

Usage

V2 Archive Endpoint

Usage

Quick Start

Pipes SDK Quickstart

Squid SDK Quickstart

Schema Reference

View Schema

EVM API Reference

Migration Guide

Portal Overview

Overview

Portal API Reference

Local Setup

Supported Networks

​Network Information

​Endpoints

​Portal Endpoint

​Usage

​V2 Archive Endpoint

​Usage

​Quick Start

Pipes SDK Quickstart

Squid SDK Quickstart

​Schema Reference

View Schema

​Related Resources

EVM API Reference

Migration Guide

Portal Overview

Network Information

Endpoints

Portal Endpoint

Usage

V2 Archive Endpoint

Usage

Quick Start

Schema Reference

Related Resources