Skip to main content

The address allows us to retrieve information about a specific address.

On BNB Smart Chain, addresses follow the same EVM model as Ethereum: EOAs hold BNB and interact with contracts, while contract addresses expose BEP-20 token metadata, protocol type, and on-chain attributes. The address API returns balance, annotation, balance history, and smart contract details. Use it for wallet lookups, token supply checks, and verifying contract properties before querying transfers or DEX activity on BSC.

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

query {
  ethereum(network: bsc) {
    address(address: {is: "0x55d398326f99059ff775485246999027b3197955"}) {
      smartContract {
        attributes {
          address {
            address
            annotation
          }
          name
          value
          type
        }
        contractType
        protocolType
        currency {
          decimals
          name
          symbol
          tokenType
        }
      }
      balance
      annotation
      address
    }
  }
}
Filtering Addresses
  • address: Filter by a specific address or a list of addresses.

The following are available fields for the address:

  • address: Returns the address.
  • annotation: Returns the annotation of the address if available.
  • balance: Returns the current balance of the address.
  • balances: Returns the balance history of the address.
  • smartContract: Returns details if the address is that of a smart contract.