avm.getUtxOs RPC Method

Parameters

addresses

array of strings

REQUIRED

A list of UTXOs such that each UTXO references at least one address in the list of addresses.

limit

integer

The limit of UTXOs to return. If the 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 the limit. When using pagination (i.e when startIndex is provided), UTXOs are not guaranteed to be unique across multiple calls. A UTXO may appear in the result of the first call, and then again in the second call.

address

string

The address at the start index

utxo

string

The utxo at the start index

sourceChain

string

The ID or alias of the chain the asset is being imported from.

encoding

string

The format for the returned UTXOs. Can only be hex when a value is provided. Defaults to hex.

Returns

numFetched

Int

Number of UTXOs fetched.

utxos

array of strings

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 start index

utxo

string

The UTXO at the start index

Request

curl --location --request POST https://docs-demo.avalanche-mainnet.quiknode.pro/ext/bc/C/rpc/ext/bc/X \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc":"2.0",
    "id"     :1,
    "method" :"avm.getUTXOs",
    "params" :{
        "addresses":["X-avax16902ur8dhlyxpaa0rva5fx48fhptx6ryh3dv7q"],
        "limit": 5,
        "sourceChain": "X",
        "encoding": "hex"
    }
}'

import { ethers } from "ethers";

(async () => {
  const provider = new ethers.JsonRpcProvider(
    "https://docs-demo.avalanche-mainnet.quiknode.pro/ext/bc/C/rpc/ext/bc/X"
  );
  const params = {
    "addresses": ["X-avax16902ur8dhlyxpaa0rva5fx48fhptx6ryh3dv7q"],
    "limit": 5,
    "sourceChain": "X",
    "encoding": "hex",
  };
  const result = await provider.send("avm.getUTXOs", params);
  console.log(result);
})();

from web3 import Web3, HTTPProvider
w3 = Web3(HTTPProvider('https://docs-demo.avalanche-mainnet.quiknode.pro/ext/bc/C/rpc/ext/bc/X'))
params = {
        "addresses":["X-avax16902ur8dhlyxpaa0rva5fx48fhptx6ryh3dv7q"],
        "limit": 5,
        "sourceChain": "X",
        "encoding": "hex"
}
request = w3.provider.make_request('avm.getUTXOs', [params])
print(request)

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free