Skip to main content

The addressstats field allows us to retrieves statistics related to blockchain addresses.

Address statistics aggregate a BSC address's lifetime activity into a single response: total BNB and token amounts sent and received, transaction counts, fee totals, distinct currency counts, and the number of active days. This helps compliance teams profile addresses, exchange operators build account-health dashboards, and analytics products surface whale or bot behavior without replaying individual transactions.

Here is an example that demonstrates how to retrieve statistics about the USDT smart contract:

{
  ethereum (network: bsc){
    addressStats(address: {is: "0x55d398326f99059ff775485246999027b3197955"}) {
      address {
        balance
        callTxCount
        calledTxCount
        daysWithReceived
        daysWithSent
        daysWithTransactions
        daysWithTransfers
        feeAmount
        otherTxCount
        receiveAmount
        receiveFromCurrencies
        receiveTxCount
        receiveFromCount
        sendAmount
        sendToCount
        sendToCurrencies
        sendTxCount
      }
    }
  }
}
Filtering Address Stats
  • address: Filter by a specific address or a list of addresses
  • options: Filter returned data by ordering, limiting, and constraining it. Available fields: asc, ascByInteger, desc, descByInteger, limit, limitBy, offset.
  • address: Returns statistics for the blockchain address