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

balances

object

The balances connection 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

extensions

object

GraphQL response metadata returned by the Fuel node.

current_consensus_parameters_version

integer

The current consensus parameters version

current_fuel_block_height

integer

The current Fuel block height

current_stf_version

integer

The current STF version

Request

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

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

1
const GET_BALANCES_QUERY = `
2
  query Balances($filter: BalanceFilterInput) {
3
    balances(filter: $filter, first: 5) {
4
      nodes {
5
        amount
6
        assetId
7
      }
8
    }
9
  }
10
`;
11

12
const QUERY_VARIABLES = {
13
  filter: {
14
    owner: '0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820',
15
  },
16
};
17

18
const fetch_Balances = async () => {
19
  try {
20
    const response = await fetch('https://docs-demo.fuel-mainnet.quiknode.pro/v1/graphql', {
21
      method: 'POST',
22
      headers: {
23
        'Accept': 'application/json',
24
        'Content-Type': 'application/json',
25
      },
26
      body: JSON.stringify({
27
        query: GET_BALANCES_QUERY,
28
        variables: QUERY_VARIABLES,
29
      }),
30
    });
31

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

36
    const result = await response.json();
37
    console.log('Balances:', result.data.balances.nodes);
38
  } catch (error) {
39
    console.error('Error fetching balances:', error);
40
  }
41
};
42

43
fetch_Balances();
44

1
const GET_BALANCES_QUERY = `
2
  query Balances($filter: BalanceFilterInput) {
3
    balances(filter: $filter, first: 5) {
4
      nodes {
5
        amount
6
        assetId
7
      }
8
    }
9
  }
10
`;
11

12
const QUERY_VARIABLES = {
13
  filter: {
14
    owner: '0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820',
15
  },
16
};
17

18
const fetch_Balances = async () => {
19
  try {
20
    const response = await fetch('https://docs-demo.fuel-mainnet.quiknode.pro/v1/graphql', {
21
      method: 'POST',
22
      headers: {
23
        'Accept': 'application/json',
24
        'Content-Type': 'application/json',
25
      },
26
      body: JSON.stringify({
27
        query: GET_BALANCES_QUERY,
28
        variables: QUERY_VARIABLES,
29
      }),
30
    });
31

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

36
    const result = await response.json();
37
    console.log('Balances:', result.data.balances.nodes);
38
  } catch (error) {
39
    console.error('Error fetching balances:', error);
40
  }
41
};
42

43
fetch_Balances();
44

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

5
const raw = JSON.stringify({
6
  "query": "query Balances($filter: BalanceFilterInput) { balances(filter: $filter, first: 5) { nodes { amount assetId } } }",
7
  "variables": {
8
    "filter": {
9
      "owner": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820"
10
    }
11
  }
12
});
13

14
const requestOptions = {
15
  method: "POST",
16
  headers: myHeaders,
17
  body: raw,
18
  redirect: "follow"
19
};
20

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

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

5
const raw = JSON.stringify({
6
  "query": "query Balances($filter: BalanceFilterInput) { balances(filter: $filter, first: 5) { nodes { amount assetId } } }",
7
  "variables": {
8
    "filter": {
9
      "owner": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820"
10
    }
11
  }
12
});
13

14
const requestOptions = {
15
  method: "POST",
16
  headers: myHeaders,
17
  body: raw,
18
  redirect: "follow"
19
};
20

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

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

4
const client = new ApolloClient({
5
  uri: 'https://docs-demo.fuel-mainnet.quiknode.pro/v1/graphql',
6
  cache: new InMemoryCache(),
7
  fetch: fetch,
8
  headers: {
9
    'Accept': 'application/json',
10
    'Content-Type': 'application/json'
11
  }
12
});
13

14
const BALANCES_QUERY = gql`
15
  query Balances($filter: BalanceFilterInput) {
16
    balances(filter: $filter, first: 5) {
17
      nodes {
18
        amount
19
        assetId
20
      }
21
    }
22
  }
23
`;
24

25
const variables = {
26
  filter: {
27
    owner: "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820"
28
  }
29
};
30

31
client.query({
32
  query: BALANCES_QUERY,
33
  variables: variables
34
})
35
.then(result => {
36
  console.log('Balances:', JSON.stringify(result.data, null, 2));
37
})
38
.catch(error => console.error('Error:', error));

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

4
const client = new ApolloClient({
5
  uri: 'https://docs-demo.fuel-mainnet.quiknode.pro/v1/graphql',
6
  cache: new InMemoryCache(),
7
  fetch: fetch,
8
  headers: {
9
    'Accept': 'application/json',
10
    'Content-Type': 'application/json'
11
  }
12
});
13

14
const BALANCES_QUERY = gql`
15
  query Balances($filter: BalanceFilterInput) {
16
    balances(filter: $filter, first: 5) {
17
      nodes {
18
        amount
19
        assetId
20
      }
21
    }
22
  }
23
`;
24

25
const variables = {
26
  filter: {
27
    owner: "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820"
28
  }
29
};
30

31
client.query({
32
  query: BALANCES_QUERY,
33
  variables: variables
34
})
35
.then(result => {
36
  console.log('Balances:', JSON.stringify(result.data, null, 2));
37
})
38
.catch(error => console.error('Error:', error));

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "query": "query Balances($filter: BalanceFilterInput) { balances(filter: $filter, first: 5) { nodes { amount assetId } } }",
8
  "variables": {
9
    "filter": {
10
      "owner": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820"
11
    }
12
  }
13
})
14
headers = {
15
  'Accept': 'application/json',
16
  'Content-Type': 'application/json'
17
}
18

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

21
print(response.text)
22

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "query": "query Balances($filter: BalanceFilterInput) { balances(filter: $filter, first: 5) { nodes { amount assetId } } }",
8
  "variables": {
9
    "filter": {
10
      "owner": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820"
11
    }
12
  }
13
})
14
headers = {
15
  'Accept': 'application/json',
16
  'Content-Type': 'application/json'
17
}
18

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

21
print(response.text)
22

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

10
request = Net::HTTP::Post.new(url)
11
request["Accept"] = "application/json"
12
request["Content-Type"] = "application/json"
13
request.body = JSON.dump({
14
  "query": "query Balances(\$filter: BalanceFilterInput) { balances(filter: \$filter, first: 5) { nodes { amount assetId } } }",
15
  "variables": {
16
    "filter": {
17
      "owner": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820"
18
    }
19
  }
20
})
21

22
response = https.request(request)
23
puts response.read_body
24

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

10
request = Net::HTTP::Post.new(url)
11
request["Accept"] = "application/json"
12
request["Content-Type"] = "application/json"
13
request.body = JSON.dump({
14
  "query": "query Balances(\$filter: BalanceFilterInput) { balances(filter: \$filter, first: 5) { nodes { amount assetId } } }",
15
  "variables": {
16
    "filter": {
17
      "owner": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820"
18
    }
19
  }
20
})
21

22
response = https.request(request)
23
puts response.read_body
24

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free