Ethereum

Property	Value
Network ID	`ethereum-mainnet`
Chain ID	`1`
Real-time	Yes
Traces	✓
State Diffs	✓
Pricing tier	Core

Property

Value

Network ID

ethereum-mainnet

Chain ID

1

Real-time

Yes

Traces

✓

State Diffs

✓

Pricing tier

Core

Endpoint

Portal (recommended)
v2 archives (legacy)

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

API key required from May 19, 2026 12:00 UTC. v2 archives will be sunset soon. Migrate to Portal, or attach an API key to keep using v2: see Accessing SQD data with API keys. Cloud squids are not affected.

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

Quick start

curl --compressed -X POST \
  'https://portal.sqd.dev/datasets/ethereum-mainnet/stream' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "evm",
    "fromBlock": 0,
    "toBlock": 100,
    "fields": {
      "block": { "number": true, "timestamp": true },
      "transaction": { "hash": true, "from": true, "to": true, "value": true }
    },
    "transactions": [{}]
  }'

For full SDK examples:

Pipes SDK Quickstart

Streaming pipeline indexer

Squid SDK Quickstart

GraphQL API indexer

Schema

Blocks

Field	Type	Description
`number`	integer	Block number
`hash`	string	Block hash
`timestamp`	integer	Block timestamp (Unix)
`parentHash`	string	Parent block hash
`gasUsed`	bigint	Total gas used in block
`gasLimit`	bigint	Block gas limit
`baseFeePerGas`	bigint	Base fee per gas (EIP-1559)
`stateRoot`	string	State root hash
`transactionsRoot`	string	Transactions trie root
`receiptsRoot`	string	Receipts trie root

Transactions

Field	Type	Description
`hash`	string	Transaction hash
`from`	address	Sender address
`to`	address	Recipient address (null for contract creation)
`value`	bigint	Transaction value in wei
`gasUsed`	bigint	Gas used by transaction
`gasPrice`	bigint	Gas price in wei
`maxFeePerGas`	bigint	Max fee per gas (EIP-1559)
`maxPriorityFeePerGas`	bigint	Max priority fee (EIP-1559)
`input`	bytes	Transaction input data
`nonce`	integer	Transaction nonce
`status`	integer	1 = success, 0 = failure

Logs

Field	Type	Description
`address`	address	Contract address that emitted the log
`topics`	array	Indexed event topics (up to 4)
`data`	bytes	Non-indexed event data
`logIndex`	integer	Log index in the block
`transactionIndex`	integer	Index of parent transaction
`transactionHash`	string	Hash of parent transaction

Traces

Selectors are prefixed by trace kind (call*, create*, suicide*, reward*); there are no bare from/to/value fields. See the API reference for the full list.

Field	Type	Description
`transactionIndex`	integer	Index of parent transaction
`type`	string	call, create, suicide, reward
`callFrom`	address	Caller address (call traces)
`callTo`	address	Callee address (call traces)
`callValue`	bigint	Value transferred (call traces)
`callGas`	bigint	Gas provided (call traces)
`callResultGasUsed`	bigint	Gas actually used (call traces)
`callInput`	bytes	Call input data
`callResultOutput`	bytes	Call output data
`error`	string	Error message if the trace failed

State Diffs

Field	Type	Description
`transactionIndex`	integer	Index of parent transaction
`address`	address	Account whose state changed
`key`	string	Storage slot key (or `balance`, `nonce`, `code`)
`kind`	string	balance, code, nonce, storage
`prev`	bytes	Previous value
`next`	bytes	New value

Reference

API Reference

Field definitions and query syntax

Portal Migration

Migrate from v2 archives to Portal

Overview

Portal API reference

Working with Portal API

Local Setup

Supported Networks

Endpoint

Quick start

Pipes SDK Quickstart

Squid SDK Quickstart

Schema

Reference

API Reference

Portal Migration

​Endpoint

​Quick start

Pipes SDK Quickstart

Squid SDK Quickstart

​Schema

​Reference

API Reference

Portal Migration

Endpoint

Quick start

Schema

Reference