> ## Documentation Index > Fetch the complete documentation index at: https://docs.sqd.dev/llms.txt > Use this file to discover all available pages before exploring further. # Stream Blocks > Returns blocks matching the query. May include unfinalized blocks from the chain tip. ## OpenAPI ````yaml /en/api/catalog/evm/openapi.yaml post /stream openapi: 3.1.0 info: title: SQD Portal API - EVM Dataset Endpoints description: >- API endpoints for interacting with EVM datasets under the SQD Portal, specifically for the Ethereum Mainnet dataset. version: 1.0.0 servers: - url: https://portal.sqd.dev/datasets/ethereum-mainnet description: SQD Portal's endpoint for Ethereum Mainnet security: [] paths: /stream: post: summary: Stream Blocks description: >- Returns blocks matching the query. May include unfinalized blocks from the chain tip. requestBody: description: >- Data query to filter and retrieve blocks. Request body may be gzipped (Content-Encoding: gzip). required: true content: application/json: schema: $ref: '#/components/schemas/DataQuery' examples: erc20-transfers: summary: ERC-20 Transfers value: type: evm fromBlock: 21000000 toBlock: 21000100 fields: block: number: true timestamp: true log: address: true topics: true data: true transactionHash: true logIndex: true logs: - address: - '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' topic0: - >- 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef nft-transfers: summary: Track NFT Transfers value: type: evm fromBlock: 21000000 toBlock: 21000100 fields: block: number: true timestamp: true log: address: true topics: true transactionHash: true logs: - address: - '0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D' - '0x60E4d786628Fea6478F785A6d7e704777c86a7c6' - '0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB' topic0: - >- 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef transactions: summary: Transactions value: type: evm fromBlock: 21000000 toBlock: 21000100 fields: block: number: true timestamp: true transaction: hash: true from: true to: true value: true input: true gasUsed: true status: true transactions: - to: - '0xdAC17F958D2ee523a2206206994597C13D831ec7' responses: '200': description: >- A stream of blocks in JSON lines format, optionally gzipped. Can be empty if the data query has a bounded range and all blocks in the range have been skipped. May include X-Sqd-Finalized-Head-Number and X-Sqd-Finalized-Head-Hash headers, indicating the latest finalized block that's on the same chain as the returned blocks. headers: X-Sqd-Finalized-Head-Number: schema: type: integer format: int64 description: >- Block number of the latest finalized block. Returned blocks can be above, at, or below this block number. required: false X-Sqd-Finalized-Head-Hash: schema: type: string description: >- Hash of the latest finalized block. All returned blocks are guaranteed to belong to the same (not necessarily final) chain as this block. required: false content: application/json: schema: type: array items: $ref: '#/components/schemas/Block' examples: erc20-transfer: summary: Block with ERC-20 transfer log value: - header: number: 21000042 hash: 0x1a2b3c4d5e6f... parentHash: 0x9a8b7c6d5e4f... timestamp: 1728000000 logs: - logIndex: 127 transactionIndex: 45 address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48' topics: - >- 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef - >- 0x000000000000000000000000ab5801a7d398351b8be11c439e05c5b3259aec9b - >- 0x00000000000000000000000061edcdf5bb737adffe5043706e7c5bb1f1a56eea data: >- 0x00000000000000000000000000000000000000000000000000000000003d0900 transactionHash: 0xabc123... transactions: [] traces: [] stateDiffs: [] '204': description: >- Indicates that the requested block range is entirely above the range of blocks available in the dataset. The portal may wait for up to 5s before returning this. content: text/plain: schema: type: string headers: X-Sqd-Finalized-Head-Number: schema: type: integer format: int64 description: Block number of the latest finalized block. required: false X-Sqd-Finalized-Head-Hash: schema: type: string description: Hash of the latest finalized block. required: false '400': description: > Possible causes: (1) request headers or body encoding are incorrect; (2) the query is invalid - the response will include an explanation; (3) fromBlock is below the dataset's start_block (see /metadata). content: text/plain: schema: type: string '404': description: Dataset not found content: text/plain: schema: type: string '409': description: >- Conflict due to a mismatched parent block hash. This will happen when the client requests a range starting with an orphaned block in the real-time setting. The response contains a list of previous blocks belonging to the current chain; the client should find a block matching one of these (by both hash and block number) in its records and restart the stream and its business logic from that block. content: application/json: schema: $ref: '#/components/schemas/ConflictResponse' '429': description: >- Too many requests; rate limit exceeded. May include a Retry-After header indicating the number of seconds to wait before retrying the request. content: text/plain: schema: type: string headers: Retry-After: schema: type: integer description: Seconds to wait before retrying '500': description: Internal server error. Do not retry requests causing these. content: text/plain: schema: type: string '503': description: >- The server could not process the request at the moment. The client should retry the request later. May include a Retry-After header indicating the number of seconds to wait before retrying the request. content: text/plain: schema: type: string headers: Retry-After: schema: type: integer description: Seconds to wait before retrying x-codeSamples: - lang: shell label: ERC-20 Transfers source: > curl --compressed -X POST 'https://portal.sqd.dev/datasets/ethereum-mainnet/stream' \ -H 'Content-Type: application/json' \ -d '{ "type": "evm", "fromBlock": 21000000, "toBlock": 21000100, "fields": { "block": { "number": true, "timestamp": true }, "log": { "address": true, "topics": true, "data": true, "transactionHash": true, "logIndex": true } }, "logs": [{ "address": ["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"], "topic0": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"] }] }' - lang: shell label: Track NFT Transfers source: > curl --compressed -X POST 'https://portal.sqd.dev/datasets/ethereum-mainnet/stream' \ -H 'Content-Type: application/json' \ -d '{ "type": "evm", "fromBlock": 21000000, "toBlock": 21000100, "fields": { "block": { "number": true, "timestamp": true }, "log": { "address": true, "topics": true, "transactionHash": true } }, "logs": [{ "address": [ "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D", "0x60E4d786628Fea6478F785A6d7e704777c86a7c6", "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB" ], "topic0": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"] }] }' - lang: shell label: Transactions source: > curl --compressed -X POST 'https://portal.sqd.dev/datasets/ethereum-mainnet/stream' \ -H 'Content-Type: application/json' \ -d '{ "type": "evm", "fromBlock": 21000000, "toBlock": 21000100, "fields": { "block": { "number": true, "timestamp": true }, "transaction": { "hash": true, "from": true, "to": true, "value": true, "input": true, "gasUsed": true, "status": true } }, "transactions": [{ "to": ["0xdAC17F958D2ee523a2206206994597C13D831ec7"] }] }' - lang: python label: ERC-20 Transfers source: | import requests response = requests.post( "https://portal.sqd.dev/datasets/ethereum-mainnet/stream", json={ "type": "evm", "fromBlock": 21000000, "toBlock": 21000100, "fields": { "block": { "number": True, "timestamp": True }, "log": { "address": True, "topics": True, "data": True, "transactionHash": True, "logIndex": True } }, "logs": [{ "address": ["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"], "topic0": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"] }] } ) blocks = response.json() - lang: javascript label: ERC-20 Transfers source: > const response = await fetch("https://portal.sqd.dev/datasets/ethereum-mainnet/stream", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ type: "evm", fromBlock: 21000000, toBlock: 21000100, fields: { block: { number: true, timestamp: true }, log: { address: true, topics: true, data: true, transactionHash: true, logIndex: true } }, logs: [{ address: ["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"], topic0: ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"] }] }) }); const blocks = await response.json(); components: schemas: DataQuery: type: object properties: type: type: string enum: - evm default: evm description: The type of blockchain data (fixed to EVM for this API). fromBlock: type: integer format: int64 description: The block number to start fetching from (inclusive). toBlock: type: integer format: int64 description: >- The block number to fetch up to (inclusive). Optional; if omitted, streams until dataset height or timeout. parentBlockHash: type: string description: Expected hash of the parent of the first requested block. includeAllBlocks: type: boolean description: If true, includes blocks with no matching data in the response. default: false fields: type: object description: Field selector for data items to retrieve. properties: block: type: object description: Field selector for block headers. properties: hash: type: boolean description: Block hash. height: type: boolean description: Block height (same as number for EVM). number: type: boolean description: Block number. parentHash: type: boolean description: Hash of the parent block. timestamp: type: boolean description: Block timestamp in unix seconds. nonce: type: boolean description: Block nonce used in proof-of-work. sha3Uncles: type: boolean description: Hash of the list of uncle block headers. logsBloom: type: boolean description: Bloom filter for logs in this block. transactionsRoot: type: boolean description: Root hash of the transactions trie. stateRoot: type: boolean description: Root hash of the state trie. receiptsRoot: type: boolean description: Root hash of the receipts trie. mixHash: type: boolean description: Hash used in the proof-of-work algorithm. miner: type: boolean description: Address of the block producer. difficulty: type: boolean description: Block difficulty value. totalDifficulty: type: boolean description: Cumulative difficulty of the chain up to this block. extraData: type: boolean description: Arbitrary data included by the block producer. size: type: boolean description: Block size in bytes. gasLimit: type: boolean description: Maximum gas allowed in this block. gasUsed: type: boolean description: Total gas used by all transactions in this block. baseFeePerGas: type: boolean description: Base fee per gas for this block (EIP-1559). l1BlockNumber: type: boolean description: L1 block number for L2 networks. default: hash: true number: true parentHash: true transaction: type: object description: Field selector for transactions. properties: transactionIndex: type: boolean description: Index of the transaction in the block. from: type: boolean description: Sender address. to: type: boolean description: Recipient address. hash: type: boolean description: Transaction hash. gas: type: boolean description: Gas limit provided by the sender. gasPrice: type: boolean description: Gas price in wei provided by the sender. maxFeePerGas: type: boolean description: Maximum fee per gas the sender is willing to pay (EIP-1559). maxPriorityFeePerGas: type: boolean description: Maximum priority fee per gas (EIP-1559). input: type: boolean description: Call data sent with the transaction. nonce: type: boolean description: Number of transactions sent by the sender prior to this one. value: type: boolean description: Value transferred in wei. v: type: boolean description: ECDSA recovery id. r: type: boolean description: ECDSA signature r value. s: type: boolean description: ECDSA signature s value. yParity: type: boolean description: Parity of the y-coordinate of the public key (EIP-2930). chainId: type: boolean description: Chain ID specified by the transaction. gasUsed: type: boolean description: Gas used by this transaction. cumulativeGasUsed: type: boolean description: >- Total gas used in the block up to and including this transaction. effectiveGasPrice: type: boolean description: Actual gas price paid per unit of gas. contractAddress: type: boolean description: >- Address of the contract created, if this is a contract creation transaction. type: type: boolean description: Transaction type (0 for legacy, 2 for EIP-1559). status: type: boolean description: Transaction status (1 for success, 0 for failure). sighash: type: boolean description: First 4 bytes of the transaction input (function selector). l1Fee: type: boolean description: L1 fee for L2 transactions. l1FeeScalar: type: boolean description: L1 fee scalar for L2 transactions. l1GasPrice: type: boolean description: L1 gas price for L2 transactions. l1GasUsed: type: boolean description: L1 gas used for L2 transactions. l1BlobBaseFee: type: boolean description: L1 blob base fee for L2 transactions. l1BlobBaseFeeScalar: type: boolean description: L1 blob base fee scalar for L2 transactions. l1BaseFeeScalar: type: boolean description: L1 base fee scalar for L2 transactions. default: hash: true log: type: object description: Field selector for logs. properties: logIndex: type: boolean description: Index of the log in the block. transactionIndex: type: boolean description: Index of the parent transaction in the block. address: type: boolean description: Contract address that emitted the log. data: type: boolean description: Non-indexed log data. topics: type: boolean description: Indexed log topics. transactionHash: type: boolean description: Hash of the parent transaction. default: topics: true trace: type: object description: Field selector for traces. properties: transactionIndex: type: boolean description: Index of the parent transaction in the block. traceAddress: type: boolean description: Position of this trace in the trace tree. type: type: boolean description: Trace type (create, call, suicide, or reward). subtraces: type: boolean description: Number of child traces. error: type: boolean description: Error message if the trace reverted. createFrom: type: boolean description: Address that initiated the contract creation. createValue: type: boolean description: Value sent with the contract creation in wei. createGas: type: boolean description: Gas provided for the contract creation. createInit: type: boolean description: Initialization bytecode for the contract creation. createResultGasUsed: type: boolean description: Gas used by the contract creation. createResultCode: type: boolean description: Deployed bytecode from the contract creation. createResultAddress: type: boolean description: Address of the newly created contract. callFrom: type: boolean description: Address that initiated the call. callTo: type: boolean description: Address that received the call. callValue: type: boolean description: Value sent with the call in wei. callGas: type: boolean description: Gas provided for the call. callSighash: type: boolean description: Function selector (first 4 bytes of input) for the call. callInput: type: boolean description: Input data for the call. callResultGasUsed: type: boolean description: Gas used by the call. callResultOutput: type: boolean description: Output data returned by the call. suicideAddress: type: boolean description: Address of the self-destructed contract. suicideRefundAddress: type: boolean description: Address that received the remaining balance. suicideBalance: type: boolean description: Balance sent to the refund address. rewardAuthor: type: boolean description: Address that received the block reward. rewardValue: type: boolean description: Reward amount in wei. rewardType: type: boolean description: Type of reward (block or uncle). stateDiff: type: object description: Field selector for state diffs. properties: transactionIndex: type: boolean description: Index of the parent transaction in the block. address: type: boolean description: Address of the account or contract whose state changed. key: type: boolean description: Storage key or special key (balance, code, nonce). kind: type: boolean description: >- Type of state change: = (unchanged), + (added), * (modified), - (removed). prev: type: boolean description: Previous value before the state change. next: type: boolean description: New value after the state change. logs: type: array description: Log data requests. items: type: object properties: address: type: array items: type: string description: Contract addresses emitting the logs (lowercase). topic0: type: array items: type: string description: First topic of the log (e.g., event signature). topic1: type: array items: type: string topic2: type: array items: type: string topic3: type: array items: type: string transaction: type: boolean description: Fetch parent transactions for matching logs. transactionTraces: type: boolean description: Fetch traces for parent transactions. transactionLogs: type: boolean description: Fetch all logs emitted by parent transactions. description: An empty object matches all logs; an empty array matches no logs. transactions: type: array description: Transaction data requests. items: type: object properties: from: type: array items: type: string description: Sender addresses (lowercase). to: type: array items: type: string description: Recipient addresses (lowercase). sighash: type: array items: type: string description: Function signature hashes (e.g., 0xa9059cbb for transfer). logs: type: boolean description: Fetch all logs emitted by matching transactions. traces: type: boolean description: Fetch all traces for matching transactions. stateDiffs: type: boolean description: Fetch all state diffs caused by matching transactions. description: >- An empty object matches all transactions; an empty array matches no transactions. traces: type: array description: Trace data requests. items: type: object properties: type: type: array items: type: string enum: - create - call - suicide - reward description: Type of trace. createFrom: type: array items: type: string description: Address initiating a create trace. callFrom: type: array items: type: string description: Address initiating a call trace. callTo: type: array items: type: string description: Address receiving a call trace. callSighash: type: array items: type: string description: Function signature hash for call traces. suicideRefundAddress: type: array items: type: string description: Refund address for suicide traces. rewardAuthor: type: array items: type: string description: Author receiving a reward trace. transaction: type: boolean description: Fetch parent transactions for matching traces. transactionLogs: type: boolean description: Fetch all logs emitted by parent transactions. subtraces: type: boolean description: Fetch all subtraces of matching traces. parents: type: boolean description: Fetch parent traces of matching traces. description: >- An empty object matches all traces; an empty array matches no traces. stateDiffs: type: array description: State diff data requests. items: type: object properties: address: type: array items: type: string description: Contract or account addresses (lowercase). key: type: array items: type: string description: Storage keys or special keys (balance, code, nonce). kind: type: array items: type: string enum: - '=' - + - '*' - '-' description: Type of state change. transaction: type: boolean description: Fetch parent transactions for matching state diffs. description: >- An empty object matches all state diffs; an empty array matches no state diffs. required: - type - fromBlock Block: type: object properties: header: type: object description: >- Block header data. Fields are conditionally returned based on the `fields.block` parameter in the request. Only requested fields will be included in the response. properties: number: type: integer format: uint64 description: Block number. height: type: integer format: uint64 description: Block height (same as number for EVM). hash: type: string description: Block hash. parentHash: type: string description: Parent block hash. timestamp: type: integer description: Block timestamp. nonce: type: string description: Block nonce. sha3Uncles: type: string logsBloom: type: string transactionsRoot: type: string stateRoot: type: string receiptsRoot: type: string mixHash: type: string miner: type: string difficulty: type: integer format: uint64 totalDifficulty: type: integer format: uint64 extraData: type: string size: type: integer format: uint64 gasLimit: type: integer format: uint64 gasUsed: type: integer format: uint64 baseFeePerGas: type: integer format: uint64 l1BlockNumber: type: integer description: L1 block number for L2 networks. transactions: type: array items: type: object properties: transactionIndex: type: integer description: Index of the transaction in the block. from: type: string description: Sender address (lowercase). to: type: string description: Recipient address (lowercase). hash: type: string description: Transaction hash. gas: type: integer format: uint64 gasPrice: type: integer format: uint64 maxFeePerGas: type: integer format: uint64 maxPriorityFeePerGas: type: integer format: uint64 input: type: string nonce: type: integer value: type: integer format: uint64 v: type: integer format: uint64 r: type: string s: type: string yParity: type: integer chainId: type: integer gasUsed: type: integer format: uint64 cumulativeGasUsed: type: integer format: uint64 effectiveGasPrice: type: integer format: uint64 contractAddress: type: string type: type: integer description: Transaction type (e.g., 0 for legacy, 2 for EIP-1559). status: type: integer description: Transaction status (1 for success, 0 for failure). sighash: type: string l1Fee: type: integer format: uint64 l1FeeScalar: type: number l1GasPrice: type: integer format: uint64 l1GasUsed: type: integer format: uint64 l1BlobBaseFee: type: integer format: uint64 l1BlobBaseFeeScalar: type: number l1BaseFeeScalar: type: number logs: type: array items: type: object properties: logIndex: type: integer description: Index of the log in the block. transactionIndex: type: integer description: Index of the parent transaction. address: type: string description: Contract address emitting the log (lowercase). data: type: string description: Log data. topics: type: array items: type: string description: Log topics. transactionHash: type: string description: Hash of the parent transaction. traces: type: array items: type: object properties: transactionIndex: type: integer description: Index of the parent transaction. traceAddress: type: array items: type: integer description: Address of the trace in the trace tree. type: type: string enum: - create - call - suicide - reward description: Type of trace. subtraces: type: integer description: Number of subtraces. error: type: string description: Error message, if any. action: type: object properties: from: type: string description: Initiator address for create/call. value: type: integer format: uint64 description: Value transferred. gas: type: integer format: uint64 description: Gas provided. init: type: string description: Initialization code for create. to: type: string description: Recipient address for call. sighash: type: string description: Function signature hash for call. input: type: string description: Input data for call. address: type: string description: Contract address for suicide. refundAddress: type: string description: Refund address for suicide. balance: type: integer format: uint64 description: Balance for suicide. author: type: string description: Reward recipient. rewardType: type: string description: Type of reward. result: type: object properties: gasUsed: type: integer format: uint64 description: Gas used by create/call. code: type: string description: Deployed code for create. address: type: string description: Created contract address. output: type: string description: Output data for call. stateDiffs: type: array items: type: object properties: transactionIndex: type: integer description: Index of the parent transaction. address: type: string description: Contract or account address (lowercase). key: type: string description: Storage key or special key (balance, code, nonce). kind: type: string enum: - '=' - + - '*' - '-' description: Type of state change. prev: type: string description: Previous value. next: type: string description: New value. ConflictResponse: type: object properties: previousBlocks: type: array items: type: object properties: number: type: integer format: int64 hash: type: string required: - number - hash required: - previousBlocks ````