Skip to main content

Algorand Address API

The Address API gives you native ALGO balances for one or many accounts, plus smart contract details — bytecode and source — for application addresses. Use it for wallet dashboards, treasury monitoring, and inspecting on-chain program code without running your own indexer.

Endpoint

Algorand GraphQL queries are served at https://graphql.bitquery.io.

Get ALGO balance for a single address​

Returns the native ALGO balance for one account. Replace the address with your target wallet or contract.

{
  algorand(network: algorand) {
    address(
      address: {is: "ADDRESS_HERE"}
    ) {
      address {
        address
      }
      balance
    }
  }
}

Add a date filter to reconstruct balance context at a point in time, or use the in operator shown below for batch lookups.

Get ALGO balances for multiple addresses​

Pull balances for several addresses in a single request. Handy for portfolio views and treasury snapshots.

{
  algorand(network: algorand) {
    address(address: {in: ["ADDRESS_ONE", "ADDRESS_TWO", "ADDRESS_THREE"]}) {
      address {
        address
      }
      balance
    }
  }
}

Get smart contract bytecode and source​

Returns the bytecode and source of an Algorand application address. Add the balance field to the smartContract block if you also need the contract's ALGO holdings.

{
  algorand(network: algorand) {
    address(address: {is: "SMART_CONTRACT_ADDRESS"}) {
      smartContract {
        address {
          address
        }
        bytecode
        source
      }
    }
  }
}