Skip to main content

Address Stats

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

Address statistics aggregate a Polygon address's lifetime activity: total sent and received amounts, transaction counts, fee expenditure, distinct currencies, and active-day counts. This powers compliance profiling, explorer summary views, and portfolio dashboards that need a quick snapshot of how active an address has been on Polygon without scanning every individual transfer.

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

{
  ethereum(network: matic) {
    addressStats(address: {is: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"}) {
      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
info

Sign up on our GraphQL IDE and get your Access Token, Read our guide on getting started.