zkSync

Property	Value
Network ID	`zksync-mainnet`
Chain ID	`324`
Real-time	Yes
Traces	✓
State Diffs	✗

Property

Value

Network ID

zksync-mainnet

Chain ID

324

Real-time

Yes

Traces

✓

State Diffs

✗

Endpoint

Portal (recommended)
v2 archives (legacy)

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

Quick start

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

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