Skip to main content

Solana Address API examples

The Solana Address API on Bitquery V1 returns the latest SOL balance and annotation for any Solana account, including batched lookups across many wallets in one request. It is the fastest entry point for wallet directories, portfolio dashboards, accounting bootstraps, and compliance pre-checks — and it pairs naturally with the Solana transfers API when you need full SPL token portfolios or historical balances.

Use cases at a glance​

Latest SOL balance for a single Solana address​

Look up the current SOL balance and annotation for a single Solana address. Run query.

Variations: For SPL token balances, use the transfers API with aggregation. For balance at a specific timestamp or block height, see historical balance. Combine with the multi-address query below for batch lookups.

query MyQuery {
  solana {
    address(address: {is: "AgexL8gWCy62B6z95WqeGFcs5Y8AmiP65Yte4xyvbsfv"}) {
      address
      annotation
      balance
    }
  }
}

Batch multi-wallet SOL balance lookup​

Batch-query SOL balances for multiple Solana addresses in one request using address: {in: [...]}. Returns balance and annotation for each address — ideal for treasury dashboards, partner-program reporting, and exchange wallet sets. Run query.

Variations: Add or remove addresses from the array. Combine with the transfers API for per-token balances across wallets. For bubble-map style aggregation across the same wallets, use the multi-wallet aggregate query in the transfers examples.

query MyQuery {
  solana {
    address(address: {in: ["AgexL8gWCy62B6z95WqeGFcs5Y8AmiP65Yte4xyvbsfv","u4JVgijAL87QWhuig6YNnJCoxgEKbYZt1q3nPbfbUBC","9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"]}) {
      address
      annotation
      balance
    }
  }
}

When to use the Address API vs Transfers​

NeedUse
Latest SOL balance for one or many walletsAddress API (this page)
SPL token balance per wallet/tokenTransfers + amount(calculate: sum)
Balance at a specific timestamp or blockHistorical balance
Sender or receiver activity historyTransfers (sender/receiver filters)
Multi-hop fund flow across addressesCoinpath