Addresses

Get Address Balance (with optional mempool)

get

Returns total and locked balances for the specified address. If mempool=true, balances will include the effect of unconfirmed transactions.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

addressstringRequired

The address to query.

Example: 12jK2jHyyJTJyuRMRya7QJSojgVnb5yh4HVzNNw6BTBDF

Query parameters

mempoolbooleanOptional

Whether to include unconfirmed (mempool) transactions in the balance calculation.

Default: falseExample: true

Responses

200

Address balance retrieved successfully.

application/json

balancestringOptional

Total balance in atto-ALPH.

Example: 465478842708706554897

balanceHintstringOptional

Readable ALPH balance.

Example: 465.478842708706554897 ALPH

lockedBalancestringOptional

Locked balance in atto-ALPH.

Example: 461357694374776064051

lockedBalanceHintstringOptional

Readable locked balance in ALPH.

Example: 461.357694374776064051 ALPH

utxoNumintegerOptional

Number of unspent outputs for the address.

Example: 2459

400

Invalid address or query parameter.

application/json

404

Address not found.

application/json

500

Internal server error.

application/json

503

ServiceUnavailable

application/json

get/addresses/{address}/balance

HTTPcURLJavaScriptPython

GET /addresses/{address}/balance HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "balance": "465478842708706554897",
  "balanceHint": "465.478842708706554897 ALPH",
  "lockedBalance": "461357694374776064051",
  "lockedBalanceHint": "461.357694374776064051 ALPH",
  "utxoNum": 2459
}

Get UTXOs for Address

get

Returns all unspent outputs (UTXOs) associated with a specific address.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

addressstringRequired

The address whose UTXOs are requested.

Example: 12jK2jHyyJTJyuRMRya7QJSojgVnb5yh4HVzNNw6BTBDF

Responses

200

List of UTXOs retrieved successfully.

application/json

400

Invalid address format.

application/json

404

Address not found or has no UTXOs.

application/json

500

Internal server error.

application/json

503

ServiceUnavailable

application/json

get/addresses/{address}/utxos

HTTPcURLJavaScriptPython

GET /addresses/{address}/utxos HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "utxos": [
    {
      "ref": {
        "hint": -421195643,
        "key": "000cee2f94bbb6c87776016a9c55d2d7e454564f1ce38b7b3ace0ec6399021ec"
      },
      "amount": "191472590469365818",
      "lockTime": 1754924356031,
      "additionalData": "030200"
    }
  ]
}

Get Group Number by Address

get

Returns the group number for the specified address.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

addressstringRequired

The address to query.

Example: 12jK2jHyyJTJyuRMRya7QJSojgVnb5yh4HVzNNw6BTBDF

Responses

200

Group number retrieved successfully.

application/json

groupintegerOptional

The group number associated with the address.

Example: 2

400

Invalid address format.

application/json

404

Address not found.

application/json

500

Internal server error.

application/json

503

ServiceUnavailable

application/json

get/addresses/{address}/group

HTTPcURLJavaScriptPython

GET /addresses/{address}/group HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "group": 2
}