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

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 Balance($address: Address, $assetId: AssetId) { balance(owner: $address, assetId: $assetId) { owner amount assetId } }",
6
    "variables": {
7
      "address": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
8
      "assetId": "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 Balance($address: Address, $assetId: AssetId) { balance(owner: $address, assetId: $assetId) { owner amount assetId } }",
6
    "variables": {
7
      "address": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
8
      "assetId": "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
9
    }
10
  }'

1
const BALANCE_QUERY = `
2
  query Balance($address: Address, $assetId: AssetId) {
3
    balance(owner: $address, assetId: $assetId) {
4
      owner
5
      amount
6
      assetId
7
    }
8
  }
9
`;
10

11
const BALANCE_VARS = {
12
  address: '0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820',
13
  assetId: '0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea',
14
};
15

16
const fetchBalance = 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: BALANCE_QUERY,
26
        variables: BALANCE_VARS,
27
      }),
28
    });
29

30
    const data = await response.json();
31
    console.log(data);
32
  } catch (error) {
33
    console.error('Error fetching balance:', error);
34
  }
35
};
36

37
fetchBalance();

1
const BALANCE_QUERY = `
2
  query Balance($address: Address, $assetId: AssetId) {
3
    balance(owner: $address, assetId: $assetId) {
4
      owner
5
      amount
6
      assetId
7
    }
8
  }
9
`;
10

11
const BALANCE_VARS = {
12
  address: '0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820',
13
  assetId: '0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea',
14
};
15

16
const fetchBalance = 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: BALANCE_QUERY,
26
        variables: BALANCE_VARS,
27
      }),
28
    });
29

30
    const data = await response.json();
31
    console.log(data);
32
  } catch (error) {
33
    console.error('Error fetching balance:', error);
34
  }
35
};
36

37
fetchBalance();

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 Balance($address: Address, $assetId: AssetId) { balance(owner: $address, assetId: $assetId) { owner amount assetId } }",
7
  "variables": {
8
    "address": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
9
    "assetId": "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 Balance($address: Address, $assetId: AssetId) { balance(owner: $address, assetId: $assetId) { owner amount assetId } }",
7
  "variables": {
8
    "address": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
9
    "assetId": "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 BALANCE_QUERY = gql`
15
  query Balance($address: Address, $assetId: AssetId) {
16
    balance(owner: $address, assetId: $assetId) {
17
      owner
18
      amount
19
      assetId
20
    }
21
  }
22
`;
23

24
const variables = {
25
  address: "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
26
  assetId: "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
27
};
28

29
client.query({
30
  query: BALANCE_QUERY,
31
  variables: variables
32
})
33
.then(result => {
34
  console.log(JSON.stringify(result.data, null, 2));
35
})
36
.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 BALANCE_QUERY = gql`
15
  query Balance($address: Address, $assetId: AssetId) {
16
    balance(owner: $address, assetId: $assetId) {
17
      owner
18
      amount
19
      assetId
20
    }
21
  }
22
`;
23

24
const variables = {
25
  address: "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
26
  assetId: "0x2a0d0ed9d2217ec7f32dcd9a1902ce2a66d68437aeff84e3a3cc8bebee0d2eea"
27
};
28

29
client.query({
30
  query: BALANCE_QUERY,
31
  variables: variables
32
})
33
.then(result => {
34
  console.log(JSON.stringify(result.data, null, 2));
35
})
36
.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 Balance($address: Address, $assetId: AssetId) { balance(owner: $address, assetId: $assetId) { owner amount assetId } }",
8
  "variables": {
9
    "address": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
10
    "assetId": "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 Balance($address: Address, $assetId: AssetId) { balance(owner: $address, assetId: $assetId) { owner amount assetId } }",
8
  "variables": {
9
    "address": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
10
    "assetId": "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 Balance(\$address: Address, \$assetId: AssetId) { balance(owner: \$address, assetId: \$assetId) { owner amount assetId } }",
15
  "variables": {
16
    "address": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
17
    "assetId": "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 Balance(\$address: Address, \$assetId: AssetId) { balance(owner: \$address, assetId: \$assetId) { owner amount assetId } }",
15
  "variables": {
16
    "address": "0xce9f8d9367fc4671c0ececce7ab603f6f75d1e66082a82ad12ecdc219b308820",
17
    "assetId": "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