Skip to main content

Tron Balance & Balance Updates API

In thise section we will see how to monitor real-time balance changes across the Tron blockchain

Subscribe to Balance Updates of a Particular Wallet​

The query will subscribe you to real-time updates for balance changes on the Tron blockchain, providing a continuous stream of data as new transactions are processed and recorded. Here we have used address 0xacD03D601e5bB1B275Bb94076fF46ED9D753435A. You can find the query here

subscription {
  Tron {
    BalanceUpdates(
      where: {BalanceUpdate: {Address: {is: "TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf"}}}
    ) {
      Currency {
        Name
      }
      BalanceUpdate {
        Address
        Amount
        Type
      }
      Block {
        Time
      }
      Transaction {
        Hash
      }
    }
  }
}

Balance of an Address on Tron​

Run Query ➤

{
  Tron(dataset: combined, aggregates: yes) {
    BalanceUpdates(
      where: {BalanceUpdate: {Address: {is: "TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf"}}}
      orderBy: {descendingByField: "balance"}
    ) {
      Currency {
        Name
      }
      balance: sum(of: BalanceUpdate_Amount, selectWhere: {gt: "0"})
    }
  }
}

Total Holder Count of a Tron Token​

Count the total number of unique addresses holding a Tron TRC20 token with a positive balance. A foundational metric for token-health dashboards.

Run the query here.

query TokenHolderCount {
  Tron(dataset: combined, aggregates: yes) {
    BalanceUpdates(
      where: {
        Currency: { SmartContract: { is: "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" } }
      }
    ) {
      Currency {
        Name
        Symbol
        SmartContract
      }
      holders: uniq(
        of: BalanceUpdate_Address
        selectWhere: { gt: "0" }
      )
    }
  }
}

Historical Balance of a Tron Address at a Specific Time​

Reconstruct the balance of a wallet as of a past block time — useful for audits, airdrop snapshot eligibility, retroactive analytics, and tax tooling.

Try the query here.

query HistoricalBalanceTron($address: String, $until: DateTime) {
  Tron(dataset: combined, aggregates: yes) {
    BalanceUpdates(
      where: {
        BalanceUpdate: { Address: { is: $address } }
        Block: { Time: { till: $until } }
      }
      orderBy: { descendingByField: "balance" }
    ) {
      Currency {
        Name
        Symbol
        SmartContract
      }
      balance: sum(of: BalanceUpdate_Amount, selectWhere: { gt: "0" })
    }
  }
}
{
  "address": "TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf",
  "until": "2025-06-01T00:00:00Z"
}

Full Multi-Token Portfolio of a Tron Wallet​

Return the complete TRC10 + TRC20 portfolio of any Tron address with USD valuation — the building block of Tron portfolio trackers and wallet UIs.

Run the query here.

query TronWalletPortfolio($address: String) {
  Tron(dataset: combined, aggregates: yes) {
    BalanceUpdates(
      where: { BalanceUpdate: { Address: { is: $address } } }
      orderBy: { descendingByField: "balance_usd" }
    ) {
      Currency {
        Name
        Symbol
        SmartContract
        Native
      }
      balance: sum(of: BalanceUpdate_Amount, selectWhere: { gt: "0" })
      balance_usd: sum(of: BalanceUpdate_AmountInUSD, selectWhere: { gt: "0" })
    }
  }
}
{
  "address": "TFXttAWURRrXrd9JvFPVLEh1esJK8NHxn7"
}

Top Token Holders of a token​

This query fetches you the top 10 token holders of the token TXL6rJbvmjD46zeN1JssfgxvSo99qC8MRT. Check out the query here.

query MyQuery {
  Tron(dataset: combined) {
    BalanceUpdates(
      limit: {count: 10}
      orderBy: {descendingByField: "balance"}
      where: {Currency: {SmartContract: {is: "TXL6rJbvmjD46zeN1JssfgxvSo99qC8MRT"}}}
    ) {
      balance: sum(of: BalanceUpdate_Amount, selectWhere: {gt: "0"})
      BalanceUpdate {
        Address
      }
    }
  }
}