listAddressAssetBalances Query

Parameters

filter

object

REQUIRED

The filter object used to query balances

owner

string

REQUIRED

The owner whose balance is to be fetched

Returns

data

object

The outer object that holds the query result

balance

object

An object that holds the queried balance information for the requested owner

nodes

array

An array containing individual balance records, each representing a different asset

amount

string

The balance amount of the specific asset

assetId

string

The unique identifier (address or ID) of the asset type associated with the balance

Request

curl --location 'https://docs-demo.fuel-mainnet.quiknode.pro/v1/graphql' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "query": "query Balances($filter: BalanceFilterInput) { balances(filter: $filter, first: 5) { nodes { amount assetId } } }",
    "variables": {
      "filter": {
        "owner": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820"
      }
    }
  }'

const GET_BALANCES_QUERY = `
  query Balances($filter: BalanceFilterInput) {
    balances(filter: $filter, first: 5) {
      nodes {
        amount
        assetId
      }
    }
  }
`;

const QUERY_VARIABLES = {
  filter: {
    owner: '0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820',
  },
};

const fetch_Balances = 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: GET_BALANCES_QUERY,
        variables: QUERY_VARIABLES,
      }),
    });

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

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

fetch_Balances();

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

const raw = JSON.stringify({
  "query": "query Balances($filter: BalanceFilterInput) { balances(filter: $filter, first: 5) { nodes { amount assetId } } }",
  "variables": {
    "filter": {
      "owner": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820"
    }
  }
});

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 BALANCES_QUERY = gql`
  query Balances($filter: BalanceFilterInput) {
    balances(filter: $filter, first: 5) {
      nodes {
        amount
        assetId
      }
    }
  }
`;

const variables = {
  filter: {
    owner: "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820"
  }
};

client.query({
  query: BALANCES_QUERY,
  variables: variables
})
.then(result => {
  console.log('Balances:', 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 Balances($filter: BalanceFilterInput) { balances(filter: $filter, first: 5) { nodes { amount assetId } } }",
  "variables": {
    "filter": {
      "owner": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820"
    }
  }
})
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 Balances(\$filter: BalanceFilterInput) { balances(filter: \$filter, first: 5) { nodes { amount assetId } } }",
  "variables": {
    "filter": {
      "owner": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820"
    }
  }
})

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