List UTXOs

Lists UTXOs on one of the Primary Network chains for the supplied addresses.

Authorizations

x-glacier-api-key

string

headerrequired

Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://avacloud.io/.

Path Parameters

blockchainId

enum<string>

required

A primary network blockchain id or alias.

Available options:

11111111111111111111111111111111LpoYY,

2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM,

2JVSBoinj9C2J33VntvzYtVJNZdN2NKiwwKjcumHUWEb5DbBrm,

2piQ2AVHCjnduiWXsSY15DtbVuwHE2cwMHYnEXHsLL73BBkdbV,

2q9e4r6Mu3U68nU1fYjgbR6JvwrRx36CohpAX5UQxse55x1Q5,

yH8D7ThNJkxmtkuv2jgBa4P1Rn3Qpr4pPr7QYNfcdoS6k6HWp,

vV3cui1DsEPC3nLCGH9rorwo8s6BYxM2Hz4QFE5gEYjwTqAu,

p-chain,

x-chain,

c-chain

network

enum<string>

required

Either mainnet or testnet/fuji.

Available options:

mainnet,

fuji,

testnet,

devnet

Query Parameters

addresses

string

A comma separated list of X-Chain or P-Chain wallet addresses, starting with "avax"/"fuji", "P-avax"/"P-fuji" or "X-avax"/"X-fuji".

pageToken

string

A page token, received from a previous list call. Provide this to retrieve the subsequent page.

pageSize

integer

default: 10

The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.

Required range: 1 < x < 100

assetId

string

Asset ID for any asset (only applicable X-Chain)

includeSpent

boolean

Boolean filter to include spent UTXOs.

sortOrder

enum<string>

The order by which to sort results. Use "asc" for ascending order, "desc" for descending order. Sorted by timestamp or the sortBy query parameter, if provided.

Available options:

asc,

desc

Response

200 - application/json

• Option 1
• Option 2

utxos

object[]

required

Show child attributes

utxos.addresses

string[]

required

Addresses that are eligible to sign the consumption of this output.

utxos.asset

object

required

Show child attributes

utxos.asset.assetId

string

required

Unique ID for an asset.

utxos.asset.name

string

required

Name of this asset.

utxos.asset.symbol

string

required

Symbol for this asset (max 4 characters).

utxos.asset.denomination

number

required

Denomination of this asset to represent fungibility.

utxos.asset.type

enum<string>

required

Type of asset like SECP256K1 or NFT.

Available options:

secp256k1,

nft

utxos.asset.amount

string

required

Amount of the asset.

utxos.consumedOnChainId

string

required

Blockchain ID on which this output is consumed on.

utxos.consumingTxHash

string

Transaction ID that consumed this output.

utxos.createdOnChainId

string

required

Blockchain ID on which this output is created on.

utxos.utxoId

string

required

UTXO ID for this output.

utxos.amount

string

requireddeprecated

utxos.assetId

string

requireddeprecated

utxos.blockNumber

string

required

utxos.blockTimestamp

number

required

utxos.consumingBlockNumber

string

utxos.consumingBlockTimestamp

number

utxos.platformLocktime

number

utxos.outputIndex

number

required

utxos.rewardType

enum<string>

Available options:

VALIDATOR,

DELEGATOR,

VALIDATOR_FEE

utxos.stakeableLocktime

number

utxos.staked

boolean

utxos.threshold

number

utxos.txHash

string

required

utxos.utxoEndTimestamp

number

utxos.utxoStartTimestamp

number

utxos.utxoType

enum<string>

required

Available options:

STAKE,

TRANSFER

chainInfo

object

required

Show child attributes

chainInfo.chainName

enum<string>

required

Available options:

p-chain,

x-chain,

c-chain

chainInfo.network

enum<string>

required

Available options:

mainnet,

fuji,

testnet,

devnet

nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.