Balance

Get the balance of an address

GEThttps://alephium.nownodes.io/addresses/{address}/balance

Path parameters

address*string (address)

Query parameters

Response

200400401404500503

Format 1: 1000000000000000000

Format 2: x.y ALPH, where `1 ALPH = 1000000000000000000

Field fromPublicKeyType can be default or bip340-schnorr

Body

application/json

balance*string (uint256)

balanceHint*string (x.x ALPH)

lockedBalance*string (uint256)

lockedBalanceHint*string (x.x ALPH)

tokenBalancesarray of Token

lockedTokenBalancesarray of Token

utxoNum*integer (int32)

Request

JavaScriptCurlPython

const response = await fetch('https://alephium.nownodes.io/addresses/{address}/balance', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401404500503

{
  "balance": "text",
  "balanceHint": "text",
  "lockedBalance": "text",
  "lockedBalanceHint": "text",
  "tokenBalances": [
    {
      "id": "text",
      "amount": "text"
    }
  ],
  "lockedTokenBalances": [
    {
      "id": "text",
      "amount": "text"
    }
  ],
  "utxoNum": 0
}