---
title: "List UTXOs v2 - Supports querying for more addresses"
method: POST
path: "/v1/networks/{network}/blockchains/{blockchainId}/utxos"
tags: ["Primary Network UTXOs"]
---

# List UTXOs v2 - Supports querying for more addresses

`POST /v1/networks/{network}/blockchains/{blockchainId}/utxos`

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

## Path parameters

- `blockchainId` '11111111111111111111111111111111LpoYY' | '2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM' | '2JVSBoinj9C2J33VntvzYtVJNZdN2NKiwwKjcumHUWEb5DbBrm' | '2q9e4r6Mu3U68nU1fYjgbR6JvwrRx36CohpAX5UQxse55x1Q5' | 'yH8D7ThNJkxmtkuv2jgBa4P1Rn3Qpr4pPr7QYNfcdoS6k6HWp' | 'p-chain' | 'x-chain' | 'c-chain', required
- `network` 'mainnet' | 'fuji' | 'testnet', required

## Query parameters

- `pageToken` string
- `pageSize` integer
- `assetId` string
- `minUtxoAmount` number
- `includeSpent` boolean
- `sortBy` 'timestamp' | 'amount'
- `sortOrder` 'asc' | 'desc'

## Request body

- PrimaryNetworkAddressesBodyDto
  - `addresses` string, required — Comma-separated list of primary network addresses

## Response `200`

Successful response

- union
  - ListPChainUtxosResponse
    - `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.
    - `utxos` PChainUtxo[], required
      - `addresses` string[], required — Addresses that are eligible to sign the consumption of this output.
      - `asset` AssetAmount, required
        - `assetId` string, required — Unique ID for an asset.
        - `name` string, required — Name of this asset.
        - `symbol` string, required — Symbol for this asset (max 4 characters).
        - `denomination` number, required — Denomination of this asset to represent fungibility.
        - `type` 'secp256k1' | 'nft', required — Type of asset like SECP256K1 or NFT.
        - `amount` string, required — Amount of the asset.
      - `consumedOnChainId` string, required — Blockchain ID on which this output is consumed on.
      - `consumingTxHash` string — Transaction ID that consumed this output.
      - `createdOnChainId` string, required — Blockchain ID on which this output is created on.
      - `utxoId` string, required — UTXO ID for this output.
      - `utxoBytes` string — The bytes of the UTXO
      - `amount` string, required
      - `assetId` string, required
      - `blockNumber` string, required
      - `blockTimestamp` number, required
      - `consumingBlockNumber` string — Block height in which the transaction consuming this UTXO was included
      - `consumingBlockTimestamp` number — Timestamp in seconds at which this UTXO is used in a consuming transaction
      - `platformLocktime` number — Timestamp in seconds after which this UTXO can be consumed
      - `outputIndex` number, required — The index of the UTXO in the transaction
      - `rewardType` 'VALIDATOR' | 'DELEGATOR' | 'VALIDATOR_FEE'
      - `stakeableLocktime` number — Timestamp in seconds before which a UTXO can only be used for staking transactions. After stakeable locktime, a UTXO can be used for anything
      - `staked` boolean
      - `threshold` number — The minimum number of signatures required to spend this UTXO
      - `txHash` string, required — The hash of the transaction that created this UTXO
      - `utxoEndTimestamp` number — Timestamp in seconds after which the staked UTXO will be unlocked.
      - `utxoStartTimestamp` number — Timestamp in seconds at which the staked UTXO was locked.
      - `utxoType` 'STAKE' | 'TRANSFER', required — Indicates whether the UTXO is staked or transferable
    - `chainInfo` PrimaryNetworkChainInfo, required
      - `chainName` 'p-chain' | 'x-chain' | 'c-chain', required
      - `network` 'mainnet' | 'fuji' | 'testnet', required
  - ListUtxosResponse
    - `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.
    - `utxos` Utxo[], required
      - `addresses` string[], required — Addresses that are eligible to sign the consumption of this output.
      - `asset` AssetAmount, required
        - `assetId` string, required — Unique ID for an asset.
        - `name` string, required — Name of this asset.
        - `symbol` string, required — Symbol for this asset (max 4 characters).
        - `denomination` number, required — Denomination of this asset to represent fungibility.
        - `type` 'secp256k1' | 'nft', required — Type of asset like SECP256K1 or NFT.
        - `amount` string, required — Amount of the asset.
      - `consumedOnChainId` string, required — Blockchain ID on which this output is consumed on.
      - `consumingTxHash` string — Transaction ID that consumed this output.
      - `createdOnChainId` string, required — Blockchain ID on which this output is created on.
      - `utxoId` string, required — UTXO ID for this output.
      - `utxoBytes` string — The bytes of the UTXO
      - `consumingTxTimestamp` number — Unix timestamp in seconds at which this output was consumed.
      - `creationTxHash` string, required — Transaction ID that created this output.
      - `credentials` UtxoCredential[] — Credentials that signed the transaction to consume this utxo
        - `signature` string — Signature provided to consume the output.
        - `publicKey` string — Public key associated with the signature.
      - `groupId` number — Index representing the minting set for the NFT mint output.
      - `locktime` number, required — Locktime in seconds after which this output can be consumed.
      - `outputIndex` string, required — Postion of this output in a list of lexiographically sorted outputs of a transaction.
      - `payload` string — Hex encoded data for NFT assets.
      - `threshold` number, required — Minimum number of signatures required to consume this output.
      - `timestamp` number, required — Unix timestamp in seconds at which this outptut was created.
      - `utxoType` string, required — Type of output.
    - `chainInfo` PrimaryNetworkChainInfo, required
      - `chainName` 'p-chain' | 'x-chain' | 'c-chain', required
      - `network` 'mainnet' | 'fuji' | 'testnet', required

## Other responses

- `400` — Bad requests generally mean the client has passed invalid or malformed parameters. Error messages in the response could help in evaluating the error.
- `401` — When a client attempts to access resources that require authorization credentials but the client lacks proper authentication in the request, the server responds with 401.
- `403` — When a client attempts to access resources with valid credentials but doesn't have the privilege to perform that action, the server responds with 403.
- `404` — The error is mostly returned when the client requests with either mistyped URL, or the passed resource is moved or deleted, or the resource doesn't exist.
- `429` — This error is returned when the client has sent too many, and has hit the rate limit.
- `500` — The error is a generic server side error that is returned for any uncaught and unexpected issues on the server side. This should be very rare, and you may reach out to us if the problem persists for a longer duration.
- `502` — This is an internal error indicating invalid response received by the client-facing proxy or gateway from the upstream server.
- `503` — The error is returned for certain routes on a particular Subnet. This indicates an internal problem with our Subnet node, and may not necessarily mean the Subnet is down or affected.

---

[API](https://skmtc.net/avax/apis/data-api.md) · [All operations](https://skmtc.net/avax/apis/data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avax/data-api/versions/745a94fa47f5/schema)