TRON
App · 16 actions
Watch TRON, the blockchain most USDT moves on: confirm USDT and other token payments, start a workflow for each new transfer to an address, check balances, energy and bandwidth, look up transactions, receipts and blocks, read token details, holders and contract events, and check network fees and status. Read-only, through TronGrid's public API; no account or API key required.
Actions
| Action | What it does |
|---|---|
| Check address | Check an address before sending to it: whether it is a valid TRON address (and if not, what is wrong with it), whether it is activated, and whether it is a personal wallet or a smart contract such as a token. |
| Get account overview | See what a TRON address holds: its TRX (available, staked and unstaking), its energy and bandwidth, and its balances of well-known tokens such as USDT. |
| Get block | Get a block by its number: when it was made, by which Super Representative, how many transactions it holds, how many confirmations it has and whether it is final, and optionally every transaction in it. |
| Get energy and bandwidth | See an address's energy and bandwidth, the resources TRON transactions use instead of fees: what it gets a day and has left, the TRX staked for each, what it delegates to or receives from others, TRX being unstaked and when it is free, and its Super Representative votes. |
| Get latest block | Get the newest block on TRON: its number, time, the Super Representative that made it and how many transactions it holds, and optionally every transaction in it. |
| Get network fees | Get TRON's current fees and limits, as its Super Representatives set them: the TRX price of energy and bandwidth when they are burned instead of staked, the fee to activate a new address, memo and multi-signature fees, the free bandwidth every address gets a day and how long unstaking takes, plus every chain parameter as TRON names it. |
| Get network status | Check that TRON is running normally: the newest block and how long ago it was made, the newest irreversible block and how far behind it is, and the version of the node answering. |
| Get token balance | Get how much of one token, or of TRX, an address holds right now, in whole tokens. |
| Get token info | Get a TRC-20 token's details: name, symbol, decimals, total supply in whole tokens, the address that created it and the events its contract can emit. |
| Get transaction | Look up a transaction by its ID: whether it worked, what kind it is, who sent how much TRX or which tokens to whom, the fee, the block it is in, how many confirmations it has and whether it is final (irreversible). |
| Get transaction receipt | Get what a transaction cost and did: the TRX burned for energy and bandwidth, the energy and bandwidth it used and where the energy came from, why it failed if it did, the events it emitted (decoded, with token amounts) and TRX moved by contracts along the way. |
| List contract events | List the events a smart contract emitted, newest first and a page at a time, decoded by name: a token's Transfer and Approval events (with amounts in whole tokens), or USDT's AddedBlackList when Tether freezes an address. |
| List token transfers | List the TRC-20 token transfers to and from an address, such as the USDT payments it received, newest first and a page at a time. |
| List top token holders | List the addresses holding the most of a token, largest first and a page at a time, with each one's balance in whole tokens. |
| List transactions | List an address's transactions, newest first and a page at a time: its TRX transfers, or every kind (token transfers, staking, contract calls and more), each with who sent what to whom, the fee and whether it worked. |
| Verify payment | Check that a transaction paid an address: that it worked, sent the chosen token (or TRX) to the recipient, at least the minimum amount, and, by default, is final so it can't be undone. |
Check address
Check an address before sending to it: whether it is a valid TRON address (and if not, what is wrong with it), whether it is activated, and whether it is a personal wallet or a smart contract such as a token. An invalid address is an answer, not an error, so a workflow can branch on it.
Inputs
- Address
addresstextRequired - The address to check, as it was given to you.
Outputs
account_nametext- The name set on the account or contract.
account_typetext- wallet or contract, when activated.
addresstext- The address in base58 (T…), when valid.
explorer_urltext- Its page on Tronscan, TRON's block explorer.
hex_addresstext- The same address in hex (41…).
inputtext- The address as it was given.
is_activatedtrue/false- Whether it is activated. Sending TRX to an address that isn't costs the sender about 1 TRX extra.
is_tokentrue/false- Whether it is a TRC-20 token's contract.
is_validtrue/false- Whether it is a valid TRON address.
problemtext- What is wrong with it, when it isn't valid.
token_nametext- The token's name, if it is one.
token_symboltext- The token's symbol, if it is one.
trx_balancenumber- Its TRX balance, when valid.
Example output
{
"account_name": "TetherToken",
"account_type": "contract",
"address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"explorer_url": "https://tronscan.org/#/address/TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"hex_address": "41a614f803b6fd780986a42c78ec9c7f77e6ded13c",
"input": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"is_activated": true,
"is_token": true,
"is_valid": true,
"problem": null,
"token_name": "Tether USD",
"token_symbol": "USDT",
"trx_balance": 0
}Get account overview
See what a TRON address holds: its TRX (available, staked and unstaking), its energy and bandwidth, and its balances of well-known tokens such as USDT. Other tokens, which are mostly unsolicited airdrops, are listed by contract address; 'Get token balance' reads any one of them.
Inputs
- Address
addresstextRequired - The TRON address: 34 characters starting with T. Copy it from the wallet or from tronscan.org.
Outputs
account_nametext- The name set on the account, if any.
account_typetext- wallet or contract. Empty when not activated.
addresstext- A TRON address, starting with T.
bandwidth_availablenumber- Bandwidth left today, including the free 600.
bandwidth_limitnumber- Bandwidth it gets a day, including the free 600.
created_attext- When it was activated, ISO 8601 UTC.
energy_availablenumber- Energy left to use today (smart contract calls).
energy_limitnumber- Energy it gets a day.
explorer_urltext- Its page on Tronscan, TRON's block explorer.
is_activatedtrue/false- Whether the address is activated. One is activated by receiving TRX; it can hold tokens before that.
last_active_attext- When it last did something, ISO 8601 UTC.
other_token_countnumber- How many other tokens it holds.
other_tokenslist- Every other TRC-20 token it holds, by contract address.
staked_trxnumber- TRX staked for energy, bandwidth or voting, including what is delegated to other addresses.
token_balanceslist- Its balances of well-known tokens, largest token first.
total_trxnumber- Available, staked and unstaking TRX together.
trx_balancenumber- TRX available to spend, in whole TRX.
unstaking_trxnumber- TRX being unstaked, not yet withdrawable.
Example output
{
"account_name": null,
"account_type": "wallet",
"address": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
"bandwidth_available": 292153,
"bandwidth_limit": 3527310,
"created_at": "2021-09-14T11:03:45Z",
"energy_available": 374580553,
"energy_limit": 1264473015,
"explorer_url": "https://tronscan.org/#/address/TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
"is_activated": true,
"last_active_at": "2026-10-19T22:41:21Z",
"other_token_count": 1,
"other_tokens": [
{
"raw_balance": "99999000000",
"token_contract": "TVoLHooTu9uthsczLDpkBhz5ES8ueoqX11"
}
],
"staked_trx": 0,
"token_balances": [
{
"balance": 56386090.911548,
"decimals": 6,
"raw_balance": "56386090911548",
"token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"token_name": "Tether USD",
"token_symbol": "USDT"
}
],
"total_trx": 3616982.202836,
"trx_balance": 3616982.202836,
"unstaking_trx": 0
}Get block
Get a block by its number: when it was made, by which Super Representative, how many transactions it holds, how many confirmations it has and whether it is final, and optionally every transaction in it.
Inputs
- Block number
block_numbernumberRequired - The block's number (its height), e.g. 87258914.At least 0.
- Include transactions
include_transactionstrue/false - List every transaction in the block (a block holds a few hundred). Off by default: the count alone is returned.Default:
false.
Outputs
block_idtext- The block's ID (hash).
block_numbernumber- The block's number (its height).
block_timetext- When the block was made, ISO 8601 in UTC, e.g. 2026-10-19T08:15:48Z.
block_timestampnumber- The same moment as Unix milliseconds.
confirmationsnumber- How many blocks there are from it to the newest, counting itself.
explorer_urltext- Its page on Tronscan, TRON's block explorer.
is_finaltrue/false- True once the block is irreversible, about a minute after it is made.
parent_block_idtext- The ID of the block before it.
producer_addresstext- The Super Representative that made the block.
transaction_countnumber- How many transactions it holds.
transactionslist- Its transactions, when asked for; otherwise empty. Fees aren't part of a block, so fee_trx is empty here.
Example output
{
"block_id": "000000000533772259aeae54267a5428a6ffb06909322de936e378084b4750e4",
"block_number": 87258914,
"block_time": "2026-10-19T22:43:03Z",
"block_timestamp": 1792449783000,
"confirmations": 19,
"explorer_url": "https://tronscan.org/#/block/87258914",
"is_final": true,
"parent_block_id": "00000000053377218962719aea0a7008b3c6fbfba1d21ff86dfe686da4454c5e",
"producer_address": "TTxrh32VJveqiYRwbLEX2wLTMFCfbpAUQj",
"transaction_count": 257,
"transactions": [
{
"amount_trx": 1663.5,
"bandwidth_used": 275,
"block_number": 87258891,
"block_time": "2026-10-19T22:41:54Z",
"block_timestamp": 1792449714000,
"contract_address": null,
"contract_type": "TransferContract",
"direction": "outgoing",
"energy_used": 0,
"explorer_url": "https://tronscan.org/#/transaction/7e120a8b88702987c84600f081072b4ef02c572a86f819303d84f01eea026570",
"fee_trx": 1,
"from_address": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
"memo": null,
"result": "SUCCESS",
"succeeded": true,
"to_address": "TVqgttJD3nWoYkbZ4PbB75sMeuANDSrwCw",
"token_amount": null,
"token_contract": null,
"token_raw_amount": null,
"token_symbol": null,
"transaction_id": "7e120a8b88702987c84600f081072b4ef02c572a86f819303d84f01eea026570",
"type": "TRX transfer"
}
]
}Get energy and bandwidth
See an address's energy and bandwidth, the resources TRON transactions use instead of fees: what it gets a day and has left, the TRX staked for each, what it delegates to or receives from others, TRX being unstaked and when it is free, and its Super Representative votes.
Inputs
- Address
addresstextRequired - The TRON address: 34 characters starting with T. Copy it from the wallet or from tronscan.org.
Outputs
addresstext- A TRON address, starting with T.
bandwidth_availablenumber- Staked and free bandwidth left.
bandwidth_limitnumber- Staked and free bandwidth together.
delegated_bandwidth_trxnumber- TRX of bandwidth it delegates to others.
delegated_energy_trxnumber- TRX of energy it delegates to other addresses.
energy_availablenumber- Energy left.
energy_limitnumber- Energy it gets a day.
energy_usednumber- Energy used so far.
explorer_urltext- Its page on Tronscan, TRON's block explorer.
free_bandwidth_availablenumber- Of that, left.
free_bandwidth_limitnumber- Free bandwidth every activated address gets a day.
free_bandwidth_usednumber- Of that, used.
is_activatedtrue/false- Whether it is activated.
received_bandwidth_trxnumber- TRX of bandwidth others delegate to it.
received_energy_trxnumber- TRX of energy other addresses delegate to it.
staked_bandwidth_availablenumber- Of that, left.
staked_bandwidth_limitnumber- Bandwidth a day from staked TRX.
staked_bandwidth_usednumber- Of that, used so far.
staked_for_bandwidth_trxnumber- TRX it has staked for its own bandwidth.
staked_for_energy_trxnumber- TRX it has staked for its own energy.
staked_for_voting_trxnumber- TRX staked for voting power only.
tron_power_limitnumber- Votes it can cast (one per staked TRX).
tron_power_usednumber- Votes it has cast.
unstakinglist- Each amount being unstaked.
unstaking_trxnumber- TRX being unstaked in total.
voteslist- Its votes for Super Representatives.
Example output
{
"address": "TKHuVq1oKVruCGLvqVexFs6dawKv6fQgFs",
"bandwidth_available": 15136,
"bandwidth_limit": 16015,
"delegated_bandwidth_trx": 0,
"delegated_energy_trx": 0,
"energy_available": 211273,
"energy_limit": 488349,
"energy_used": 277076,
"explorer_url": "https://tronscan.org/#/address/TKHuVq1oKVruCGLvqVexFs6dawKv6fQgFs",
"free_bandwidth_available": 600,
"free_bandwidth_limit": 600,
"free_bandwidth_used": 0,
"is_activated": true,
"received_bandwidth_trx": 0,
"received_energy_trx": 0,
"staked_bandwidth_available": 14536,
"staked_bandwidth_limit": 15415,
"staked_bandwidth_used": 879,
"staked_for_bandwidth_trx": 9500,
"staked_for_energy_trx": 50853,
"staked_for_voting_trx": 0,
"tron_power_limit": 60353,
"tron_power_used": 60000,
"unstaking": [
{
"amount_trx": 500,
"available_at": "2026-11-02T09:00:00Z",
"resource": "energy"
}
],
"unstaking_trx": 500,
"votes": [
{
"super_representative": "TTxrh32VJveqiYRwbLEX2wLTMFCfbpAUQj",
"votes": 60000
}
]
}Get latest block
Get the newest block on TRON: its number, time, the Super Representative that made it and how many transactions it holds, and optionally every transaction in it. TRON makes a block every 3 seconds.
Inputs
- Include transactions
include_transactionstrue/false - List every transaction in the block (a block holds a few hundred). Off by default: the count alone is returned.Default:
false.
Outputs
block_idtext- The block's ID (hash).
block_numbernumber- The block's number (its height).
block_timetext- When the block was made, ISO 8601 in UTC, e.g. 2026-10-19T08:15:48Z.
block_timestampnumber- The same moment as Unix milliseconds.
confirmationsnumber- How many blocks there are from it to the newest, counting itself.
explorer_urltext- Its page on Tronscan, TRON's block explorer.
is_finaltrue/false- True once the block is irreversible, about a minute after it is made.
parent_block_idtext- The ID of the block before it.
producer_addresstext- The Super Representative that made the block.
transaction_countnumber- How many transactions it holds.
transactionslist- Its transactions, when asked for; otherwise empty. Fees aren't part of a block, so fee_trx is empty here.
Example output
{
"block_id": "000000000533772259aeae54267a5428a6ffb06909322de936e378084b4750e4",
"block_number": 87258914,
"block_time": "2026-10-19T22:43:03Z",
"block_timestamp": 1792449783000,
"confirmations": 1,
"explorer_url": "https://tronscan.org/#/block/87258914",
"is_final": false,
"parent_block_id": "00000000053377218962719aea0a7008b3c6fbfba1d21ff86dfe686da4454c5e",
"producer_address": "TTxrh32VJveqiYRwbLEX2wLTMFCfbpAUQj",
"transaction_count": 257,
"transactions": [
{
"amount_trx": 1663.5,
"bandwidth_used": 275,
"block_number": 87258891,
"block_time": "2026-10-19T22:41:54Z",
"block_timestamp": 1792449714000,
"contract_address": null,
"contract_type": "TransferContract",
"direction": "outgoing",
"energy_used": 0,
"explorer_url": "https://tronscan.org/#/transaction/7e120a8b88702987c84600f081072b4ef02c572a86f819303d84f01eea026570",
"fee_trx": 1,
"from_address": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
"memo": null,
"result": "SUCCESS",
"succeeded": true,
"to_address": "TVqgttJD3nWoYkbZ4PbB75sMeuANDSrwCw",
"token_amount": null,
"token_contract": null,
"token_raw_amount": null,
"token_symbol": null,
"transaction_id": "7e120a8b88702987c84600f081072b4ef02c572a86f819303d84f01eea026570",
"type": "TRX transfer"
}
]
}Get network fees
Get TRON's current fees and limits, as its Super Representatives set them: the TRX price of energy and bandwidth when they are burned instead of staked, the fee to activate a new address, memo and multi-signature fees, the free bandwidth every address gets a day and how long unstaking takes, plus every chain parameter as TRON names it.
Inputs
None.
Outputs
account_activation_bandwidth_fee_trxnumber- TRX burned for the bandwidth of an activation when the sender has none.
account_activation_fee_trxnumber- TRX it costs to activate a new address by sending to it.
bandwidth_price_trxnumber- TRX burned per byte of bandwidth.
energy_price_trxnumber- TRX burned per unit of energy.
free_bandwidth_per_daynumber- Free bandwidth every address gets a day.
maintenance_interval_hoursnumber- Hours between vote counts.
max_fee_limit_trxnumber- The most TRX a single contract call may be allowed to burn.
memo_fee_trxnumber- TRX to attach a memo to a transaction.
multisig_fee_trxnumber- TRX for a multi-signature transaction.
parameter_countnumber- How many parameters.
parameterslist- Every chain parameter, as TRON names it.
permission_update_fee_trxnumber- TRX to change an account's permissions.
total_bandwidth_per_daynumber- Bandwidth the whole network shares a day.
total_energy_per_daynumber- Energy the whole network shares a day.
trc10_issue_fee_trxnumber- TRX to issue a TRC-10 token.
unstake_wait_daysnumber- Days unstaked TRX waits before withdrawal.
Example output
{
"account_activation_bandwidth_fee_trx": 0.1,
"account_activation_fee_trx": 1,
"bandwidth_price_trx": 0.001,
"energy_price_trx": 0.0001,
"free_bandwidth_per_day": 600,
"maintenance_interval_hours": 6,
"max_fee_limit_trx": 15000,
"memo_fee_trx": 1,
"multisig_fee_trx": 1,
"parameter_count": 2,
"parameters": [
{
"key": "getEnergyFee",
"value": 100
},
{
"key": "getTransactionFee",
"value": 1000
}
],
"permission_update_fee_trx": 100,
"total_bandwidth_per_day": 43200000000,
"total_energy_per_day": 180000000000,
"trc10_issue_fee_trx": 1024,
"unstake_wait_days": 14
}Get network status
Check that TRON is running normally: the newest block and how long ago it was made, the newest irreversible block and how far behind it is, and the version of the node answering.
Inputs
None.
Outputs
blocks_until_irreversiblenumber- How far the irreversible block trails the newest, usually about 19 blocks (under a minute).
connected_peersnumber- How many other nodes it is connected to.
irreversible_block_numbernumber- The newest block that can't be undone.
is_producing_blockstrue/false- True when the newest block is under a minute old. TRON makes one every 3 seconds.
latest_block_numbernumber- The newest block's number.
latest_block_timetext- When the newest block was made, ISO 8601 UTC.
node_versiontext- The java-tron version of the node.
seconds_since_latest_blocknumber- How long ago that was.
Example output
{
"blocks_until_irreversible": 18,
"connected_peers": 30,
"irreversible_block_number": 87258914,
"is_producing_blocks": true,
"latest_block_number": 87258932,
"latest_block_time": "2026-10-19T22:43:57Z",
"node_version": "4.8.2.3",
"seconds_since_latest_block": 2
}Get token balance
Get how much of one token, or of TRX, an address holds right now, in whole tokens. Read straight from the token's contract, so it is exact and up to date.
Inputs
- Address
addresstextRequired - The TRON address: 34 characters starting with T. Copy it from the wallet or from tronscan.org.
- Token
tokentext - TRX, or a TRC-20 token. Pick a well-known one, or Another token to enter any token's contract address.One of:
TRX(TRX (TRON's own coin)),TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t(Tether USD (USDT)),TXDk8mbtRbXeYuMNS83CfKPaYYT8XWv9Hz(Decentralized USD (USDD)),TPFqcBAaaUMCSVRCqPaQ9QnzKhmuoLR6Rc(World Liberty Financial USD (USD1)),TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4(TrueUSD (TUSD)),TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8(USD Coin (USDC, no longer issued on TRON)),TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR(Wrapped TRX (WTRX)),TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4(BitTorrent (BTT)),TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9(JUST (JST)),TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S(SUN (SUN)), and 4 more. Default:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t. - Token contract
token_contracttext - The token's contract address, starting with T. It is on the token's page on tronscan.org.Only when Token is Another token (enter its contract address).
Outputs
addresstext- A TRON address, starting with T.
balancenumber- The balance in whole tokens.
decimalsnumber- How many decimal places the token has (USDT has 6).
explorer_urltext- Its page on Tronscan, TRON's block explorer.
raw_balancetext- The exact balance in the token's smallest unit.
token_contracttext- The token's contract address. Empty for TRX itself.
token_nametext- The token's name, e.g. Tether USD.
token_symboltext- The token's symbol, e.g. USDT.
Example output
{
"address": "TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf",
"balance": 882096349.686843,
"decimals": 6,
"explorer_url": "https://tronscan.org/#/address/TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf",
"raw_balance": "882096349686843",
"token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"token_name": "Tether USD",
"token_symbol": "USDT"
}Get token info
Get a TRC-20 token's details: name, symbol, decimals, total supply in whole tokens, the address that created it and the events its contract can emit.
Inputs
- Token
tokentext - The TRC-20 token. Pick a well-known one, or Another token to enter any token's contract address.One of:
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t(Tether USD (USDT)),TXDk8mbtRbXeYuMNS83CfKPaYYT8XWv9Hz(Decentralized USD (USDD)),TPFqcBAaaUMCSVRCqPaQ9QnzKhmuoLR6Rc(World Liberty Financial USD (USD1)),TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4(TrueUSD (TUSD)),TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8(USD Coin (USDC, no longer issued on TRON)),TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR(Wrapped TRX (WTRX)),TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4(BitTorrent (BTT)),TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9(JUST (JST)),TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S(SUN (SUN)),TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7(WINkLink (WIN)), and 3 more. Default:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t. - Token contract
token_contracttext - The token's contract address, starting with T. It is on the token's page on tronscan.org.Only when Token is Another token (enter its contract address).
Outputs
contract_nametext- The contract's own name, e.g. TetherToken.
creator_addresstext- The address that deployed the contract.
decimalsnumber- How many decimal places the token has (USDT has 6).
event_nameslist- The events the contract can emit, for 'List contract events'.
explorer_urltext- Its page on Tronscan, TRON's block explorer.
is_well_knowntrue/false- Whether it is in Lodol's list of well-known tokens.
raw_total_supplytext- The same in the token's smallest unit.
token_contracttext- The token's contract address. Empty for TRX itself.
token_nametext- The token's name, e.g. Tether USD.
token_symboltext- The token's symbol, e.g. USDT.
total_supplynumber- Tokens in existence, in whole tokens.
Example output
{
"contract_name": "TetherToken",
"creator_address": "THPvaUhoh2Qn2y9THCZML3H815hhFhn5YC",
"decimals": 6,
"event_names": [
"AddedBlackList",
"Approval",
"Transfer"
],
"explorer_url": "https://tronscan.org/#/token20/TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"is_well_known": true,
"raw_total_supply": "94248137158241966",
"token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"token_name": "Tether USD",
"token_symbol": "USDT",
"total_supply": 94248137158.24196
}Get transaction
Look up a transaction by its ID: whether it worked, what kind it is, who sent how much TRX or which tokens to whom, the fee, the block it is in, how many confirmations it has and whether it is final (irreversible).
Inputs
- Transaction ID
transaction_idtextRequired - The transaction's ID (also called its hash): 64 letters and digits, as the wallet or Tronscan shows it. A whole Tronscan link works too.
Outputs
amount_trxnumber- The TRX it moved or staked, if any.
bandwidth_usednumber- Bandwidth it used, in bytes.
block_numbernumber- The number of the block it is in.
block_timetext- When the block was made, ISO 8601 in UTC, e.g. 2026-10-19T08:15:48Z.
block_timestampnumber- The same moment as Unix milliseconds.
confirmationsnumber- Blocks from its block to the newest, counting its own. Zero while it isn't in a block.
contract_addresstext- The smart contract it called, for a contract call.
contract_typetext- TRON's own name for the type, e.g. TransferContract.
directiontext- incoming, outgoing or self, as seen from the address asked about. Empty when not listing an address's transactions.
energy_usednumber- Energy it used.
explorer_urltext- Its page on Tronscan, TRON's block explorer.
failure_reasontext- Why it failed, when it did.
fee_trxnumber- The TRX burned as fees. Empty in block listings, which don't include fees.
from_addresstext- Who sent it.
is_finaltrue/false- True once its block is irreversible, about a minute after it was sent.
memotext- The note attached to it, if any.
resulttext- TRON's result code: SUCCESS, REVERT, OUT_OF_ENERGY…
succeededtrue/false- Whether it worked. Empty while it isn't in a block yet.
to_addresstext- Who received the TRX or tokens (for a token transfer, the recipient, not the token contract).
token_amountnumber- The tokens a TRC-20 transfer asked to move, in whole tokens. Empty when the token's decimals aren't known.
token_contracttext- The token a TRC-20 transfer or approval is for.
token_raw_amounttext- The same amount in the token's smallest unit, as text.
token_symboltext- That token's symbol (or a TRC-10 token's ID).
token_transferslist- The token transfers it made, from its receipt. Empty if it failed or moved no tokens.
transaction_idtext- The transaction's ID: 64 letters and digits.
typetext- What kind of transaction it is, in plain words: TRX transfer, TRC-20 transfer, Stake TRX, Contract call and so on.
Example output
{
"amount_trx": null,
"bandwidth_used": 345,
"block_number": 87252772,
"block_time": "2026-10-19T17:35:48Z",
"block_timestamp": 1792431348000,
"confirmations": 6143,
"contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"contract_type": "TriggerSmartContract",
"direction": null,
"energy_used": 64285,
"explorer_url": "https://tronscan.org/#/transaction/c38d3dd6f8e72808da7ac611e307f3af73c9fb47107cb86bd7e8ab1d824b3012",
"failure_reason": null,
"fee_trx": 6.7735,
"from_address": "TQpWJLTfn9rwG8cMERDYQ3Av9WUFArzEQQ",
"is_final": true,
"memo": null,
"result": "SUCCESS",
"succeeded": true,
"to_address": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
"token_amount": 10,
"token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"token_raw_amount": "10000000",
"token_symbol": "USDT",
"token_transfers": [
{
"amount": 10,
"decimals": 6,
"from_address": "TQpWJLTfn9rwG8cMERDYQ3Av9WUFArzEQQ",
"raw_amount": "10000000",
"to_address": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
"token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"token_name": "Tether USD",
"token_symbol": "USDT"
}
],
"transaction_id": "c38d3dd6f8e72808da7ac611e307f3af73c9fb47107cb86bd7e8ab1d824b3012",
"type": "TRC-20 transfer"
}Get transaction receipt
Get what a transaction cost and did: the TRX burned for energy and bandwidth, the energy and bandwidth it used and where the energy came from, why it failed if it did, the events it emitted (decoded, with token amounts) and TRX moved by contracts along the way.
Inputs
- Transaction ID
transaction_idtextRequired - The transaction's ID (also called its hash): 64 letters and digits, as the wallet or Tronscan shows it. A whole Tronscan link works too.
Outputs
bandwidth_fee_trxnumber- Of that, TRX burned to pay for bandwidth.
bandwidth_usednumber- Bandwidth it used, in bytes.
block_numbernumber- The number of the block it is in.
block_timetext- When the block was made, ISO 8601 in UTC, e.g. 2026-10-19T08:15:48Z.
contract_addresstext- The contract it called, if any.
energy_fee_trxnumber- Of that, TRX burned to pay for energy.
energy_from_stakenumber- Energy the sender had from staking.
energy_paid_by_contractnumber- Energy the contract's owner paid for.
energy_penaltynumber- Extra energy charged because the contract is busy (TRON's dynamic energy model).
energy_usednumber- All the energy it used.
event_countnumber- How many events.
eventslist- The events it emitted.
explorer_urltext- Its page on Tronscan, TRON's block explorer.
failure_reasontext- Why it failed, when it did.
fee_trxnumber- All the TRX it burned in fees.
internal_transferslist- TRX moved by contracts while it ran.
resulttext- TRON's result code: SUCCESS, REVERT, OUT_OF_ENERGY…
succeededtrue/false- Whether it worked.
transaction_idtext- The transaction's ID: 64 letters and digits.
Example output
{
"bandwidth_fee_trx": 0.345,
"bandwidth_used": 345,
"block_number": 87252772,
"block_time": "2026-10-19T17:35:48Z",
"contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"energy_fee_trx": 6.4285,
"energy_from_stake": 0,
"energy_paid_by_contract": 0,
"energy_penalty": 49635,
"energy_used": 64285,
"event_count": 1,
"events": [
{
"amount": 10,
"block_number": 87252772,
"block_time": "2026-10-19T17:35:48Z",
"block_timestamp": 1792431348000,
"contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"event_name": "Transfer",
"explorer_url": "https://tronscan.org/#/transaction/c38d3dd6f8e72808da7ac611e307f3af73c9fb47107cb86bd7e8ab1d824b3012",
"params": {
"from": "TQpWJLTfn9rwG8cMERDYQ3Av9WUFArzEQQ",
"to": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
"value": "10000000"
},
"signature": "Transfer(address indexed from, address indexed to, uint256 value)",
"token_symbol": "USDT",
"transaction_id": "c38d3dd6f8e72808da7ac611e307f3af73c9fb47107cb86bd7e8ab1d824b3012"
}
],
"explorer_url": "https://tronscan.org/#/transaction/c38d3dd6f8e72808da7ac611e307f3af73c9fb47107cb86bd7e8ab1d824b3012",
"failure_reason": null,
"fee_trx": 6.7735,
"internal_transfers": [],
"result": "SUCCESS",
"succeeded": true,
"transaction_id": "c38d3dd6f8e72808da7ac611e307f3af73c9fb47107cb86bd7e8ab1d824b3012"
}List contract events
List the events a smart contract emitted, newest first and a page at a time, decoded by name: a token's Transfer and Approval events (with amounts in whole tokens), or USDT's AddedBlackList when Tether freezes an address. Narrow them by event and time.
Inputs
- Contract
contracttext - The contract whose events to list. Pick a token, or Another contract to enter any contract's address.One of:
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t(Tether USD (USDT)),TXDk8mbtRbXeYuMNS83CfKPaYYT8XWv9Hz(Decentralized USD (USDD)),TPFqcBAaaUMCSVRCqPaQ9QnzKhmuoLR6Rc(World Liberty Financial USD (USD1)),TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4(TrueUSD (TUSD)),TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8(USD Coin (USDC, no longer issued on TRON)),TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR(Wrapped TRX (WTRX)),TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4(BitTorrent (BTT)),TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9(JUST (JST)),TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S(SUN (SUN)),TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7(WINkLink (WIN)), and 3 more. Default:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t. - Contract address
contract_addresstext - The contract's address, starting with T.Only when Contract is Another contract (enter its address).
- Event
event_nametext - Only this event, e.g. Transfer. Leave empty for every event the contract emits.
- From
from_timedate and time - Only those on or after this moment.
- To
to_timedate and time - Only those on or before this moment.
- Confirmed only
confirmed_onlytrue/false - Only those in irreversible blocks, which TRON reaches about a minute after a transaction is sent. On by default; turn off to see the last minute too, which could in rare cases still be undone.Default:
true. - Oldest first
oldest_firsttrue/false - Start from the oldest instead of the newest. Off by default.Default:
false. - Page size
limitnumber - How many to fetch, 1 to 200. 20 by default.From 1 to 200. Default:
20. - Page cursor
page_cursortext - For the next page, the next_page_cursor of the previous result, with the other settings unchanged. Leave empty for the first page.
Outputs
contract_addresstext- A TRON address, starting with T.
countnumber- How many are in this page.
event_nametext- The event listed. Empty for every event.
eventslist- The events in this page.
has_moretrue/false- True when TronGrid has another page. That page can occasionally be empty.
next_page_cursortext- Pass this as the page cursor (with the same settings) for the next page. Empty on the last page.
Example output
{
"contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"count": 1,
"event_name": "Transfer",
"events": [
{
"amount": 10,
"block_number": 87252772,
"block_time": "2026-10-19T17:35:48Z",
"block_timestamp": 1792431348000,
"contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"event_name": "Transfer",
"explorer_url": "https://tronscan.org/#/transaction/c38d3dd6f8e72808da7ac611e307f3af73c9fb47107cb86bd7e8ab1d824b3012",
"params": {
"from": "TQpWJLTfn9rwG8cMERDYQ3Av9WUFArzEQQ",
"to": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
"value": "10000000"
},
"signature": "Transfer(address indexed from, address indexed to, uint256 value)",
"token_symbol": "USDT",
"transaction_id": "c38d3dd6f8e72808da7ac611e307f3af73c9fb47107cb86bd7e8ab1d824b3012"
}
],
"has_more": true,
"next_page_cursor": "7dveEb1DxX4L2Y6qWLhPFmx9Nyf5ZJTzv2oKAn5dtWSC6Zg4rHgiVY3"
}List token transfers
List the TRC-20 token transfers to and from an address, such as the USDT payments it received, newest first and a page at a time. Narrow them by token, direction, time and minimum amount. Approvals (permissions to spend), which move nothing, are left out, and so are transfers below the minimum, so a page can hold fewer than the page size.
Inputs
- Address
addresstextRequired - The TRON address: 34 characters starting with T. Copy it from the wallet or from tronscan.org.
- Token
tokentext - Which token's transfers to list. Every token includes the unsolicited airdrop tokens busy addresses receive.One of:
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t(Tether USD (USDT)),TXDk8mbtRbXeYuMNS83CfKPaYYT8XWv9Hz(Decentralized USD (USDD)),TPFqcBAaaUMCSVRCqPaQ9QnzKhmuoLR6Rc(World Liberty Financial USD (USD1)),TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4(TrueUSD (TUSD)),TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8(USD Coin (USDC, no longer issued on TRON)),TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR(Wrapped TRX (WTRX)),TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4(BitTorrent (BTT)),TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9(JUST (JST)),TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S(SUN (SUN)),TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7(WINkLink (WIN)), and 4 more. Default:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t. - Token contract
token_contracttext - The token's contract address, starting with T. It is on the token's page on tronscan.org.Only when Token is Another token (enter its contract address).
- Direction
directiontext - Sent and received, or only one side. Both by default.One of:
both(Sent and received),incoming(Received only),outgoing(Sent only). Default:both. - From
from_timedate and time - Only those on or after this moment.
- To
to_timedate and time - Only those on or before this moment.
- Minimum amount
min_amountnumber - Only transfers of at least this many tokens, e.g. 10. Leave empty for any amount.At least 0.
- Confirmed only
confirmed_onlytrue/false - Only those in irreversible blocks, which TRON reaches about a minute after a transaction is sent. On by default; turn off to see the last minute too, which could in rare cases still be undone.Default:
true. - Oldest first
oldest_firsttrue/false - Start from the oldest instead of the newest. Off by default.Default:
false. - Page size
limitnumber - How many to fetch, 1 to 200. 20 by default.From 1 to 200. Default:
20. - Page cursor
page_cursortext - For the next page, the next_page_cursor of the previous result, with the other settings unchanged. Leave empty for the first page.
Outputs
addresstext- A TRON address, starting with T.
countnumber- How many transfers are in this page.
directiontext- both, incoming or outgoing.
has_moretrue/false- True when TronGrid has another page. That page can occasionally be empty.
next_page_cursortext- Pass this as the page cursor (with the same settings) for the next page. Empty on the last page.
token_contracttext- That token's contract. Empty for every token.
token_symboltext- The token listed. Empty for every token.
transferslist- The transfers in this page, newest first unless Oldest first is on.
Example output
{
"address": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
"count": 1,
"direction": "incoming",
"has_more": true,
"next_page_cursor": "Cndjyb3w3YXPaK2o5scfJ7X11tMB6Vhy2HrQDWgif8rv3bMnrGp9p6K",
"token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"token_symbol": "USDT",
"transfers": [
{
"amount": 10,
"block_time": "2026-10-19T17:35:48Z",
"block_timestamp": 1792431348000,
"decimals": 6,
"direction": "incoming",
"explorer_url": "https://tronscan.org/#/transaction/c38d3dd6f8e72808da7ac611e307f3af73c9fb47107cb86bd7e8ab1d824b3012",
"from_address": "TQpWJLTfn9rwG8cMERDYQ3Av9WUFArzEQQ",
"raw_amount": "10000000",
"to_address": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
"token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"token_name": "Tether USD",
"token_symbol": "USDT",
"transaction_id": "c38d3dd6f8e72808da7ac611e307f3af73c9fb47107cb86bd7e8ab1d824b3012"
}
]
}List top token holders
List the addresses holding the most of a token, largest first and a page at a time, with each one's balance in whole tokens.
Inputs
- Token
tokentext - The TRC-20 token. Pick a well-known one, or Another token to enter any token's contract address.One of:
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t(Tether USD (USDT)),TXDk8mbtRbXeYuMNS83CfKPaYYT8XWv9Hz(Decentralized USD (USDD)),TPFqcBAaaUMCSVRCqPaQ9QnzKhmuoLR6Rc(World Liberty Financial USD (USD1)),TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4(TrueUSD (TUSD)),TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8(USD Coin (USDC, no longer issued on TRON)),TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR(Wrapped TRX (WTRX)),TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4(BitTorrent (BTT)),TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9(JUST (JST)),TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S(SUN (SUN)),TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7(WINkLink (WIN)), and 3 more. Default:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t. - Token contract
token_contracttext - The token's contract address, starting with T. It is on the token's page on tronscan.org.Only when Token is Another token (enter its contract address).
- Page size
limitnumber - How many to fetch, 1 to 200. 20 by default.From 1 to 200. Default:
20. - Page cursor
page_cursortext - For the next page, the next_page_cursor of the previous result, with the other settings unchanged. Leave empty for the first page.
Outputs
countnumber- How many are in this page.
decimalsnumber- How many decimal places the token has (USDT has 6).
has_moretrue/false- True when TronGrid has another page. That page can occasionally be empty.
holderslist- The holders in this page, largest first.
next_page_cursortext- Pass this as the page cursor (with the same settings) for the next page. Empty on the last page.
token_contracttext- The token's contract address. Empty for TRX itself.
token_nametext- The token's name, e.g. Tether USD.
token_symboltext- The token's symbol, e.g. USDT.
Example output
{
"count": 1,
"decimals": 6,
"has_more": true,
"holders": [
{
"address": "TKHuVq1oKVruCGLvqVexFs6dawKv6fQgFs",
"balance": 1417360753.786037,
"explorer_url": "https://tronscan.org/#/address/TKHuVq1oKVruCGLvqVexFs6dawKv6fQgFs",
"raw_balance": "1417360753786037"
}
],
"next_page_cursor": "5hEQooQtnmGyBxNQsX6GKEW1qcsAFq6zjhudj14aMQCEAZnBQne",
"token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"token_name": "Tether USD",
"token_symbol": "USDT"
}List transactions
List an address's transactions, newest first and a page at a time: its TRX transfers, or every kind (token transfers, staking, contract calls and more), each with who sent what to whom, the fee and whether it worked. With TRX transfers only, the page is read and then filtered, so it can hold fewer than the page size; scanned_count says how many were read.
Inputs
- Address
addresstextRequired - The TRON address: 34 characters starting with T. Copy it from the wallet or from tronscan.org.
- Show
showtext - TRX transfers only (the default), or every transaction.One of:
trx(TRX transfers only),all(Every transaction). Default:trx. - Direction
directiontext - Sent and received, or only one side. Both by default.One of:
both(Sent and received),incoming(Received only),outgoing(Sent only). Default:both. - From
from_timedate and time - Only those on or after this moment.
- To
to_timedate and time - Only those on or before this moment.
- Confirmed only
confirmed_onlytrue/false - Only those in irreversible blocks, which TRON reaches about a minute after a transaction is sent. On by default; turn off to see the last minute too, which could in rare cases still be undone.Default:
true. - Oldest first
oldest_firsttrue/false - Start from the oldest instead of the newest. Off by default.Default:
false. - Page size
limitnumber - How many to fetch, 1 to 200. 20 by default.From 1 to 200. Default:
20. - Page cursor
page_cursortext - For the next page, the next_page_cursor of the previous result, with the other settings unchanged. Leave empty for the first page.
Outputs
addresstext- A TRON address, starting with T.
countnumber- How many are in this page.
directiontext- both, incoming or outgoing.
has_moretrue/false- True when TronGrid has another page. That page can occasionally be empty.
next_page_cursortext- Pass this as the page cursor (with the same settings) for the next page. Empty on the last page.
scanned_countnumber- How many transactions were read for this page.
showtext- trx or all.
transactionslist- The transactions in this page.
Example output
{
"address": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
"count": 1,
"direction": "both",
"has_more": true,
"next_page_cursor": "2NgPQPX6mkxX1nyEcdNgHL1S2oc6C2YNniHptm52SGR18oUJ4CYKutLC9m5",
"scanned_count": 20,
"show": "trx",
"transactions": [
{
"amount_trx": 1663.5,
"bandwidth_used": 275,
"block_number": 87258891,
"block_time": "2026-10-19T22:41:54Z",
"block_timestamp": 1792449714000,
"contract_address": null,
"contract_type": "TransferContract",
"direction": "outgoing",
"energy_used": 0,
"explorer_url": "https://tronscan.org/#/transaction/7e120a8b88702987c84600f081072b4ef02c572a86f819303d84f01eea026570",
"fee_trx": 1,
"from_address": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
"memo": null,
"result": "SUCCESS",
"succeeded": true,
"to_address": "TVqgttJD3nWoYkbZ4PbB75sMeuANDSrwCw",
"token_amount": null,
"token_contract": null,
"token_raw_amount": null,
"token_symbol": null,
"transaction_id": "7e120a8b88702987c84600f081072b4ef02c572a86f819303d84f01eea026570",
"type": "TRX transfer"
}
]
}Verify payment
Check that a transaction paid an address: that it worked, sent the chosen token (or TRX) to the recipient, at least the minimum amount, and, by default, is final so it can't be undone. Answers with verified (true or false), a status and a plain reason, so a workflow can branch on it: verified, pending, not_found, failed, not_paid or underpaid.
Inputs
- Transaction ID
transaction_idtextRequired - The transaction's ID (also called its hash): 64 letters and digits, as the wallet or Tronscan shows it. A whole Tronscan link works too.
- Recipient
recipienttextRequired - The address that should have been paid, starting with T.
- Token
tokentext - TRX, or a TRC-20 token. Pick a well-known one, or Another token to enter any token's contract address.One of:
TRX(TRX (TRON's own coin)),TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t(Tether USD (USDT)),TXDk8mbtRbXeYuMNS83CfKPaYYT8XWv9Hz(Decentralized USD (USDD)),TPFqcBAaaUMCSVRCqPaQ9QnzKhmuoLR6Rc(World Liberty Financial USD (USD1)),TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4(TrueUSD (TUSD)),TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8(USD Coin (USDC, no longer issued on TRON)),TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR(Wrapped TRX (WTRX)),TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4(BitTorrent (BTT)),TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9(JUST (JST)),TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S(SUN (SUN)), and 4 more. Default:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t. - Token contract
token_contracttext - The token's contract address, starting with T. It is on the token's page on tronscan.org.Only when Token is Another token (enter its contract address).
- Minimum amount
minimum_amountnumber - The least it must have paid, in whole tokens, e.g. 25. Leave empty to accept any amount.At least 0.
- Require final
require_finaltrue/false - Only verify it once it is irreversible, about a minute after it was sent; until then the status is pending. On by default.Default:
true.
Outputs
amount_receivednumber- What reached the recipient, in whole tokens.
block_timetext- When the block was made, ISO 8601 in UTC, e.g. 2026-10-19T08:15:48Z.
confirmationsnumber- How many confirmations it has.
decimalsnumber- How many decimal places the token has (USDT has 6).
explorer_urltext- Its page on Tronscan, TRON's block explorer.
from_addresstext- Who sent the transaction.
is_finaltrue/false- Whether it is irreversible.
minimum_amountnumber- The minimum that was asked for.
raw_amount_receivedtext- The same in the token's smallest unit.
reasontext- The outcome in a sentence.
recipienttext- A TRON address, starting with T.
statustext- verified, pending (not final yet), not_found, failed, not_paid (nothing of that token reached the recipient) or underpaid.
succeededtrue/false- Whether the transaction worked.
token_contracttext- The token's contract address. Empty for TRX itself.
token_nametext- The token's name, e.g. Tether USD.
token_symboltext- The token's symbol, e.g. USDT.
transaction_idtext- The transaction's ID: 64 letters and digits.
verifiedtrue/false- True when every check passed.
Example output
{
"amount_received": 10,
"block_time": "2026-10-19T17:35:48Z",
"confirmations": 6143,
"decimals": 6,
"explorer_url": "https://tronscan.org/#/transaction/c38d3dd6f8e72808da7ac611e307f3af73c9fb47107cb86bd7e8ab1d824b3012",
"from_address": "TQpWJLTfn9rwG8cMERDYQ3Av9WUFArzEQQ",
"is_final": true,
"minimum_amount": 10,
"raw_amount_received": "10000000",
"reason": "Paid: 10 USDT reached TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G, and the transaction is final.",
"recipient": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
"status": "verified",
"succeeded": true,
"token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"token_name": "Tether USD",
"token_symbol": "USDT",
"transaction_id": "c38d3dd6f8e72808da7ac611e307f3af73c9fb47107cb86bd7e8ab1d824b3012",
"verified": true
}