Tron Transactions API

In this section we'll have a look at some examples using the Tron Transactions API.

Blocks and Super Representatives

The Blocks cube carries the block itself plus the Witness that produced it, which on Tron is the Super Representative. That makes block production attributable without a separate validator dataset.

query LatestTronBlocks {
  Tron {
    Blocks(limit: { count: 10 }, orderBy: { descending: Block_Number }) {
      Block {
        Number
        Time
        TransactionsCount
        Hash
        ParentNumber
      }
      Witness {
        Address
      }
    }
  }
}

Group by Witness to see how block production and transaction load are distributed across Super Representatives:

query BlocksPerSuperRepresentative {
  Tron {
    Blocks(limit: { count: 30 }, orderBy: { descendingByField: "blocks" }) {
      Witness {
        Address
      }
      blocks: count
      transactions: sum(of: Block_TransactionsCount)
    }
  }
}

Blocks also streams, one message per block, with no filter needed:

subscription TronChainTip {
  Tron {
    Blocks {
      Block {
        Number
        Time
        TransactionsCount
      }
      Witness {
        Address
      }
    }
  }
}

Monitor Real-time Transactions by Wallet

The subscription query below fetches the transactions on the Tron network for the wallet address TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf.

subscription {
  Tron {
    Transactions(
      where: {Transaction: {FeePayer: {is: "TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf"}}}
    ) {
      Block {
        Hash
        Time
        Number
      }
      Contract {
        Address
      }
      ChainId
      Transaction {
        Fee
        Hash
        FeePayer
        Signatures
        Result {
          Success
          Status
          Message
        }
        Time
      }
    }
  }
}

You can run the query here

Failed Transactions on Tron (Reverts & Out-of-Energy Errors)

List failed transactions for a Tron wallet with the failure message — invaluable for debugging dApps, monitoring bot health, and tracking contract reverts.

You can run the query here.

query FailedTronTransactions($address: String, $since: DateTime) {
  Tron {
    Transactions(
      where: {
        Transaction: {
          FeePayer: { is: $address }
          Result: { Success: false }
        }
        Block: { Time: { since: $since } }
      }
      orderBy: { descending: Block_Time }
      limit: { count: 50 }
    ) {
      Block {
        Time
        Number
      }
      Transaction {
        Hash
        Fee
        FeePayer
        Result {
          Success
          Status
          Message
        }
      }
    }
  }
}
{
  "address": "TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf",
  "since": "2025-01-01T00:00:00Z"
}

Top Tron Wallets by Fees Paid (24h)

Rank wallets by TRX fees paid in the last 24 hours — a popular leaderboard for spotting active bots, MEV searchers, and high-volume traders on Tron.

Try the query here.

query TopTronFeePayers24h {
  Tron {
    Transactions(
      where: {
        Block: { Time: { since_relative: { hours_ago: 24 } } }
        Transaction: { Result: { Success: true } }
      }
      orderBy: { descendingByField: "fees" }
      limit: { count: 100 }
    ) {
      Transaction {
        FeePayer
      }
      fees: sum(of: Transaction_Fee)
      txs: count
    }
  }
}