Parameters

contract

string

REQUIRED

The contract address for which the balance is to be fetched

asset

string

REQUIRED

The unique identifier of an asset

Returns

data

object

The data object which contains the following fields:

contractBalance

object

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

contract

string

The ID of the contract

amount

string

The balance amount of the asset in the contract

assetId

string

The unique identifier of the asset associated with the contract

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 ContractBalance($contract: ContractId, $asset: AssetId) { contractBalance(contract: $contract, asset: $asset) { contract amount assetId } }",
6
    "variables": {
7
        "contract": "0x7777777777777777777777777777777777777777777777777777777777777777",
8
        "asset": "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
9
    }
10
}'

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 ContractBalance($contract: ContractId, $asset: AssetId) { contractBalance(contract: $contract, asset: $asset) { contract amount assetId } }",
6
    "variables": {
7
        "contract": "0x7777777777777777777777777777777777777777777777777777777777777777",
8
        "asset": "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
9
    }
10
}'

1
const CONTRACT_BALANCE_QUERY = `
2
  query ContractBalance($contract: ContractId, $asset: AssetId) {
3
    contractBalance(contract: $contract, asset: $asset) {
4
      contract
5
      amount
6
      assetId
7
    }
8
  }
9
`;
10

11
const QUERY_VARIABLE = {
12
  contract: '0x7777777777777777777777777777777777777777777777777777777777777777',
13
  asset: '0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea',
14
};
15

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

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

34
    const result = await response.json();
35
    console.log('Contract Balance:', result.data.contractBalance);
36
  } catch (error) {
37
    console.error('Error fetching contract balance:', error);
38
  }
39
};
40

41
fetchContractBalance();
42

1
const CONTRACT_BALANCE_QUERY = `
2
  query ContractBalance($contract: ContractId, $asset: AssetId) {
3
    contractBalance(contract: $contract, asset: $asset) {
4
      contract
5
      amount
6
      assetId
7
    }
8
  }
9
`;
10

11
const QUERY_VARIABLE = {
12
  contract: '0x7777777777777777777777777777777777777777777777777777777777777777',
13
  asset: '0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea',
14
};
15

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

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

34
    const result = await response.json();
35
    console.log('Contract Balance:', result.data.contractBalance);
36
  } catch (error) {
37
    console.error('Error fetching contract balance:', error);
38
  }
39
};
40

41
fetchContractBalance();
42

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 ContractBalance($contract: ContractId, $asset: AssetId) { contractBalance(contract: $contract, asset: $asset) { contract amount assetId } }",
7
  "variables": {
8
    "contract": "0x7777777777777777777777777777777777777777777777777777777777777777",
9
    "asset": "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
10
  }
11
});
12

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

20
fetch("https://docs-demo.fuel-mainnet.quiknode.pro/v1/graphql", requestOptions)
21
  .then((response) => response.text())
22
  .then((result) => console.log(result))
23
  .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 ContractBalance($contract: ContractId, $asset: AssetId) { contractBalance(contract: $contract, asset: $asset) { contract amount assetId } }",
7
  "variables": {
8
    "contract": "0x7777777777777777777777777777777777777777777777777777777777777777",
9
    "asset": "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
10
  }
11
});
12

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

20
fetch("https://docs-demo.fuel-mainnet.quiknode.pro/v1/graphql", requestOptions)
21
  .then((response) => response.text())
22
  .then((result) => console.log(result))
23
  .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_BALANCE_QUERY = gql`
15
  query ContractBalance($contract: ContractId, $asset: AssetId) {
16
    contractBalance(contract: $contract, asset: $asset) {
17
      contract
18
      amount
19
      assetId
20
    }
21
  }
22
`;
23

24
const variables = {
25
  contract: "0x7777777777777777777777777777777777777777777777777777777777777777",
26
  asset: "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
27
};
28

29
client.query({
30
  query: CONTRACT_BALANCE_QUERY,
31
  variables: variables
32
})
33
.then(result => {
34
  const balance = result.data.contractBalance;
35
  console.log('Contract Balance Information:');
36
  console.log(`Contract: ${balance.contract}`);
37
  console.log(`Amount: ${balance.amount}`);
38
  console.log(`Asset ID: ${balance.assetId}`);
39
})
40
.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_BALANCE_QUERY = gql`
15
  query ContractBalance($contract: ContractId, $asset: AssetId) {
16
    contractBalance(contract: $contract, asset: $asset) {
17
      contract
18
      amount
19
      assetId
20
    }
21
  }
22
`;
23

24
const variables = {
25
  contract: "0x7777777777777777777777777777777777777777777777777777777777777777",
26
  asset: "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
27
};
28

29
client.query({
30
  query: CONTRACT_BALANCE_QUERY,
31
  variables: variables
32
})
33
.then(result => {
34
  const balance = result.data.contractBalance;
35
  console.log('Contract Balance Information:');
36
  console.log(`Contract: ${balance.contract}`);
37
  console.log(`Amount: ${balance.amount}`);
38
  console.log(`Asset ID: ${balance.assetId}`);
39
})
40
.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 ContractBalance($contract: ContractId, $asset: AssetId) { contractBalance(contract: $contract, asset: $asset) { contract amount assetId } }",
8
  "variables": {
9
    "contract": "0x7777777777777777777777777777777777777777777777777777777777777777",
10
    "asset": "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
11
  }
12
})
13
headers = {
14
  'Accept': 'application/json',
15
  'Content-Type': 'application/json'
16
}
17

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

20
print(response.text)
21

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 ContractBalance($contract: ContractId, $asset: AssetId) { contractBalance(contract: $contract, asset: $asset) { contract amount assetId } }",
8
  "variables": {
9
    "contract": "0x7777777777777777777777777777777777777777777777777777777777777777",
10
    "asset": "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
11
  }
12
})
13
headers = {
14
  'Accept': 'application/json',
15
  'Content-Type': 'application/json'
16
}
17

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

20
print(response.text)
21

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 ContractBalance(\$contract: ContractId, \$asset: AssetId) { contractBalance(contract: \$contract, asset: \$asset) { contract amount assetId } }",
15
  "variables": {
16
    "contract": "0x7777777777777777777777777777777777777777777777777777777777777777",
17
    "asset": "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
18
  }
19
})
20

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

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 ContractBalance(\$contract: ContractId, \$asset: AssetId) { contractBalance(contract: \$contract, asset: \$asset) { contract amount assetId } }",
15
  "variables": {
16
    "contract": "0x7777777777777777777777777777777777777777777777777777777777777777",
17
    "asset": "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
18
  }
19
})
20

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

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free