Find Tron contract events
portal_tron_query_logsQuery raw Tron (TVM) event logs by contract address and topics with common event aliases, the parent transaction hash on every row, and optional inline decoding.
COMMON USER ASKS:
Recent USDT transfers on Tron
USDT transfers received by one wallet
FIRST CHOICE FOR:
TRC-20 token transfer events on Tron such as USDT
contract event evidence on Tron with the parent transaction hash
WHEN TO USE:
You need TRC-20 Transfer or Approval events for a token such as USDT on Tron.
You need event logs from a Tron contract filtered by topic signature or indexed address.
You want the exact transaction hash behind each Tron event.
DON'T USE:
You want native TRX transfers or contract calls; use portal_tron_query_transactions.
You need an Ethereum-compatible network; use portal_evm_query_logs.
EXAMPLES:
Recent USDT transfers on Tron: {"network":"tron-mainnet","timeframe":"5m","addresses":["TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"],"event":"transfer","decode":true,"limit":20}
USDT transfers received by one wallet: {"network":"tron-mainnet","from_block":84000000,"to_block":84000100,"addresses":["TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"],"event":"transfer","topic2":["TJLuVi6UhS3UTx5EUXNCoz9VNqP2gnPmyf"],"decode":true,"limit":20}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| event | No | FILTER: common event alias (transfer, approval, swap, mint, burn) or a topic0 hash. Merges with topic0. | |
| limit | No | Max logs to return (default: 20, max: 25) | |
| cursor | No | Continuation cursor from a previous response | |
| decode | No | Decode known event signatures inline with Base58 addresses | |
| topic0 | No | FILTER: event signature hashes, with or without 0x. | |
| topic1 | No | FILTER: indexed parameter 1 (often the sender). An address in any form is padded to a topic. | |
| topic2 | No | FILTER: indexed parameter 2 (often the recipient). An address in any form is padded to a topic. | |
| topic3 | No | FILTER: indexed parameter 3. | |
| network | No | Network name (default: tron-mainnet). Optional when continuing with cursor. | |
| to_block | No | Ending block number. Tron produces a block every 3 seconds. | |
| addresses | No | FILTER: emitting contract addresses in any form (Base58 T..., 41-prefixed hex, 0x or bare 20-byte hex). Always include this or topic0 for fast queries. | |
| timeframe | No | Time range (e.g., '5m', '1h'). Alternative to from_block/to_block. | |
| from_block | No | Starting block number | |
| to_timestamp | No | Ending timestamp. Accepts Unix seconds, Unix milliseconds, ISO datetime, or relative input like "now". | |
| finalized_only | No | Only query finalized blocks | |
| from_timestamp | No | Starting timestamp. Accepts Unix seconds, Unix milliseconds, ISO datetime, or relative input like "1h ago". | |
| max_scan_blocks | No | Safety cap for filtered latest-first scans. Default: min(window, 50000). | |
| response_format | No | Response format: defaults to 'compact' for chat-friendly output. Use 'summary' for counts by contract and event. | |
| include_transaction | No | Attach the parent transaction (type, caller, contract, result, fee). The hash is always attached. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _ui | No | Chart, table, and follow-up presentation metadata. | |
| _app | No | SQD Explorer identity and host-render state. | |
| _llm | No | Hints to locate the primary evidence. | |
| _meta | No | Network, block range, timing, and row counts. | |
| error | No | Structured failure details. | |
| items | No | Primary rows for list results. | |
| value | No | Primary scalar result. | |
| answer | No | Answer grounded in the returned data. | |
| _notice | No | Limitation or truncation notice. | |
| _server | No | SQD server name, exact version, and git commit. | |
| display | No | Labels for presenting the result. | |
| _notices | No | Limitation or truncation notices. | |
| _summary | No | Human-readable summary. | |
| _coverage | No | Window and result completeness. | |
| _evidence | No | Replayable arguments, digest, row count, and receipt. | |
| _ordering | No | Ordering guarantees. | |
| _execution | No | Bounded execution and scan details. | |
| _freshness | No | Freshness and finality. | |
| next_steps | No | Safe follow-up actions and continuation guidance. | |
| _pagination | No | Pagination state and next_cursor. | |
| investigation | No | Evidence paths, pivots, and limitations. | |
| pipes_handoff | No | SQD Pipes guidance for custom data needs. | |
| _tool_contract | No | Tool identity, intent, and chain families. |