Optimism

Traces and state diffs available from block 105235063 (Bedrock upgrade). Blocks 0 to 105235062 are not covered.

Property	Value
Network ID	`optimism-mainnet`
Chain ID	`10`
Real-time	Yes
Traces	✓
State Diffs	✓

Endpoint

Portal (recommended)
v2 archives (legacy)

https://portal.sqd.dev/datasets/optimism-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/optimism-mainnet

Quick start

curl --compressed -X POST \
  'https://portal.sqd.dev/datasets/optimism-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

Field	Type	Description
`transactionIndex`	integer	Index of parent transaction
`type`	string	call, create, suicide, reward
`from`	address	Trace originator address
`to`	address	Trace destination address
`value`	bigint	Value transferred
`gas`	bigint	Gas provided
`gasUsed`	bigint	Gas actually used
`input`	bytes	Input data
`output`	bytes	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

opBNB Testnet

Optimism Sepolia

⌘I

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