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

ActionWhat it does
Check addressCheck 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 overviewSee 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 blockGet 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 bandwidthSee 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 blockGet 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 feesGet 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 statusCheck 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 balanceGet how much of one token, or of TRX, an address holds right now, in whole tokens.
Get token infoGet 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 transactionLook 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 receiptGet 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 eventsList 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 transfersList 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 holdersList 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 transactionsList 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 paymentCheck 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

AddressaddresstextRequired
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

AddressaddresstextRequired
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 numberblock_numbernumberRequired
The block's number (its height), e.g. 87258914.At least 0.
Include transactionsinclude_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

AddressaddresstextRequired
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 transactionsinclude_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

AddressaddresstextRequired
The TRON address: 34 characters starting with T. Copy it from the wallet or from tronscan.org.
Tokentokentext
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 contracttoken_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

Tokentokentext
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 contracttoken_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 IDtransaction_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 IDtransaction_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

Contractcontracttext
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 addresscontract_addresstext
The contract's address, starting with T.Only when Contract is Another contract (enter its address).
Eventevent_nametext
Only this event, e.g. Transfer. Leave empty for every event the contract emits.
Fromfrom_timedate and time
Only those on or after this moment.
Toto_timedate and time
Only those on or before this moment.
Confirmed onlyconfirmed_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 firstoldest_firsttrue/false
Start from the oldest instead of the newest. Off by default.Default: false.
Page sizelimitnumber
How many to fetch, 1 to 200. 20 by default.From 1 to 200. Default: 20.
Page cursorpage_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

AddressaddresstextRequired
The TRON address: 34 characters starting with T. Copy it from the wallet or from tronscan.org.
Tokentokentext
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 contracttoken_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).
Directiondirectiontext
Sent and received, or only one side. Both by default.One of: both (Sent and received), incoming (Received only), outgoing (Sent only). Default: both.
Fromfrom_timedate and time
Only those on or after this moment.
Toto_timedate and time
Only those on or before this moment.
Minimum amountmin_amountnumber
Only transfers of at least this many tokens, e.g. 10. Leave empty for any amount.At least 0.
Confirmed onlyconfirmed_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 firstoldest_firsttrue/false
Start from the oldest instead of the newest. Off by default.Default: false.
Page sizelimitnumber
How many to fetch, 1 to 200. 20 by default.From 1 to 200. Default: 20.
Page cursorpage_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

Tokentokentext
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 contracttoken_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 sizelimitnumber
How many to fetch, 1 to 200. 20 by default.From 1 to 200. Default: 20.
Page cursorpage_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

AddressaddresstextRequired
The TRON address: 34 characters starting with T. Copy it from the wallet or from tronscan.org.
Showshowtext
TRX transfers only (the default), or every transaction.One of: trx (TRX transfers only), all (Every transaction). Default: trx.
Directiondirectiontext
Sent and received, or only one side. Both by default.One of: both (Sent and received), incoming (Received only), outgoing (Sent only). Default: both.
Fromfrom_timedate and time
Only those on or after this moment.
Toto_timedate and time
Only those on or before this moment.
Confirmed onlyconfirmed_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 firstoldest_firsttrue/false
Start from the oldest instead of the newest. Off by default.Default: false.
Page sizelimitnumber
How many to fetch, 1 to 200. 20 by default.From 1 to 200. Default: 20.
Page cursorpage_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 IDtransaction_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.
RecipientrecipienttextRequired
The address that should have been paid, starting with T.
Tokentokentext
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 contracttoken_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 amountminimum_amountnumber
The least it must have paid, in whole tokens, e.g. 25. Leave empty to accept any amount.At least 0.
Require finalrequire_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
}

On this page