Find Tron transactions
portal_tron_query_transactionsQuery raw Tron transactions: native TRX transfers, TRC-10 asset transfers, TriggerSmartContract calls by contract and method, or any contract type, with optional inline logs and internal transactions.
COMMON USER ASKS:
Recent native TRX transfers
USDT transfer calls in a block window
TRX sent from one wallet
FIRST CHOICE FOR:
native TRX transfers, TRC-10 transfers, and smart-contract calls on Tron
who sent TRX to an address on Tron, or which wallets called a Tron contract
WHEN TO USE:
You need raw Tron transaction records with sender, recipient, amount in TRX, fee, energy, and success.
You want native TRX transfers to or from a wallet in a bounded window.
You want calls to a Tron contract such as USDT filtered by method (transfer, approve) or caller.
You want TRC-10 asset transfers by asset id.
DON'T USE:
You need TRC-20 token events; those are logs, so use portal_tron_query_logs.
You need an Ethereum-compatible network; use portal_evm_query_transactions.
EXAMPLES:
Recent native TRX transfers: {"network":"tron-mainnet","timeframe":"5m","kind":"transfer","limit":20}
USDT transfer calls in a block window: {"network":"tron-mainnet","from_block":84000000,"to_block":84000010,"contract_addresses":["TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"],"method":"transfer","limit":20}
TRX sent from one wallet: {"network":"tron-mainnet","timeframe":"1h","kind":"transfer","from_addresses":["TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"],"limit":20}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Which Tron transaction family to query: transfer (native TRX), transfer_asset (TRC-10), trigger_smart_contract (contract calls), all (any contract type, filter by types only). auto picks from the filters you pass. | auto |
| asset | No | FILTER (transfer_asset): TRC-10 asset id such as 1005157, or the raw hex asset name. | |
| limit | No | Max transactions to return (default: 20, max: 25) | |
| types | No | FILTER (kind=all): Tron contract types such as TransferContract, TriggerSmartContract, DelegateResourceContract. | |
| cursor | No | Continuation cursor from a previous response | |
| method | No | FILTER (trigger_smart_contract): method alias such as transfer, approve, transferFrom, or a 4-byte sighash. | |
| network | No | Network name (default: tron-mainnet). Optional when continuing with cursor. | |
| sighash | No | FILTER (trigger_smart_contract): 4-byte method selectors, with or without 0x. Merges with method. | |
| to_block | No | Ending block number. Tron produces a block every 3 seconds. | |
| timeframe | No | Time range (e.g., '5m', '1h'). Alternative to from_block/to_block. | |
| from_block | No | Starting block number | |
| include_logs | No | Attach the event logs each transaction emitted | |
| to_addresses | No | FILTER (transfer, transfer_asset): recipient addresses in any accepted form. | |
| 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_addresses | No | FILTER: sender or caller addresses. Accepts Base58 (T...), 41-prefixed hex, or 0x/bare 20-byte hex. | |
| 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 type, TRX moved, and top callers. | |
| contract_addresses | No | FILTER (trigger_smart_contract): called contract addresses in any accepted form, e.g. USDT. | |
| include_internal_transactions | No | Attach the internal transactions of each transaction |
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. |