Parameters

addresses

array of strings

REQUIRED

A list of addresses.

limit

integer

The limit of UTXOs to return. If limit is omitted or greater than 1024, it is set to 1024.

startIndex

object

If startIndex is omitted, it will fetch all UTXOs up to a limit. When using pagination (i.e when startIndex is provided), UTXOs are not guaranteed to be unique across multiple calls. That is, a UTXO may appear in the result of the first call, and then again in the second call.

address

string

The address to start the search from.

Returns

numFetched

string

Number of UTXOs fetched.

utxos

array

A list of UTXOs.

endIndex

object

Denotes the last UTXO returned. To get the next set of UTXOs, use the value of endIndex as startIndex in the next call.

address

string

The address at the end index.

utxo

string

The UTXO at the end index.

encoding

string

The encoding format used for the returned UTXOs.

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": "avax.getUTXOs",
7
  "params": {
8
    "addresses": [
9
      "C-avax1uqsts4n6j0fwmdhu4p8acmjksemtqu7vedhdks"
10
    ],
11
    "sourceChain": "X",
12
    "limit": 5,
13
    "encoding": "hex"
14
  }
15
}'
16

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": "avax.getUTXOs",
7
  "params": {
8
    "addresses": [
9
      "C-avax1uqsts4n6j0fwmdhu4p8acmjksemtqu7vedhdks"
10
    ],
11
    "sourceChain": "X",
12
    "limit": 5,
13
    "encoding": "hex"
14
  }
15
}'
16

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
    "addresses": ["C-avax1uqsts4n6j0fwmdhu4p8acmjksemtqu7vedhdks"],
9
    "sourceChain": "X",
10
    "limit": 5,
11
    "encoding": "cb58",
12
  };
13
  const result = await provider.send("avax.getUTXOs", params);
14
  console.log(result);
15
})();
16

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
    "addresses": ["C-avax1uqsts4n6j0fwmdhu4p8acmjksemtqu7vedhdks"],
9
    "sourceChain": "X",
10
    "limit": 5,
11
    "encoding": "cb58",
12
  };
13
  const result = await provider.send("avax.getUTXOs", params);
14
  console.log(result);
15
})();
16

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.avalanche-mainnet.quiknode.pro'))
3
params = {
4
    "addresses": [
5
    "C-avax1uqsts4n6j0fwmdhu4p8acmjksemtqu7vedhdks"
6
    ],
7
    "sourceChain": "X",
8
    "limit": 5,
9
    "encoding": "hex"
10
}
11
request = w3.provider.make_request('avax.getUTXOs', [params])
12
print(request)
13

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.avalanche-mainnet.quiknode.pro'))
3
params = {
4
    "addresses": [
5
    "C-avax1uqsts4n6j0fwmdhu4p8acmjksemtqu7vedhdks"
6
    ],
7
    "sourceChain": "X",
8
    "limit": 5,
9
    "encoding": "hex"
10
}
11
request = w3.provider.make_request('avax.getUTXOs', [params])
12
print(request)
13

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free