Skip to main content

Address

The Solana address API returns the latest SOL balance and annotation for a Solana account, plus account-level metadata where indexed. Solana addresses (public keys) can be regular wallets, token accounts, or program-derived addresses; this API is the fastest way to fetch balance and label data without traversing transfer history.

It is most useful for wallet directories, portfolio dashboards, accounting bootstraps (opening balances), and compliance pre-checks (does an address have a Bitquery annotation?). For SPL token portfolios or balance at a specific timestamp/block, pair this API with the transfers API.

query MyQuery {
  solana(network: solana) {
    address(address: {is: "address of the wallet"}) {
      address
      balance
      annotation
    }
  }
}

Common use cases​

  • Portfolio and dashboards — single-wallet SOL balance and batched multi-address lookups.
  • Accounting and audit — combine current SOL balance with historical balance from transfers for opening/closing positions.
  • SPL token portfolios — per-token positions are derived from transfers + aggregation.
  • Compliance pre-checks — surface any Bitquery annotation on an address before deeper diligence.
Filtering Address

address: Specify the address of the wallet. The is keyword is used to specify that the address must match the value that is provided.

Fields​

address

The address field specifies the address of the account that you want to get the balance for.

annotation

Any label on the account.

balance

The balance of the account in SOL.