Skip to main content

Ethereum Transaction Balance Tracker

The Ethereum Transaction Balance Tracker API provides real-time balance updates for all addresses involved in transactions on the Ethereum blockchain, including detailed information about the reason for each balance change.

Subscribe to All Transaction Balances​

This subscription provides real-time balance updates for all addresses involved in transactions on the Ethereum network. Try the API here.

subscription {
  EVM(network: eth) {
    TransactionBalances {
      Block {
        Time
      }
      TokenBalance {
        Currency {
          Symbol
          HasURI
          SmartContract
        }
        PreBalance
        PostBalance
        Address
        BalanceChangeReasonCode
        TotalSupplyInUSD
        TotalSupply
        TokenOwnership {
          Owns
          Id
        }
        PostBalanceInUSD
      }
      Transaction {
        Hash
      }
    }
  }
}

Subscribe to Transaction Balances for a Specific Address​

This subscription filters transaction balances for a specific address. Try the API here.

subscription {
  EVM(network: eth) {
    TransactionBalances(
      where: { TokenBalance: { Address: { is: "0xYourAddressHere" } } }
    ) {
      Block {
        Time
      }
      TokenBalance {
        Currency {
          Symbol
          HasURI
          SmartContract
        }
        PreBalance
        PostBalance
        Address
        BalanceChangeReasonCode
        TotalSupplyInUSD
        TotalSupply
        TokenOwnership {
          Owns
          Id
        }
        PostBalanceInUSD
      }
      Transaction {
        Hash
      }
    }
  }
}

Latest native balance of an address​

This API gives you latest balance of a specific address (here in example 0xd194daef0cd90675a3b823fcda248f76fccb49f3) for the native currency. Try it out here.

{
  EVM(network: eth) {
    TransactionBalances(
      limit: { count: 1 }
      orderBy: { descending: Block_Time }
      where: {
        TokenBalance: {
          Address: { is: "0xd194daef0cd90675a3b823fcda248f76fccb49f3" }
          Currency: { Native: true }
        }
      }
    ) {
      Block {
        Time
      }
      TokenBalance {
        Currency {
          Symbol
          HasURI
          SmartContract
        }
        PreBalance
        PostBalance
        Address
        BalanceChangeReasonCode
        TotalSupplyInUSD
        TotalSupply
        TokenOwnership {
          Owns
          Id
        }
        PostBalanceInUSD
      }
      Transaction {
        Hash
      }
    }
  }
}

Latest balance of an address for a specific token​

This API gives you latest balance of a specific address (here in example 0xd194daef0cd90675a3b823fcda248f76fccb49f3) for a specific token (here we have taken example of USDC 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48). Try it out here.

{
  EVM(network: eth) {
    TransactionBalances(
      limit: { count: 1 }
      orderBy: { descending: Block_Time }
      where: {
        TokenBalance: {
          Address: { is: "0xd194daef0cd90675a3b823fcda248f76fccb49f3" }
          Currency: {
            SmartContract: { is: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" }
          }
        }
      }
    ) {
      Block {
        Time
      }
      TokenBalance {
        Currency {
          Symbol
          HasURI
          SmartContract
        }
        PreBalance
        PostBalance
        Address
        BalanceChangeReasonCode
        TotalSupplyInUSD
        TotalSupply
        TokenOwnership {
          Owns
          Id
        }
        PostBalanceInUSD
      }
      Transaction {
        Hash
      }
    }
  }
}

Latest liquidity of EVM Pool​

This API gives you latest liquidity of EVM Pool (here in example 0x5d4F3C6fA16908609BAC31Ff148Bd002AA6b8c83 LINK/USDC Uniswap v3 pool). Try it out here.

{
  EVM(network: eth) {
    TransactionBalances(
      limit: { count: 2 }
      limitBy: { by: TokenBalance_Currency_SmartContract, count: 1 }
      orderBy: { descendingByField: "TokenBalance_PostBalanceInUSD" }
      where: {
        TokenBalance: {
          Address: { is: "0x5d4F3C6fA16908609BAC31Ff148Bd002AA6b8c83" }
        }
      }
    ) {
      TokenBalance {
        Currency {
          Symbol
          HasURI
          SmartContract
        }
        PostBalance(maximum: Block_Time)
        PostBalanceInUSD(maximum: Block_Time)
        Address
      }
    }
  }
}

Latest Supply and Marketcap of a specific token on EVM​

This API gives you latest Supply and Marketcap of a token on EVM (here as example we have taken BITGET Token 0x54D2252757e1672EEaD234D27B1270728fF90581 ). Try it out here.

{
  EVM(network: eth) {
    TransactionBalances(
      limit: { count: 1 }
      orderBy: { descending: Block_Time }
      where: {
        TokenBalance: {
          Currency: {
            SmartContract: { is: "0x54D2252757e1672EEaD234D27B1270728fF90581" }
          }
        }
      }
    ) {
      Block {
        Time
        Number
      }
      TokenBalance {
        Currency {
          Symbol
          HasURI
          SmartContract
        }
        TotalSupplyInUSD
        TotalSupply
      }
    }
  }
}