---
title: "Get balances"
method: GET
path: "/v1/networks/{network}/blockchains/{blockchainId}/balances"
tags: ["Primary Network Balances"]
---

# Get balances

`GET /v1/networks/{network}/blockchains/{blockchainId}/balances`

Gets primary network balances for one of the Primary Network chains for the supplied addresses.

C-Chain balances returned are only the shared atomic memory balance. For EVM balance, use the `/v1/chains/:chainId/addresses/:addressId/balances:getNative` endpoint.

## Path parameters

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

## Query parameters

- `blockTimestamp` integer
- `addresses` string

## Response `200`

Successful response

- union
  - ListPChainBalancesResponse
    - `balances` PChainBalance, required
      - `unlockedUnstaked` AggregatedAssetAmount[], required — A list of objects containing P-chain Asset basic info, amount, and utxo count of that Asset ID. Denotes the amount of unstaked Avax that is consumable by any transaction.
        - `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.
        - `utxoCount` number, required
      - `unlockedStaked` AggregatedAssetAmount[], required — A list of objects containing P-chain Asset basic info, amount, and utxo count of that Asset ID. Denotes the amount of staked Avax that is consumable by any transaction when the staking period ends.
        - `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.
        - `utxoCount` number, required
      - `lockedPlatform` AggregatedAssetAmount[], required — A list of objects containing P-chain Asset basic info, amount, and utxo count of that Asset ID. Denotes the amount of unstaked Avax that is locked at the platform level and not consumable by any transaction at the current time.
        - `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.
        - `utxoCount` number, required
      - `lockedStakeable` AggregatedAssetAmount[], required — A list of objects containing P-chain Asset basic info, amount, and utxo count of that Asset ID. Denotes the amount of unstaked Avax that is locked at the platform level and only consumeable for staking transactions.
        - `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.
        - `utxoCount` number, required
      - `lockedStaked` AggregatedAssetAmount[], required — A list of objects containing P-chain Asset basic info, amount, and utxo count of that Asset ID. Denotes the amount of staked Avax that will be locked when the staking period ends.
        - `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.
        - `utxoCount` number, required
      - `pendingStaked` AggregatedAssetAmount[], required — A list of objects containing P-chain Asset basic info, amount, and utxo count of that Asset ID. Denotes the amount of staked Avax whose staking period has not yet started.
        - `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.
        - `utxoCount` number, required
      - `restakedRewards` string — Total AVAX (in nAVAX) restaked into auto-renewed validators via compounding. These rewards are bonded into validator weight and have no UTXO until the validator exits, so they are reported here as a separate amount (always AVAX). Add to unlockedStaked/lockedStaked for an auto-renewed validator's full current staked value. Current-balance queries only. The field is OMITTED for historical queries, i.e. when blockTimestamp is supplied with a value greater than 0, because compounding history is not reconstructable from current-state data. Absence therefore means "not available for this timestamp" — it does not mean nothing was compounded. A current-balance query for an address with no auto-renewed position returns "0". Note blockTimestamp=0 is treated as "no timestamp supplied" and is answered as a current-balance query.
      - `atomicMemoryUnlocked` PChainSharedAsset[], required — A list of objects containing P-chain Asset basic info, amount and utxo count of that Asset ID. Denotes the amount of unlocked Avax in the atomic memory between P-Chain and other chain.
        - `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.
        - `utxoCount` number, required
        - `sharedWithChainId` string, required
        - `status` string, required
      - `atomicMemoryLocked` PChainSharedAsset[], required — A list of objects containing P-chain Asset basic info, amount and utxo count of that Asset ID. Denotes the amount of locked Avax in the atomic memory between P-Chain and other chain.
        - `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.
        - `utxoCount` number, required
        - `sharedWithChainId` string, required
        - `status` string, required
    - `chainInfo` PrimaryNetworkChainInfo, required
      - `chainName` 'p-chain' | 'x-chain' | 'c-chain', required
      - `network` 'mainnet' | 'fuji' | 'testnet', required
  - ListXChainBalancesResponse
    - `balances` XChainBalances, required
      - `locked` AggregatedAssetAmount[], required — A list of objects containing X-chain Asset balance information.
        - `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.
        - `utxoCount` number, required
      - `unlocked` AggregatedAssetAmount[], required — A list of objects containing X-chain Asset balance information.
        - `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.
        - `utxoCount` number, required
      - `atomicMemoryUnlocked` XChainSharedAssetBalance[], 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.
        - `utxoCount` number, required
        - `sharedWithChainId` string, required
      - `atomicMemoryLocked` XChainSharedAssetBalance[], 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.
        - `utxoCount` number, required
        - `sharedWithChainId` string, required
    - `chainInfo` PrimaryNetworkChainInfo, required
      - `chainName` 'p-chain' | 'x-chain' | 'c-chain', required
      - `network` 'mainnet' | 'fuji' | 'testnet', required
  - ListCChainAtomicBalancesResponse
    - `balances` CChainAtomicBalances, required
      - `atomicMemoryUnlocked` CChainSharedAssetBalance[], 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.
        - `utxoCount` number, required
        - `sharedWithChainId` string, required
      - `atomicMemoryLocked` CChainSharedAssetBalance[], 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.
        - `utxoCount` number, required
        - `sharedWithChainId` string, required
    - `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.

## Changes

- **2026-08-08** `745a94fa47f5` — 1 info
  - added the optional property `oneOf[#/components/schemas/ListPChainBalancesResponse]/balances/restakedRewards` to the response with the `200` status

[Change history](https://skmtc.dev/avax/apis/data-api/changes/v1/networks/:network/blockchains/:blockchainId/balances/get.md)

---

[API](https://skmtc.dev/avax/apis/data-api.md) · [All operations](https://skmtc.dev/avax/apis/data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/avax/data-api/revisions/86448a21e2b1/schema)