Blocks, transactions, TVM event logs, and internal transactions. Tron is the leading network for USDT (TRC-20) settlement; because the TVM is EVM-compatible, TRC-20 events share the same topic signatures as ERC-20.
| Property | Value |
|---|---|
| Network ID | tron-mainnet |
| Real-time | Yes |
Endpoint
Quick start
Stream USDT (TRC-20) transfers — the flagship Tron query:Account and contract addresses in filters (
owner, to, contract, caller, transferTo) use the native 41-prefixed lowercase hex form. Log addresses and addresses encoded in topics use the 20-byte EVM-style hex form (no 41 prefix). Timestamps are Unix milliseconds; resource and value fields are decimal strings.Schema
Blocks
Blocks
| Field | Type | Description |
|---|---|---|
number | integer | Block number |
hash | string | Block ID (hash) |
parentHash | string | Parent block ID |
txTrieRoot | string | Root hash of the transaction Merkle trie |
version | integer | Block version |
timestamp | integer | Block timestamp (Unix ms) |
witnessAddress | string | Producing witness address (41-prefixed hex) |
witnessSignature | string | Witness signature over the header |
Transactions
Transactions
| Field | Type | Description |
|---|---|---|
transactionIndex | integer | Index in the block |
hash | string | Transaction hash (txID) |
type | string | Contract type (e.g. TransferContract, TriggerSmartContract) |
parameter | object | Decoded contract payload (type_url + value; addresses are 41-prefixed hex) |
ret | array | Result entries (e.g. contractRet: SUCCESS) |
result | string | Receipt result (e.g. SUCCESS) |
signature | array | Authorizing signatures |
contractAddress | string | Contract invoked or created (41-prefixed hex) |
contractResult | string | Hex-encoded smart-contract return value |
feeLimit | string | Max fee for execution (SUN) |
fee | string | Total fee charged (SUN) |
energyUsageTotal | string | Total energy consumed |
energyFee | string | Fee paid for energy (SUN) |
netUsage | string | Bandwidth (net) consumed |
netFee | string | Fee paid for bandwidth (SUN) |
timestamp | integer | Transaction timestamp (Unix ms) |
expiration | integer | Expiration time (Unix ms) |
Logs
Logs
| Field | Type | Description |
|---|---|---|
transactionIndex | integer | Parent transaction index |
logIndex | integer | Index in the block |
address | string | Emitting contract (20-byte EVM-style hex, no 41 prefix) |
data | string | Non-indexed log data |
topics | array | Indexed topics (topic0 is the event signature) |
Internal transactions
Internal transactions
| Field | Type | Description |
|---|---|---|
transactionIndex | integer | Parent transaction index |
internalTransactionIndex | integer | Index within the parent transaction |
hash | string | Internal transaction hash |
callerAddress | string | Initiator (41-prefixed hex) |
transferToAddress | string | Recipient (41-prefixed hex) |
callValueInfo | array | Transferred values (callValue in SUN, tokenId for TRC-10) |
note | string | Hex-encoded note (e.g. 63616c6c for “call”) |
rejected | boolean | Whether the internal transaction was rejected |
extra | string | Optional extra data |
Reference
API Reference
Field definitions and query syntax
Portal Migration
Migrate from v2 archives to Portal