{"skill":{"slug":"tronscan-transaction-info","displayName":"TronScan Transaction Info","summary":"Query TRON transaction result, confirmation status, sender, resource consumption. Use when user asks \"why did this tx fail\", \"tx status\", \"who sent it\", \"ene...","description":"---\nname: tronscan-transaction-info\ndescription: |\n  Query TRON transaction result, confirmation status, sender, resource consumption.\n  Use when user asks \"why did this tx fail\", \"tx status\", \"who sent it\", \"energy consumed\", provides a tx hash, or asks about transaction details.\n  Do NOT use for address balance or token holders (use tronscan-account-profiler or tronscan-token-scanner).\nmetadata:\n  author: tronscan-mcp\n  version: \"1.0\"\n  mcp-server: https://mcp.tronscan.org/mcp\n---\n\n# Transaction Info\n\n## Overview\n\n| Tool | Function | Use Case |\n|------|----------|----------|\n| getTransactionDetail | Tx by hash | Type, confirmation, amount, energy/bandwidth |\n| getTransactionList | Tx list | List with filters, sort, pagination |\n| getTrc20Transfers | TRC20/721 transfers | Token transfer records |\n| getTrc20TransfersWithStatus | TRC20 with status | TRC20 transfers plus tx status |\n| getTrc1155Transfers | TRC1155 transfers | Multi-token transfers |\n| getTransferList | TRX/TRC10 transfers | Native TRX and TRC10 transfers |\n| getInternalTransactions | Internal txs | Contract internal calls |\n| getTransactionStatistics | Tx statistics | Aggregate tx and token volume |\n| getTransferStatistics | Transfer statistics | Transfer activity by token type |\n| getExchangeTransactions | Exchange txs | Exchange-type transactions |\n\n## Use Cases\n\n1. **Transaction Result**: Use `getTransactionDetail` for success/fail and confirmation.\n2. **Confirmation Status**: Confirmation and block info are in `getTransactionDetail`.\n3. **Sender / Receiver**: Use `getTransactionDetail` for from/to; use transfer tools for token flows.\n4. **Resource Consumption**: Energy and bandwidth used are in `getTransactionDetail`.\n5. **Token Transfers in Tx**: Use `getTransactionDetail`; its response includes `trc20TransferInfo`, `transfersAllList`, and other tx-level transfer info.\n6. **Internal Calls**: Use `getInternalTransactions` for contract internal txs.\n\n## MCP Server\n\n- **Prerequisite**: [TronScan MCP Guide](https://mcpdoc.tronscan.org)\n\n## Tools\n\n### getTransactionDetail\n\n- **API**: `getTransactionDetail` — Get transaction detail by hash (type, confirmation, amount, energy/bandwidth)\n- **Use when**: User provides a tx hash or asks \"transaction status\", \"tx result\", or \"token transfers in this tx\".\n- **Input**: Transaction hash (txid).\n- **Response**: Type, confirmed, amount, energy, bandwidth, from, to, block, `trc20TransferInfo`, `transfersAllList`, and other tx-level transfer info.\n- **Units**:\n  - `net_fee`, `energy_fee`, `fee_limit`: in **sun** (1 TRX = 10⁶ sun); divide by 1,000,000 to get TRX.\n  - `amount_str`(TRC20): in **smallest unit**; divide by 10^decimals to get human-readable amount.\n  - `contractData.amount` (TRX transfer): in **sun** (1 TRX = 10⁶ sun); divide by 1,000,000 to get TRX.\n\n### getTransactionList\n\n- **API**: `getTransactionList` — Get transaction list with pagination, sort, and filters\n- **Use when**: User asks for \"list of transactions\" or \"recent txs\" for an address or globally.\n\n### getTrc20Transfers / getTrc20TransfersWithStatus\n\n- **API**: `getTrc20Transfers` — Get TRC20/TRC721 transfer records; `getTrc20TransfersWithStatus` — Get TRC20 transfers with tx status\n- **Use when**: User asks for \"token transfer\" or \"TRC20 transfer\" by **address**, **contract**, or **time range**. For transfers within a single tx, use `getTransactionDetail`.\n\n### getTrc1155Transfers\n\n- **API**: `getTrc1155Transfers` — Get TRC1155 transfer records\n- **Use when**: User asks for TRC1155 transfers by **address**, **contract**, or **time range**. For transfers within a single tx, use `getTransactionDetail`.\n\n### getTransferList\n\n- **API**: `getTransferList` — Get TRX and TRC10 transfer records\n- **Use when**: User asks for \"TRX transfer\" or \"TRC10 transfer\" by **address**, **contract**, or **time range**. For transfers within a single tx, use `getTransactionDetail`.\n\n### getInternalTransactions\n\n- **API**: `getInternalTransactions` — Get smart contract internal transaction list\n- **Use when**: User asks for \"internal tx\" or \"contract internal call\".\n\n### getTransactionStatistics / getTransferStatistics\n\n- **API**: `getTransactionStatistics` — Get transaction statistics (total tx, token tx volume, etc.); `getTransferStatistics` — Get transfer statistics by token type\n- **Use when**: User asks for \"tx volume\" or \"transfer distribution\".\n\n### getExchangeTransactions\n\n- **API**: `getExchangeTransactions` — Get exchange-type transactions\n- **Use when**: User asks for \"exchange transactions\" or \"DEX transactions\".\n- **Response**: Exchange-type transaction list.\n\n## Workflow: Transaction Investigation\n\n> User: \"Why did this tx fail?\" or \"Who sent it, what did it do?\"\n\n1. **tronscan-transaction-info** — Use tx hash to call `getTransactionDetail` → result, confirmation, from/to, amount, energy/bandwidth.\n2. If asking about **sender or receiver**: **tronscan-account-profiler** — `getAccountDetail`(from/to address) for balance and resources; if counterparty is a contract, **tronscan-contract-analysis** — `getContractDetail`(contract address).\n3. If **token transfers within the tx** are needed: `getTransactionDetail` response already includes `trc20TransferInfo`, `transfersAllList`, etc. — no need to call transfer list tools. If **internal calls** needed: `getInternalTransactions` (pass tx hash as parameter where supported).\n\n**Data handoff**: User-provided tx hash is input for step 1. The from/to or contract address from step 1 feeds into step 2.\n\n## Troubleshooting\n\n- **MCP connection failed**: If you see \"Connection refused\", verify TronScan MCP is connected in Settings > Extensions.\n- **API rate limit / 429**: TronScan API has call count and frequency limits when no API key is used. If you encounter rate limiting or 429 errors, go to [TronScan Developer API](https://tronscan.org/#/developer/api) to apply for an API key, then add it to your MCP configuration and retry.\n\n### Invalid tx hash\nEnsure the hash is a valid TRON transaction ID (64 hex chars). If tx not found, it may be pending or on a different network.\n\n## Notes\n\n- Always use `getTransactionDetail` first when user has a tx hash; token transfers within the tx are already in its response—no need to call `getTrc20Transfers` / `getTrc1155Transfers` / `getTransferList`.\n- `getTrc20Transfers`, `getTrc1155Transfers`, `getTransferList` are for address, contract, or time-range investigation; they **do not expose tx hash filter parameters**. Do not fabricate tx-hash filter or claim filtering by tx hash.\n- Energy/bandwidth in response are in the same unit as chain (energy in units, bandwidth in bytes).\n- Token entries in `trc20TransferInfo` and `transfersAllList` may include risk fields such as `tokenCanShow` and `tokenLevel`. If the transacted token has `tokenCanShow: false` or `tokenLevel` of `\"3\"` / `\"4\"`, warn the user that this transaction involves a potentially risky token. See **tronscan-token-scanner** for full field semantics.\n","tags":{"latest":"1.0.8","TRON":"1.0.1","bandwidth":"1.0.1","confirmation":"1.0.1","energy":"1.0.1","hash":"1.0.1","transaction":"1.0.1","transfer":"1.0.1","tx":"1.0.1"},"stats":{"comments":0,"downloads":799,"installsAllTime":30,"installsCurrent":0,"stars":1,"versions":9},"createdAt":1773290914612,"updatedAt":1778491848315},"latestVersion":{"version":"1.0.8","createdAt":1774596359028,"changelog":"No major changes—minor documentation update:\n\n- Added note: If token involved in transaction has `tokenCanShow: false` or `tokenLevel: \"3\"` or `\"4\"`, warn user the token may be risky.\n- Referenced **tronscan-token-scanner** for full field meaning.\n- No functional or interface changes.","license":"MIT-0"},"metadata":null,"owner":{"handle":"sshnii","userId":"s17dsg90r9649q4z39neh6fte983h6eb","displayName":"BigFrog","image":"https://avatars.githubusercontent.com/u/142767282?v=4"},"moderation":null}