Skip to main content

Address Stats

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

Address statistics aggregate a Celo address's lifetime activity: total sent and received amounts, transaction counts, fee expenditure, and active-day counts across CELO and stablecoin transfers. This is useful for compliance profiling, remittance-corridor analysis, and building account health dashboards for Celo's mobile-payment ecosystem.

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

{
  ethereum (network: celo_mainnet){
    addressStats(address: {is: "address here"}) {
      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