Balance

Get an account balance

post

Returns the balance of an ICRC-1 ledger account.

Body

network_identifierobjectoptional

account_identifierobjectoptional

block_identifierobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://icrc-mainnet.icp.validationcloud.io/v1/<YOUR_API_KEY_HERE>/account/balance' \
  --header 'Content-Type: application/json' \
  --data '{
    "network_identifier": {
      "blockchain": "Internet Computer",
      "network": "mxzaz-hqaaa-aaaar-qaada-cai",
      "sub_network_identifier": {
        "network": "text",
        "metadata": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      }
    },
    "account_identifier": {
      "address": "text",
      "sub_account": {
        "address": "text",
        "metadata": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      },
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    },
    "block_identifier": {
      "index": null,
      "hash": "text"
    }
  }'

200

400

500

200

{
  "block_identifier": {
    "index": 1,
    "hash": "text"
  },
  "balances": [
    {
      "value": "text",
      "currency": {
        "symbol": "text",
        "decimals": 1,
        "metadata": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      },
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Successful account balance response