Parameters

filter

object

REQUIRED

The filter object used to query balances

contract

string

REQUIRED

The contract address whose asset balances is to be fetched

Returns

data

object

The data object which contains the following fields:

contractBalances

object

The object containing details about the contract's balance for a specific asset

nodes

array

An array of balance records for different assets

amount

string

The balance amount of the specified asset in the contract

assetId

string

The unique identifier of the asset 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 ContractBalances($filter: ContractBalanceFilterInput!) { contractBalances(filter: $filter, first: 5) { nodes { amount assetId } } }",
6
  "variables": {
7
    "filter": {
8
      "contract": "0x7777777777777777777777777777777777777777777777777777777777777777"
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 ContractBalances($filter: ContractBalanceFilterInput!) { contractBalances(filter: $filter, first: 5) { nodes { amount assetId } } }",
6
  "variables": {
7
    "filter": {
8
      "contract": "0x7777777777777777777777777777777777777777777777777777777777777777"
9
    }
10
  }
11
}'

1
const CONTRACT_BALANCES_QUERY = `
2
  query ContractBalances($filter: ContractBalanceFilterInput!) {
3
    contractBalances(filter: $filter, first: 5) {
4
      nodes {
5
        amount
6
        assetId
7
      }
8
    }
9
  }
10
`;
11

12
const CONTRACT_FILTER = {
13
  filter: {
14
    contract: '0x7777777777777777777777777777777777777777777777777777777777777777',
15
  },
16
};
17

18
const fetchContractBalances = 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: CONTRACT_BALANCES_QUERY,
28
        variables: CONTRACT_FILTER,
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('Contract Balances:', result.data.contractBalances.nodes);
38
  } catch (error) {
39
    console.error('Error fetching contract balances:', error);
40
  }
41
};
42

43
fetchContractBalances();
44

1
const CONTRACT_BALANCES_QUERY = `
2
  query ContractBalances($filter: ContractBalanceFilterInput!) {
3
    contractBalances(filter: $filter, first: 5) {
4
      nodes {
5
        amount
6
        assetId
7
      }
8
    }
9
  }
10
`;
11

12
const CONTRACT_FILTER = {
13
  filter: {
14
    contract: '0x7777777777777777777777777777777777777777777777777777777777777777',
15
  },
16
};
17

18
const fetchContractBalances = 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: CONTRACT_BALANCES_QUERY,
28
        variables: CONTRACT_FILTER,
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('Contract Balances:', result.data.contractBalances.nodes);
38
  } catch (error) {
39
    console.error('Error fetching contract balances:', error);
40
  }
41
};
42

43
fetchContractBalances();
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 ContractBalances($filter: ContractBalanceFilterInput!) { contractBalances(filter: $filter, first: 5) { nodes { amount assetId } } }",
7
  "variables": {
8
    "filter": {
9
      "contract": "0x7777777777777777777777777777777777777777777777777777777777777777"
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 ContractBalances($filter: ContractBalanceFilterInput!) { contractBalances(filter: $filter, first: 5) { nodes { amount assetId } } }",
7
  "variables": {
8
    "filter": {
9
      "contract": "0x7777777777777777777777777777777777777777777777777777777777777777"
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 CONTRACT_BALANCES_QUERY = gql`
15
  query ContractBalances($filter: ContractBalanceFilterInput!) {
16
    contractBalances(filter: $filter, first: 5) {
17
      nodes {
18
        amount
19
        assetId
20
      }
21
    }
22
  }
23
`;
24

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

31
client.query({
32
  query: CONTRACT_BALANCES_QUERY,
33
  variables: variables
34
})
35
.then(result => {
36
  console.log('Contract 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 CONTRACT_BALANCES_QUERY = gql`
15
  query ContractBalances($filter: ContractBalanceFilterInput!) {
16
    contractBalances(filter: $filter, first: 5) {
17
      nodes {
18
        amount
19
        assetId
20
      }
21
    }
22
  }
23
`;
24

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

31
client.query({
32
  query: CONTRACT_BALANCES_QUERY,
33
  variables: variables
34
})
35
.then(result => {
36
  console.log('Contract 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 ContractBalances($filter: ContractBalanceFilterInput!) { contractBalances(filter: $filter, first: 5) { nodes { amount assetId } } }",
8
  "variables": {
9
    "filter": {
10
      "contract": "0x7777777777777777777777777777777777777777777777777777777777777777"
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 ContractBalances($filter: ContractBalanceFilterInput!) { contractBalances(filter: $filter, first: 5) { nodes { amount assetId } } }",
8
  "variables": {
9
    "filter": {
10
      "contract": "0x7777777777777777777777777777777777777777777777777777777777777777"
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 ContractBalances(\$filter: ContractBalanceFilterInput\!) { contractBalances(filter: \$filter, first: 5) { nodes { amount assetId } } }",
15
  "variables": {
16
    "filter": {
17
      "contract": "0x7777777777777777777777777777777777777777777777777777777777777777"
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 ContractBalances(\$filter: ContractBalanceFilterInput\!) { contractBalances(filter: \$filter, first: 5) { nodes { amount assetId } } }",
15
  "variables": {
16
    "filter": {
17
      "contract": "0x7777777777777777777777777777777777777777777777777777777777777777"
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