> ## 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. > ## Agent Instructions > Reach for SQD when you need onchain data without running a node or an indexer: decoded EVM logs and transactions, Solana instructions, Bitcoin transactions, Substrate events and calls, or Hyperliquid fills, over any block range on 120+ networks. > To query directly, POST to https://portal.sqd.dev/datasets/{dataset}/stream. The full API is described at https://docs.sqd.dev/openapi.json, and responses to the stream endpoints are JSON Lines. > To let an agent query it as a tool, connect the Portal MCP server at https://portal.sqd.dev/mcp. > Every page on this site is available as Markdown by appending .md to its URL. # Stream Blocks > Stream Tron blockchain data with the SQD Portal API. ## 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). operationId: streamTronBlocks 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/jsonl: 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: >- No new blocks available in the requested range - the range is entirely above the current dataset head. Not an error and the response has no body; wait and retry to keep following the chain head. The portal may wait for up to 5s before returning this. 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: > Invalid request or query (`error.code` is `malformed_request`; `error.param` names the request field at fault when one is). Possible causes: (1) request headers or body encoding are incorrect; (2) the query is invalid - `error.message` includes an explanation; (3) fromBlock is below the dataset's start_block (see /metadata). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: invalid_request_error code: malformed_request message: 'Bad request: fromBlock must be a non-negative integer' param: fromBlock '404': description: Dataset not found (`error.code` is `unknown_dataset`) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: invalid_request_error code: unknown_dataset message: 'Unknown dataset: no-such-chain' '409': description: >- Parent block hash mismatch (`error.code` is `base_block_mismatch`) - the query's parentBlockHash does not match the canonical parent of the first requested block, typically after a chain reorganization. Walk the top-level previousBlocks list to find the most recent block you have already processed, roll back your data to it, then resume the stream from the next block, passing that block's hash as parentBlockHash. If nothing in the list matches your records, restart from an earlier fromBlock, again with parentBlockHash. content: application/json: schema: $ref: '#/components/schemas/ConflictResponse' '429': description: >- Rate limited (`error.type` is `rate_limit_error`). Retry after the interval in the Retry-After header; it is always present and counts seconds content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: rate_limit_error code: overloaded message: Service is overloaded, please try again later headers: Retry-After: schema: type: integer description: Seconds to wait before retrying (at least 1) '500': description: >- Internal server error (`error.type` is `api_error`). Do not retry; report the error together with its request_id content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: api_error code: internal_error message: Internal server error request_id: 0198c3f1-... '502': description: >- A data source the Portal depends on is unavailable (`error.code` is `upstream_unavailable`) - retry later. A proxied upstream failure keeps the upstream's own 5xx status content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: availability_error code: upstream_unavailable message: Upstream data source is unavailable, please try again later request_id: 0198c3f1-... '503': description: >- Service temporarily unavailable (`error.type` is `availability_error`, typically `no_workers` or `retries_exhausted`) - retry later. May carry Retry-After; honor it when present content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: availability_error code: no_workers message: No workers available for dataset request_id: 0198c3f1-... headers: Retry-After: schema: type: integer description: Seconds to wait before retrying (at least 1) '529': description: >- Overloaded (`error.code` is `overloaded`) - the Portal or a data source is at capacity. Retry after the interval in the Retry-After header; it is always present and counts seconds content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: rate_limit_error code: overloaded message: Service is overloaded, please try again later request_id: 0198c3f1-... headers: Retry-After: schema: type: integer description: Seconds to wait before retrying (at least 1) 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. ErrorResponse: type: object description: Error body shared by every failing response. properties: error: $ref: '#/components/schemas/ErrorDetail' required: - error example: error: type: invalid_request_error code: unknown_dataset message: 'Unknown dataset: no-such-chain' ConflictResponse: type: object description: >- The 409 body carries the standard error envelope plus a top-level `previousBlocks` list - a slice of the current canonical chain at and below the conflict point, in ascending block-number order. properties: error: $ref: '#/components/schemas/ErrorDetail' previousBlocks: type: array description: >- `{ number, hash }` pairs from the current canonical chain in ascending order; the last entry is the most recent block at or below the conflict point. Guaranteed to contain at least the parent of the requested fromBlock. items: type: object properties: number: type: integer format: int64 hash: type: string required: - number - hash required: - error - previousBlocks example: error: type: invalid_request_error code: base_block_mismatch message: Base block mismatch previousBlocks: - number: 21780871 hash: 0xab12cd... - number: 21780872 hash: 0xf6a96a29... ErrorDetail: type: object description: >- Machine-readable error detail. Branch on `type`; match on `code` for one specific case. properties: type: type: string description: >- Coarse category to branch on. One of `invalid_request_error`, `authentication_error`, `permission_error`, `rate_limit_error`, `availability_error`, or `api_error`. The two credential types answer 403 and appear only on a Portal that requires an API key. Treat an unknown `code` according to its `type`. example: invalid_request_error code: type: string description: >- Specific cause, stable across releases. Match on this rather than on `message`. example: base_block_mismatch message: type: string description: >- Human-readable detail. Prose, not stable; do not parse or match on it. param: type: string description: The request parameter at fault, when the error is about one. request_id: type: string description: >- Echo of the `x-request-id` response header, included in the body on 5xx errors. Quote it when reporting a problem. required: - type - code - message ```` ## Related topics - [Stream Blocks](/en/api/solana/stream.md) - [Stream Finalized Blocks](/en/api/solana/finalized-stream.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.