Stream Finalized Blocks

curl --compressed -X POST 'https://portal.sqd.dev/datasets/polkadot/finalized-stream' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "substrate",
    "fromBlock": 20000000,
    "toBlock": 20000100,
    "fields": {
      "block": {
        "number": true,
        "timestamp": true
      },
      "event": {
        "name": true,
        "args": true
      }
    },
    "events": [{
      "name": ["Balances.Transfer"]
    }]
  }'

[
  {
    "header": {
      "number": 20000050,
      "hash": "0xabc123def456789abc123def456789abc123def456789abc123def456789abcd",
      "parentHash": "0x789012abc345678901234567890123456789012345678901234567890123abcd",
      "timestamp": 1700000000000
    },
    "events": [
      {
        "index": 3,
        "extrinsicIndex": 1,
        "name": "Balances.Transfer",
        "phase": "ApplyExtrinsic",
        "args": {
          "from": "15oF4uVJwmo4TdGW7VfQxNLavjCXviqWrztPu9BFKHEtaqry",
          "to": "14E5nqKAp3oAJcg4aM6hEYyLT2JAPi6ixST1VRkNg8wAKPe",
          "amount": "10000000000"
        }
      }
    ]
  }
]

"<string>"

"<string>"

"<string>"

"<string>"

"<string>"

"<string>"

POST

finalized-stream

curl --compressed -X POST 'https://portal.sqd.dev/datasets/polkadot/finalized-stream' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "substrate",
    "fromBlock": 20000000,
    "toBlock": 20000100,
    "fields": {
      "block": {
        "number": true,
        "timestamp": true
      },
      "event": {
        "name": true,
        "args": true
      }
    },
    "events": [{
      "name": ["Balances.Transfer"]
    }]
  }'

[
  {
    "header": {
      "number": 20000050,
      "hash": "0xabc123def456789abc123def456789abc123def456789abc123def456789abcd",
      "parentHash": "0x789012abc345678901234567890123456789012345678901234567890123abcd",
      "timestamp": 1700000000000
    },
    "events": [
      {
        "index": 3,
        "extrinsicIndex": 1,
        "name": "Balances.Transfer",
        "phase": "ApplyExtrinsic",
        "args": {
          "from": "15oF4uVJwmo4TdGW7VfQxNLavjCXviqWrztPu9BFKHEtaqry",
          "to": "14E5nqKAp3oAJcg4aM6hEYyLT2JAPi6ixST1VRkNg8wAKPe",
          "amount": "10000000000"
        }
      }
    ]
  }
]

"<string>"

"<string>"

"<string>"

"<string>"

"<string>"

"<string>"

Real-time streaming is not supported for Substrate chains. Only finalized historical data is available. If you need real-time Substrate data, schedule a call with our team.

Body

application/json

Data query to filter and retrieve blocks. Request body may be gzipped (Content-Encoding: gzip).

fromBlock

integer<int64>

default:20000000

required

The number of the first block to fetch. If unsure how far into the past this can go consult /metadata

type

enum<string>

default:substrate

Available options:

substrate

toBlock

integer<int64>

default:20000100

The block number to fetch up to (inclusive). Optional; if omitted, streams until dataset height or timeout.

parentBlockHash

string

Expected hash of the parent of the first requested block

includeAllBlocks

boolean

default:false

If true, includes blocks with no matching data

fields

object

Field selector. See the HTTP 200 response description for details on fields that aren't self-explanatory

Show child attributes

events

object[]

Event data requests. An empty object matches all events; an empty array matches no events

Show child attributes

calls

object[]

Call data requests. An empty object matches all calls; an empty array matches no calls

Show child attributes

evmLogs

object[]

EVM.Log event requests for Frontier EVM parachains (e.g. Moonbeam, Astar). Filters on EVM.Log events specifically

Show child attributes

ethereumTransactions

object[]

Ethereum.transact call requests for Frontier EVM parachains. Filters on Ethereum.transact calls specifically

Show child attributes

contractsEvents

object[]

Contracts.ContractEmitted event requests for ink! smart contracts. Contract addresses must be hexadecimal (decoded from SS58) and lowercase

Show child attributes

gearMessagesEnqueued

object[]

Gear.UserMessageEnqueued event requests for Gear/Vara networks

Show child attributes

gearUserMessagesSent

object[]

Gear.UserMessageSent event requests for Gear/Vara networks

Show child attributes

reviveContractEmitted

object[]

Revive.ContractEmitted event requests for Revive smart contracts

Show child attributes

Response

A stream of finalized blocks in JSON lines format, optionally gzipped. Never returns blocks above the finalized head.

header

object

required

Show child attributes

extrinsics

object[]

Show child attributes

calls

object[]

Show child attributes

events

object[]

Show child attributes

Stream Blocks

Dataset Head

⌘I

Overview

Portal API reference

Networks

Body

Response