DOCS/EXAMPLES/BALANCES

Query Address Balances

Learn how to fetch multi-currency balances for any Verus address.

GraphQL Query

query GetAddressBalances($chainId: String!, $address: String!) {
  addressBalances(chainId: $chainId, address: $address) {
    address
    balances {
      currencyId
      currencyName
      balance
      totalReceived
      totalSent
      utxoCount
    }
  }
}

Variables

{
  "chainId": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
  "address": "RXL3YXG2ceaB6C5hfJcN4fvmLH2C34knhA"
}

JavaScript Example

const response = await fetch('https://api.chainvue.io/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    query: `
      query GetAddressBalances($chainId: String!, $address: String!) {
        addressBalances(chainId: $chainId, address: $address) {
          address
          balances {
            currencyId
            currencyName
            balance
          }
        }
      }
    `,
    variables: {
      chainId: 'iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq',
      address: 'RXL3YXG2ceaB6C5hfJcN4fvmLH2C34knhA',
    },
  }),
});

const { data } = await response.json();
console.log(data.addressBalances.balances);

Python Example

import requests

query = """
query GetAddressBalances($chainId: String!, $address: String!) {
  addressBalances(chainId: $chainId, address: $address) {
    balances {
      currencyName
      balance
    }
  }
}
"""

response = requests.post(
    'https://api.chainvue.io/graphql',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_API_KEY',
    },
    json={
        'query': query,
        'variables': {
            'chainId': 'iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq',
            'address': 'RXL3YXG2ceaB6C5hfJcN4fvmLH2C34knhA',
        },
    },
)

data = response.json()
for balance in data['data']['addressBalances']['balances']:
    print(f"{balance['currencyName']}: {balance['balance']}")

Example Response

{
  "data": {
    "addressBalances": {
      "address": "RXL3YXG2ceaB6C5hfJcN4fvmLH2C34knhA",
      "balances": [
        {
          "currencyId": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
          "currencyName": "VRSCTEST",
          "balance": "1250.50000000",
          "totalReceived": "5000.00000000",
          "totalSent": "3749.50000000",
          "utxoCount": 3
        },
        {
          "currencyId": "iBridge...",
          "currencyName": "Bridge.vETH",
          "balance": "0.15000000",
          "totalReceived": "0.15000000",
          "totalSent": "0.00000000",
          "utxoCount": 1
        }
      ]
    }
  }
}