Skip to main content

The activeAddresses field allows us to retrieve details about the active addresses from the BNB blockchain.

Active addresses count distinct wallets that participated in transfers on BSC during a given period—a key engagement metric for ecosystem dashboards, DeFi protocol growth reports, and investor-facing analytics. You can filter by currency, amount thresholds, sender/receiver roles, and date ranges to segment the count by token, whale activity, or specific time windows.

Here is an example that demonstrates how to retrieve the number of active addresses from the BNB blockchain:

query MyQuery {
  ethereum (network: bsc){
    activeAddresses(date: {after: "2023-07-17T00:00:00Z"}) {
      count(uniq: address)
    }
  }
}
Filtering Acitve Addresses

Active Addresses can be filtered using the following arguments:

  • amount: Filtered by the amount of tokens.
  • currency: Filtered by the currency the address holds.
  • date: Filter by date
  • entityId: Filter by ERC721 entity id.
  • external:
  • height: Filter by block height.
  • options: Filter returned data by ordering, limiting, and constraining it. Available fields: asc, ascByInteger, desc, descByInteger, limit, limitBy, offset.
  • receiver: Filter by the address of the receiver
  • sender: Filter by the address of the sender
  • success: Filter by success of the transaction
  • time: Filter by time
  • txFrom: Filter by the address that created the transaction.
  • txHash: Filter by the transaction hash

The following are available fields for the activeAddresses:

  • address: returns the address and its annotation.
  • count: returns the aggregate count of active addresses.
  • countBigInt: returns the aggregate count of active addresses in BigInt format.