getAddressAssetBalance Query

Parameters

address

string

REQUIRED

The unique identifier representing an address

assetId

string

REQUIRED

The unique identifier of an asset

Returns

data

object

The outer object that holds the query result

balance

object

The object that contains the balance information

owner

string

The blockchain address whose balance is being queried

amount

string

The balance amount for the specified asset

assetId

string

The unique identifier of the asset

Request

curl --location 'https://docs-demo.fuel-mainnet.quiknode.pro/v1/graphql' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "query": "query Balance($address: Address, $assetId: AssetId) { balance(owner: $address, assetId: $assetId) { owner amount assetId } }",
    "variables": {
      "address": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
      "assetId": "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
    }
  }'

const BALANCE_QUERY = `
  query Balance($address: Address, $assetId: AssetId) {
    balance(owner: $address, assetId: $assetId) {
      owner
      amount
      assetId
    }
  }
`;

const BALANCE_VARS = {
  address: '0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820',
  assetId: '0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea',
};

const fetchBalance = async () => {
  try {
    const response = await fetch('https://docs-demo.fuel-mainnet.quiknode.pro/v1/graphql', {
      method: 'POST',
      headers: {
        'Accept': 'application/json',
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        query: BALANCE_QUERY,
        variables: BALANCE_VARS,
      }),
    });

    const data = await response.json();
    console.log(data);
  } catch (error) {
    console.error('Error fetching balance:', error);
  }
};

fetchBalance();

const myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "query": "query Balance($address: Address, $assetId: AssetId) { balance(owner: $address, assetId: $assetId) { owner amount assetId } }",
  "variables": {
    "address": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
    "assetId": "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
  }
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://docs-demo.fuel-mainnet.quiknode.pro/v1/graphql", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

const { ApolloClient, InMemoryCache, gql } = require('@apollo/client/core');
const fetch = require('cross-fetch');

const client = new ApolloClient({
  uri: 'https://docs-demo.fuel-mainnet.quiknode.pro/v1/graphql',
  cache: new InMemoryCache(),
  fetch: fetch,
  headers: {
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  }
});

const BALANCE_QUERY = gql`
  query Balance($address: Address, $assetId: AssetId) {
    balance(owner: $address, assetId: $assetId) {
      owner
      amount
      assetId
    }
  }
`;

const variables = {
  address: "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
  assetId: "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
};

client.query({
  query: BALANCE_QUERY,
  variables: variables
})
.then(result => {
  console.log(JSON.stringify(result.data, null, 2));
})
.catch(error => console.error('Error:', error));

import requests
import json

url = "https://docs-demo.fuel-mainnet.quiknode.pro/v1/graphql"

payload = json.dumps({
  "query": "query Balance($address: Address, $assetId: AssetId) { balance(owner: $address, assetId: $assetId) { owner amount assetId } }",
  "variables": {
    "address": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
    "assetId": "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
  }
})
headers = {
  'Accept': 'application/json',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.fuel-mainnet.quiknode.pro/v1/graphql")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "query": "query Balance(\$address: Address, \$assetId: AssetId) { balance(owner: \$address, assetId: \$assetId) { owner amount assetId } }",
  "variables": {
    "address": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
    "assetId": "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
  }
})

response = https.request(request)
puts response.read_body

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free