> ## 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 > Streams a list of blocks matching the provided data query, potentially including real-time data. Required request headers: `Content-Type: application/json`; optional request headers: `Accept-Encoding: gzip`, `Content-Encoding: gzip`. The response is JSON lines (one block object per line). ## OpenAPI ````yaml /en/api/catalog/tron/openapi.yaml post /stream openapi: 3.1.0 info: title: SQD Portal API - Tron Dataset Endpoints description: > API endpoints for interacting with the Tron dataset under the SQD Portal, specifically the Tron Mainnet dataset. Tron-specific conventions: - **Addresses in filters and transaction parameters** (`owner`, `to`, `contract`, `caller`, `transferTo`, and the addresses inside a transaction's `parameter`) use the native Tron 41-prefixed, lowercase hex form (21 bytes), e.g. the USDT contract `TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t` is `41a614f803b6fd780986a42c78ec9c7f77e6ded13c`. - **Log addresses and addresses encoded inside log topics** use the 20-byte EVM-style hex form without the `41` prefix (e.g. `a614f803b6fd780986a42c78ec9c7f77e6ded13c`), because the Tron Virtual Machine (TVM) is EVM-compatible. TRC-20 events therefore share the same `topic0` signatures as their ERC-20 counterparts. - **Timestamps** (`block.timestamp`, transaction `expiration` and `timestamp`) are Unix time in **milliseconds**. - **Numeric resource/value fields** (`fee`, `feeLimit`, `energyFee`, `energyUsageTotal`, `netUsage`, `netFee`, TRX amounts, …) are returned as decimal strings or `null` to preserve precision. version: 1.0.0 servers: - url: https://portal.sqd.dev/datasets/tron-mainnet description: SQD Portal's endpoint for Tron Mainnet security: [] paths: /stream: post: summary: Stream Blocks description: >- Streams a list of blocks matching the provided data query, potentially including real-time data. Required request headers: `Content-Type: application/json`; optional request headers: `Accept-Encoding: gzip`, `Content-Encoding: gzip`. The response is JSON lines (one block object per line). 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: USDT TRC-20 Transfers: summary: USDT (TRC-20) Transfers value: type: tron fromBlock: 79257136 toBlock: 79257200 fields: block: number: true timestamp: true log: address: true topics: true data: true transactionIndex: true logIndex: true logs: - address: - a614f803b6fd780986a42c78ec9c7f77e6ded13c topic0: - >- ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef USDT transfer() Calls: summary: USDT transfer() calls with receipts and event logs value: type: tron fromBlock: 79257136 toBlock: 79257200 fields: block: number: true timestamp: true transaction: hash: true type: true parameter: true result: true energyUsageTotal: true netUsage: true triggerSmartContractTransactions: - contract: - 41a614f803b6fd780986a42c78ec9c7f77e6ded13c sighash: - a9059cbb logs: true Native TRX Transfers: summary: Native TRX Transfers value: type: tron fromBlock: 79257136 toBlock: 79257200 fields: block: number: true timestamp: true transaction: hash: true type: true parameter: true transferTransactions: - {} Internal Transactions: summary: Internal transactions (TRX moved inside contract calls) value: type: tron fromBlock: 79257136 toBlock: 79257200 fields: block: number: true timestamp: true internalTransaction: hash: true callerAddress: true transferToAddress: true callValueInfo: true note: true transactionIndex: true internalTransactionIndex: true internalTransactions: - {} 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: USDT Transfer Log: summary: Block with a USDT (TRC-20) transfer log value: - header: number: 79257136 hash: >- 0000000004b95e300d9e52d878f88dba9776017f01923b8ab8c3680fc49b0771 timestamp: 1768435116000 logs: - transactionIndex: 2 logIndex: 0 address: a614f803b6fd780986a42c78ec9c7f77e6ded13c data: >- 00000000000000000000000000000000000000000000000000000003c4a67e65 topics: - >- ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef - >- 000000000000000000000000056d10e7b4ffd1ea56fd26f7ba5cedb3cf022ed7 - >- 000000000000000000000000201ec2a6830ce97884f284db2c080612de342806 transactions: [] internalTransactions: [] USDT transfer() Call: summary: Block with a USDT transfer() smart-contract call value: - header: number: 79257136 timestamp: 1768435116000 transactions: - transactionIndex: 2 hash: >- 3efc0ae9bd783baee44a4dde01940fd8436ad4767163cc26f1d5709270dae794 type: TriggerSmartContract result: SUCCESS contractAddress: 41a614f803b6fd780986a42c78ec9c7f77e6ded13c energyUsageTotal: '130285' netUsage: '345' parameter: type_url: type.googleapis.com/protocol.TriggerSmartContract value: owner_address: 41056d10e7b4ffd1ea56fd26f7ba5cedb3cf022ed7 contract_address: 41a614f803b6fd780986a42c78ec9c7f77e6ded13c data: >- a9059cbb000000000000000000000000201ec2a6830ce97884f284db2c080612de34280600000000000000000000000000000000000000000000000000000003c4a67e65 logs: [] internalTransactions: [] '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: USDT (TRC-20) Transfers source: > curl --compressed -X POST 'https://portal.sqd.dev/datasets/tron-mainnet/stream' \ -H 'Content-Type: application/json' \ -d '{ "type": "tron", "fromBlock": 79257136, "toBlock": 79257200, "fields": { "block": { "number": true, "timestamp": true }, "log": { "address": true, "topics": true, "data": true, "transactionIndex": true, "logIndex": true } }, "logs": [{ "address": ["a614f803b6fd780986a42c78ec9c7f77e6ded13c"], "topic0": ["ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"] }] }' - lang: shell label: USDT transfer() calls + receipts source: > curl --compressed -X POST 'https://portal.sqd.dev/datasets/tron-mainnet/stream' \ -H 'Content-Type: application/json' \ -d '{ "type": "tron", "fromBlock": 79257136, "toBlock": 79257200, "fields": { "block": { "number": true, "timestamp": true }, "transaction": { "hash": true, "type": true, "parameter": true, "result": true, "energyUsageTotal": true, "netUsage": true } }, "triggerSmartContractTransactions": [{ "contract": ["41a614f803b6fd780986a42c78ec9c7f77e6ded13c"], "sighash": ["a9059cbb"], "logs": true }] }' - lang: shell label: Native TRX Transfers source: > curl --compressed -X POST 'https://portal.sqd.dev/datasets/tron-mainnet/stream' \ -H 'Content-Type: application/json' \ -d '{ "type": "tron", "fromBlock": 79257136, "toBlock": 79257200, "fields": { "block": { "number": true, "timestamp": true }, "transaction": { "hash": true, "type": true, "parameter": true } }, "transferTransactions": [{}] }' - lang: python label: USDT (TRC-20) Transfers source: | import requests response = requests.post( "https://portal.sqd.dev/datasets/tron-mainnet/stream", json={ "type": "tron", "fromBlock": 79257136, "toBlock": 79257200, "fields": { "block": {"number": True, "timestamp": True}, "log": { "address": True, "topics": True, "data": True, "transactionIndex": True, "logIndex": True, }, }, "logs": [{ "address": ["a614f803b6fd780986a42c78ec9c7f77e6ded13c"], "topic0": ["ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"], }], }, ) blocks = [ __import__("json").loads(line) for line in response.text.splitlines() if line ] - lang: javascript label: USDT (TRC-20) Transfers source: > const response = await fetch("https://portal.sqd.dev/datasets/tron-mainnet/stream", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ type: "tron", fromBlock: 79257136, toBlock: 79257200, fields: { block: { number: true, timestamp: true }, log: { address: true, topics: true, data: true, transactionIndex: true, logIndex: true, }, }, logs: [{ address: ["a614f803b6fd780986a42c78ec9c7f77e6ded13c"], topic0: ["ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"], }], }), }); const text = await response.text(); const blocks = text.split("\n").filter(Boolean).map((line) => JSON.parse(line)); components: schemas: DataQuery: type: object properties: type: type: string enum: - tron default: tron description: The type of blockchain data (fixed to Tron 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: number: type: boolean description: Block number. hash: type: boolean description: Block ID (hash). The first 8 bytes encode the block number. parentHash: type: boolean description: ID (hash) of the parent block. txTrieRoot: type: boolean description: Root hash of the block's transaction Merkle trie. version: type: boolean description: Block version number. timestamp: type: boolean description: Block timestamp in Unix milliseconds. witnessAddress: type: boolean description: >- Address of the Super Representative (witness) that produced the block (41-prefixed hex). witnessSignature: type: boolean description: Signature of the producing witness over the block header. default: number: true hash: true parentHash: true transaction: type: object description: Field selector for transactions. properties: transactionIndex: type: boolean description: Index of the transaction in the block. hash: type: boolean description: Transaction hash (txID). type: type: boolean description: >- Contract type of the transaction, e.g. TransferContract, TransferAssetContract, TriggerSmartContract. ret: type: boolean description: >- Transaction result array; each entry carries fields such as contractRet (e.g. SUCCESS, REVERT). signature: type: boolean description: List of signatures authorizing the transaction. parameter: type: boolean description: >- Decoded contract payload (type_url plus a value object holding the contract-specific fields). permissionId: type: boolean description: Permission id used for multi-signature accounts. refBlockBytes: type: boolean description: Reference block bytes used for transaction expiration. refBlockHash: type: boolean description: Reference block hash used for transaction expiration. feeLimit: type: boolean description: >- Maximum fee (in SUN) the sender is willing to pay for smart-contract execution. expiration: type: boolean description: Expiration time of the transaction in Unix milliseconds. timestamp: type: boolean description: Transaction timestamp in Unix milliseconds. rawDataHex: type: boolean description: Hex-encoded raw transaction data. fee: type: boolean description: Total fee charged for the transaction, in SUN. contractResult: type: boolean description: Hex-encoded return value of the executed smart contract. contractAddress: type: boolean description: >- Address of the contract invoked or created (41-prefixed hex). resMessage: type: boolean description: Result message returned by the virtual machine, if any. withdrawAmount: type: boolean description: Amount withdrawn (e.g. staking rewards), in SUN. unfreezeAmount: type: boolean description: Amount unfrozen by the transaction, in SUN. withdrawExpireAmount: type: boolean description: Amount of expired unfreeze withdrawn, in SUN. cancelUnfreezeV2Amount: type: boolean description: >- Map of amounts re-frozen when cancelling pending Stake 2.0 unfreezes. result: type: boolean description: Execution result of the transaction receipt (e.g. SUCCESS). energyFee: type: boolean description: Fee paid for energy consumed, in SUN. energyUsage: type: boolean description: Energy consumed from the caller's own resources. energyUsageTotal: type: boolean description: Total energy consumed by the transaction. netUsage: type: boolean description: Bandwidth (net) consumed from the caller's own resources. netFee: type: boolean description: Fee paid for bandwidth consumed, in SUN. originEnergyUsage: type: boolean description: >- Energy paid by the contract owner (origin) under an energy-sharing policy. energyPenaltyTotal: type: boolean description: Additional energy penalty applied to the transaction. default: hash: true log: type: object description: Field selector for logs (TVM event logs). properties: transactionIndex: type: boolean description: Index of the parent transaction in the block. logIndex: type: boolean description: Index of the log in the block. address: type: boolean description: >- Contract address that emitted the log (20-byte EVM-style hex, no 41 prefix). data: type: boolean description: Non-indexed log data. topics: type: boolean description: Indexed log topics (topic0 is the event signature). default: topics: true internalTransaction: type: object description: Field selector for internal transactions. properties: transactionIndex: type: boolean description: Index of the parent transaction in the block. internalTransactionIndex: type: boolean description: >- Index of the internal transaction within its parent transaction. hash: type: boolean description: Hash of the internal transaction. callerAddress: type: boolean description: >- Address that initiated the internal transaction (41-prefixed hex). transferToAddress: type: boolean description: >- Recipient address of the internal transaction (41-prefixed hex). callValueInfo: type: boolean description: >- List of transferred values, each with callValue (amount in SUN) and tokenId (null for TRX, a TRC-10 asset id otherwise). note: type: boolean description: >- Hex-encoded note describing the internal call (e.g. 63616c6c for "call"). rejected: type: boolean description: Whether the internal transaction was rejected. extra: type: boolean description: Optional extra data attached to the internal transaction. transactions: type: array description: Transaction data requests. Matches transactions by contract type. items: type: object properties: type: type: array items: type: string description: >- Contract types to match, e.g. ["TransferContract", "TriggerSmartContract"]. logs: type: boolean description: Fetch all event logs emitted by matching transactions. internalTransactions: type: boolean description: Fetch all internal transactions of matching transactions. description: >- An empty object matches all transactions; an empty array matches no transactions. transferTransactions: type: array description: >- Native TRX transfer requests (TransferContract). Addresses are 41-prefixed lowercase hex. items: type: object properties: owner: type: array items: type: string description: Sender (owner) addresses (41-prefixed hex). to: type: array items: type: string description: Recipient addresses (41-prefixed hex). logs: type: boolean description: Fetch all event logs emitted by matching transactions. internalTransactions: type: boolean description: Fetch all internal transactions of matching transactions. description: An empty object matches all TRX transfers. transferAssetTransactions: type: array description: TRC-10 asset transfer requests (TransferAssetContract). items: type: object properties: owner: type: array items: type: string description: Sender (owner) addresses (41-prefixed hex). to: type: array items: type: string description: Recipient addresses (41-prefixed hex). asset: type: array items: type: string description: TRC-10 asset ids to match. logs: type: boolean description: Fetch all event logs emitted by matching transactions. internalTransactions: type: boolean description: Fetch all internal transactions of matching transactions. description: An empty object matches all TRC-10 transfers. triggerSmartContractTransactions: type: array description: >- Smart-contract call requests (TriggerSmartContract). Covers TRC-20 and all other contract interactions. items: type: object properties: owner: type: array items: type: string description: Caller (owner) addresses (41-prefixed hex). contract: type: array items: type: string description: >- Target contract addresses (41-prefixed hex), e.g. the USDT contract 41a614f803b6fd780986a42c78ec9c7f77e6ded13c. sighash: type: array items: type: string description: >- Function selectors (first 4 bytes of calldata), e.g. a9059cbb for transfer(address,uint256). logs: type: boolean description: Fetch all event logs emitted by matching transactions. internalTransactions: type: boolean description: Fetch all internal transactions of matching transactions. description: An empty object matches all smart-contract calls. logs: type: array description: Log data requests (TVM event logs). items: type: object properties: address: type: array items: type: string description: >- Contract addresses emitting the logs (20-byte EVM-style hex, no 41 prefix, 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 the parent transaction for matching logs. description: An empty object matches all logs; an empty array matches no logs. internalTransactions: type: array description: Internal transaction data requests. items: type: object properties: caller: type: array items: type: string description: Caller addresses (41-prefixed hex). transferTo: type: array items: type: string description: Recipient addresses (41-prefixed hex). transaction: type: boolean description: >- Fetch the parent transaction for matching internal transactions. description: >- An empty object matches all internal transactions; an empty array matches none. 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. hash: type: string description: Block ID (hash). parentHash: type: string description: Parent block ID (hash). txTrieRoot: type: string description: Root hash of the block's transaction Merkle trie. version: type: integer description: Block version number. timestamp: type: integer format: int64 description: Block timestamp in Unix milliseconds. witnessAddress: type: string description: Address of the producing witness (41-prefixed hex). witnessSignature: type: string description: Signature of the producing witness over the block header. transactions: type: array items: type: object properties: transactionIndex: type: integer description: Index of the transaction in the block. hash: type: string description: Transaction hash (txID). type: type: string description: >- Contract type of the transaction, e.g. TransferContract, TriggerSmartContract. ret: type: array description: Transaction result entries. items: type: object properties: contractRet: type: string description: Contract execution result, e.g. SUCCESS or REVERT. signature: type: array items: type: string description: Signatures authorizing the transaction. parameter: type: object description: >- Decoded contract payload (type_url plus a contract-specific value object). Address fields inside value are 41-prefixed hex. properties: type_url: type: string description: >- Protobuf type URL of the contract, e.g. type.googleapis.com/protocol.TriggerSmartContract. value: type: object description: >- Contract-specific fields (e.g. owner_address, to_address, amount, contract_address, data, asset_name). permissionId: type: - integer - 'null' description: >- Permission id used for multi-signature accounts. Null when not set. refBlockBytes: type: string description: Reference block bytes used for transaction expiration. refBlockHash: type: string description: Reference block hash used for transaction expiration. feeLimit: type: - string - 'null' description: >- Maximum fee (in SUN) the sender is willing to pay, as a decimal string. May be null. expiration: type: integer format: int64 description: Expiration time of the transaction in Unix milliseconds. timestamp: type: - integer - 'null' format: int64 description: Transaction timestamp in Unix milliseconds. May be null. rawDataHex: type: string description: Hex-encoded raw transaction data. fee: type: - string - 'null' description: Total fee charged, in SUN, as a decimal string. May be null. contractResult: type: string description: Hex-encoded smart-contract return value. contractAddress: type: - string - 'null' description: >- Address of the contract invoked or created (41-prefixed hex). Null for transactions that do not target a contract. resMessage: type: - string - 'null' description: >- Result message returned by the virtual machine, if any. May be null. withdrawAmount: type: - string - 'null' description: Amount withdrawn, in SUN, as a decimal string. May be null. unfreezeAmount: type: - string - 'null' description: Amount unfrozen, in SUN, as a decimal string. May be null. withdrawExpireAmount: type: - string - 'null' description: >- Amount of expired unfreeze withdrawn, in SUN, as a decimal string. May be null. cancelUnfreezeV2Amount: type: - object - 'null' description: >- Map of amounts re-frozen when cancelling pending Stake 2.0 unfreezes. May be null. result: type: - string - 'null' description: >- Execution result of the transaction receipt, e.g. SUCCESS. May be null. energyFee: type: - string - 'null' description: >- Fee paid for energy consumed, in SUN, as a decimal string. May be null. energyUsage: type: - string - 'null' description: >- Energy consumed from the caller's own resources, as a decimal string. May be null. energyUsageTotal: type: - string - 'null' description: >- Total energy consumed by the transaction, as a decimal string. May be null. netUsage: type: - string - 'null' description: >- Bandwidth (net) consumed from the caller's own resources, as a decimal string. May be null. netFee: type: - string - 'null' description: >- Fee paid for bandwidth consumed, in SUN, as a decimal string. May be null. originEnergyUsage: type: - string - 'null' description: >- Energy paid by the contract owner (origin), as a decimal string. May be null. energyPenaltyTotal: type: - string - 'null' description: >- Additional energy penalty applied, as a decimal string. May be null. logs: type: array items: type: object properties: transactionIndex: type: integer description: Index of the parent transaction. logIndex: type: integer description: Index of the log in the block. address: type: string description: >- Contract address emitting the log (20-byte EVM-style hex, no 41 prefix). data: type: - string - 'null' description: >- Non-indexed log data. Null when the event has no non-indexed data. topics: type: array items: type: string description: Indexed log topics (topic0 is the event signature). internalTransactions: type: array items: type: object properties: transactionIndex: type: integer description: Index of the parent transaction. internalTransactionIndex: type: integer description: Index of the internal transaction within its parent. hash: type: string description: Hash of the internal transaction. callerAddress: type: string description: >- Address that initiated the internal transaction (41-prefixed hex). transferToAddress: type: string description: Recipient address (41-prefixed hex). callValueInfo: type: array description: Transferred values for the internal transaction. items: type: object properties: callValue: type: - integer - 'null' format: int64 description: Transferred amount in SUN. May be null. tokenId: type: - string - 'null' description: TRC-10 asset id, or null for TRX transfers. note: type: string description: >- Hex-encoded note describing the internal call (e.g. 63616c6c for "call"). rejected: type: - boolean - 'null' description: Whether the internal transaction was rejected. May be null. extra: type: - string - 'null' description: >- Optional extra data attached to the internal transaction. Null when absent. ConflictResponse: type: object properties: previousBlocks: type: array items: type: object properties: number: type: integer format: int64 hash: type: string required: - number - hash required: - previousBlocks ````