Skip to main content

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

Address statistics provide an aggregate profile of a Bitcoin address: total sent and received amounts, transaction counts, fee totals, and the number of active days. This is useful for risk scoring, compliance profiling, and building explorer-style address summary pages without pulling individual transaction history. Because Bitcoin uses a UTXO model, these aggregates are derived from input and output activity rather than account-level state.

Here is an example that demonstrates how to retrieve statistics about a specific address; there is a balance field, too; please avoid using it; if you require a BTC balance, then please use this API.

{
  bitcoin {
    addressStats(address: {is: "bc1pu4q5amnl4t02mu0wf7ul7lqesjnzt7xqnu2zgcagpr4322rp6haqdyf5mv"}) {
      address {
        address
        annotation
        inboundTransactions
        inflows
        outboundTransactions
        outflows
        uniqueDaysWithTransfers
        uniqueReceivers
        uniqueSenders
      }
    }
  }
}

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