Sign in

v1

latestOpenAPI 3.1.02026-07-1288262495.0 KB
Primary Network Balances

Get 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.

get/v1/networks/{network}/blockchains/{blockchainId}/balances

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

blockTimestampinteger

An epoch timestamp in seconds. Balance will be calculated at this timestamp.

addressesstring

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".

Response

Successful response

OR
OR

Example response

{
  "balances": {
    "unlockedUnstaked": [
      {
        "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
        "name": "Avalanche",
        "symbol": "AVAX",
        "denomination": 9,
        "amount": "5001000",
        "utxoCount": 1
      }
    ],
    "unlockedStaked": [
      {
        "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
        "name": "Avalanche",
        "symbol": "AVAX",
        "denomination": 9,
        "amount": "5001000",
        "utxoCount": 1
      }
    ],
    "lockedPlatform": [
      {
        "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
        "name": "Avalanche",
        "symbol": "AVAX",
        "denomination": 9,
        "amount": "5001000",
        "utxoCount": 1
      }
    ],
    "lockedStakeable": [
      {
        "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
        "name": "Avalanche",
        "symbol": "AVAX",
        "denomination": 9,
        "amount": "5001000",
        "utxoCount": 1
      }
    ],
    "lockedStaked": [
      {
        "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
        "name": "Avalanche",
        "symbol": "AVAX",
        "denomination": 9,
        "amount": "5001000",
        "utxoCount": 1
      }
    ],
    "pendingStaked": [
      {
        "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
        "name": "Avalanche",
        "symbol": "AVAX",
        "denomination": 9,
        "amount": "5001000",
        "utxoCount": 1
      }
    ],
    "atomicMemoryUnlocked": [
      {
        "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
        "name": "Avalanche",
        "symbol": "AVAX",
        "denomination": 9,
        "amount": "5001000",
        "utxoCount": 1,
        "sharedWithChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM"
      }
    ],
    "atomicMemoryLocked": [
      {
        "assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
        "name": "Avalanche",
        "symbol": "AVAX",
        "denomination": 9,
        "amount": "5001000",
        "utxoCount": 1,
        "sharedWithChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM"
      }
    ]
  }
}