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.
Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://build.avax.network/console/utilities/data-api-keys.
In: header
Path Parameters
A primary network blockchain id or alias.
"11111111111111111111111111111111LpoYY" | "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM" | "2JVSBoinj9C2J33VntvzYtVJNZdN2NKiwwKjcumHUWEb5DbBrm" | "2q9e4r6Mu3U68nU1fYjgbR6JvwrRx36CohpAX5UQxse55x1Q5" | "yH8D7ThNJkxmtkuv2jgBa4P1Rn3Qpr4pPr7QYNfcdoS6k6HWp" | "p-chain" | "x-chain" | "c-chain"Either mainnet or testnet/fuji.
"mainnet" | "fuji" | "testnet"Query Parameters
An epoch timestamp in seconds. Balance will be calculated at this timestamp.
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 Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://data-api.avax.network/v1/networks/mainnet/blockchains/p-chain/balances?blockTimestamp=1599696000&addresses=avax1h2ccj9f5ay5acl6tyn9mwmw32p8wref8vl8ctg"{
"balances": {
"unlockedUnstaked": [
{
"assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
"name": "Avalanche",
"symbol": "AVAX",
"denomination": 9,
"type": "secp256k1",
"amount": "5001000",
"utxoCount": 1
}
],
"unlockedStaked": [
{
"assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
"name": "Avalanche",
"symbol": "AVAX",
"denomination": 9,
"type": "secp256k1",
"amount": "5001000",
"utxoCount": 1
}
],
"lockedPlatform": [
{
"assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
"name": "Avalanche",
"symbol": "AVAX",
"denomination": 9,
"type": "secp256k1",
"amount": "5001000",
"utxoCount": 1
}
],
"lockedStakeable": [
{
"assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
"name": "Avalanche",
"symbol": "AVAX",
"denomination": 9,
"type": "secp256k1",
"amount": "5001000",
"utxoCount": 1
}
],
"lockedStaked": [
{
"assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
"name": "Avalanche",
"symbol": "AVAX",
"denomination": 9,
"type": "secp256k1",
"amount": "5001000",
"utxoCount": 1
}
],
"pendingStaked": [
{
"assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
"name": "Avalanche",
"symbol": "AVAX",
"denomination": 9,
"type": "secp256k1",
"amount": "5001000",
"utxoCount": 1
}
],
"atomicMemoryUnlocked": [
{
"assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
"name": "Avalanche",
"symbol": "AVAX",
"denomination": 9,
"type": "secp256k1",
"amount": "5001000",
"utxoCount": 1,
"sharedWithChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
"status": "string"
}
],
"atomicMemoryLocked": [
{
"assetId": "th5aLdWLi32yS9ED6uLGoMMubqHjzMsXhKWwzP6yZTYQKYzof",
"name": "Avalanche",
"symbol": "AVAX",
"denomination": 9,
"type": "secp256k1",
"amount": "5001000",
"utxoCount": 1,
"sharedWithChainId": "2oYMBNV4eNHyqk2fjjV5nVQLDbtmNJzq5s3qs3Lo6ftnC6FByM",
"status": "string"
}
]
},
"chainInfo": {
"chainName": "p-chain",
"network": "mainnet"
}
}{
"message": "string",
"statusCode": 400,
"error": "Bad Request"
}{
"message": "string",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "string",
"statusCode": 403,
"error": "Forbidden"
}{
"message": "string",
"statusCode": 404,
"error": "Not Found"
}{
"message": "string",
"statusCode": 429,
"error": "Too Many Requests"
}{
"message": "string",
"statusCode": 500,
"error": "Internal Server Error"
}{
"message": "string",
"statusCode": 502,
"error": "Bad Gateway"
}{
"message": "string",
"statusCode": 503,
"error": "Service Unavailable"
}Is this guide helpful?