Sign in

v1

latestOpenAPI 3.1.02026-07-1288262495.0 KB
Primary Network UTXOs

List UTXOs v2 - Supports querying for more addresses

Lists UTXOs on one of the Primary Network chains for the supplied addresses. This v2 route supports increased page size and address limit.

post/v1/networks/{network}/blockchains/{blockchainId}/utxos

Path parameters

blockchainId'11111111111111111111111111111111LpoYY' | '2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM' | '2JVSBoinj9C2J33VntvzYtVJNZdN2NKiwwKjcumHUWEb5DbBrm' | '2q9e4r6Mu3U68nU1fYjgbR6JvwrRx36CohpAX5UQxse55x1Q5' | 'yH8D7ThNJkxmtkuv2jgBa4P1Rn3Qpr4pPr7QYNfcdoS6k6HWp' | 'p-chain' | 'x-chain' | 'c-chain' required

A primary network blockchain id or alias.

network'mainnet' | 'fuji' | 'testnet' required

Either mainnet or testnet/fuji.

Query parameters

pageTokenstring

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

pageSizeinteger

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

assetIdstring

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

minUtxoAmountnumber

The minimum UTXO amount in nAVAX (inclusive), used to filter the set of UTXOs being returned. Default is 0.

includeSpentboolean

Boolean filter to include spent UTXOs.

sortBy'timestamp' | 'amount'

Which property to sort by, in conjunction with sortOrder.

sortOrder'asc' | 'desc'

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.

Request body

addressesstring required

Comma-separated list of primary network addresses

Example request

{
  "addresses": "P-avax1abc123,X-avax1def456,C-avax1ghi789"
}

Response

Successful response

OR

Example response

{
  "utxos": [
    {
      "addresses": [
        "avax1qm2a25eytsrj235hxg6jc0mwk99tss64eqevsw"
      ],
      "asset": {
        "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
        "name": "Avalanche",
        "symbol": "AVAX",
        "denomination": 9,
        "amount": "5001000"
      },
      "consumedOnChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
      "consumingTxHash": "3j9JpF1aGuQtLLbo3YkvvKkWrCZViXZjdeJQWUSEY5hcqUn2c",
      "createdOnChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
      "utxoId": "68vLva9kfKUsX88ZPM8jdbf8qHUZRoZSFH6NdpAVTspkfrXDC"
    }
  ]
}