Parameters

address

string

REQUIRED

The owner of the asset.

assetID

string

REQUIRED

The ID of the asset for which the balance is requested.

Returns

balance

string

The balance given the address and assetID.

utxoIDs

array

An array of UTXO IDs (if applicable).

txID

string

The transaction ID of the UTXO.

outputIndex

integer

The output index of the UTXO.

Request

1
curl --location --request POST https://docs-demo.avalanche-mainnet.quiknode.pro \
2
--header 'Content-Type: application/json' \
3
--data-raw '{
4
  "jsonrpc": "2.0",
5
  "id": 1,
6
  "method": "avm.getBalance",
7
  "params": {
8
    "address": "X-avax1pue5luvh6klhjkq8zk5zltxk84asvcnznsauxa",
9
    "assetID": "2pYGetDWyKdHxpFxh2LHeoLNCH6H5vxxCxHQtFnnFaYxLsqtHC"
10
  }
11
}'

1
curl --location --request POST https://docs-demo.avalanche-mainnet.quiknode.pro \
2
--header 'Content-Type: application/json' \
3
--data-raw '{
4
  "jsonrpc": "2.0",
5
  "id": 1,
6
  "method": "avm.getBalance",
7
  "params": {
8
    "address": "X-avax1pue5luvh6klhjkq8zk5zltxk84asvcnznsauxa",
9
    "assetID": "2pYGetDWyKdHxpFxh2LHeoLNCH6H5vxxCxHQtFnnFaYxLsqtHC"
10
  }
11
}'

1
import { ethers } from "ethers";
2

3
(async () => {
4
  const provider = new ethers.JsonRpcProvider(
5
    "https://docs-demo.avalanche-mainnet.quiknode.pro"
6
  );
7
  const params = {
8
    "address": "X-avax1pue5luvh6klhjkq8zk5zltxk84asvcnznsauxa",
9
    "assetID": "2pYGetDWyKdHxpFxh2LHeoLNCH6H5vxxCxHQtFnnFaYxLsqtHC",
10
  };
11
  const result = await provider.send("avm.getBalance", params);
12
  console.log(result);
13
})();
14

1
import { ethers } from "ethers";
2

3
(async () => {
4
  const provider = new ethers.JsonRpcProvider(
5
    "https://docs-demo.avalanche-mainnet.quiknode.pro"
6
  );
7
  const params = {
8
    "address": "X-avax1pue5luvh6klhjkq8zk5zltxk84asvcnznsauxa",
9
    "assetID": "2pYGetDWyKdHxpFxh2LHeoLNCH6H5vxxCxHQtFnnFaYxLsqtHC",
10
  };
11
  const result = await provider.send("avm.getBalance", params);
12
  console.log(result);
13
})();
14

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.avalanche-mainnet.quiknode.pro'))
3
params = {
4
    "address": "X-avax1pue5luvh6klhjkq8zk5zltxk84asvcnznsauxa",
5
    "assetID": "2pYGetDWyKdHxpFxh2LHeoLNCH6H5vxxCxHQtFnnFaYxLsqtHC"
6
}
7
request = w3.provider.make_request('avm.getBalance', [params])
8
print(request)
9

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.avalanche-mainnet.quiknode.pro'))
3
params = {
4
    "address": "X-avax1pue5luvh6klhjkq8zk5zltxk84asvcnznsauxa",
5
    "assetID": "2pYGetDWyKdHxpFxh2LHeoLNCH6H5vxxCxHQtFnnFaYxLsqtHC"
6
}
7
request = w3.provider.make_request('avm.getBalance', [params])
8
print(request)
9

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free