Addresses - Ralph Studio

Alephium addresses are base58-encoded strings. Every address belongs to a group (0–3) determined by the address itself. You don’t need to know the group for most queries, the node figures it out.

Get address balance

Returns the current ALPH balance for an address.

curl "https://rpc.ralphstudio.xyz/{slug}/addresses/{address}/balance" \
  -H "Authorization: Bearer API_KEY"

{
  "balance": "1000000000000000000",
  "balanceHint": "1 ALPH",
  "lockedBalance": "0",
  "lockedBalanceHint": "0 ALPH",
  "utxoNum": 1
}

balance and lockedBalance are in attoALPH. Divide by 10^18 to get ALPH. The Hint fields do that for you as a readable string. lockedBalance refers to funds locked by time-lock constraints on UTXOs.

Get address UTXOs

Returns the unspent transaction outputs for an address. Useful when building transactions manually.

curl "https://rpc.ralphstudio.xyz/{slug}/addresses/{address}/utxos" \
  -H "Authorization: Bearer API_KEY"

{
  "utxos": [
    {
      "ref": {
        "hint": 714081,
        "key": "a1b2c3..."
      },
      "output": {
        "type": "AssetOutput",
        "amount": "1000000000000000000",
        "address": "1DrDyTr9...",
        "tokens": [],
        "lockTime": 0,
        "message": ""
      }
    }
  ]
}

Get address group

Returns which shard group an address belongs to.

curl "https://rpc.ralphstudio.xyz/{slug}/addresses/{address}/group" \
  -H "Authorization: Bearer API_KEY"

{
  "group": 0
}

Get token balances

Returns all token balances held by an address alongside the ALPH balance.

curl "https://rpc.ralphstudio.xyz/{slug}/addresses/{address}/tokens-balance" \
  -H "Authorization: Bearer API_KEY"

{
  "balance": "1000000000000000000",
  "balanceHint": "1 ALPH",
  "lockedBalance": "0",
  "lockedBalanceHint": "0 ALPH",
  "tokenBalances": [
    {
      "id": "b2d71c...",
      "amount": "500000000000000000"
    }
  ],
  "lockedTokenBalances": [],
  "utxoNum": 2
}

Get transactions for address

Returns transactions involving an address. This endpoint is paginated.

curl "https://rpc.ralphstudio.xyz/{slug}/addresses/{address}/transactions?page=1&limit=20" \
  -H "Authorization: Bearer API_KEY"

[
  {
    "hash": "503a2c...",
    "blockHash": "00000000ab3c...",
    "timestamp": 1748476800000,
    "inputs": [...],
    "outputs": [...],
    "gasAmount": 20000,
    "gasPrice": "100000000000"
  }
]

Get mempool transactions for address

Returns pending (unconfirmed) transactions for an address.

curl "https://rpc.ralphstudio.xyz/{slug}/addresses/{address}/mempool/transactions" \
  -H "Authorization: Bearer API_KEY"

Check if address is active

Returns whether an address has had any onchain activity.

curl "https://rpc.ralphstudio.xyz/{slug}/addresses/{address}/is-active" \
  -H "Authorization: Bearer API_KEY"

{
  "isActive": true
}

Parameters reference

Parameter	Type	Description
address	string	Base58-encoded Alephium address
page	integer	Page number for paginated results (default: 1)
limit	integer	Results per page (default: 20, max: 100)

​Get address balance

​Get address UTXOs

​Get address group

​Get token balances

​Get transactions for address

​Get mempool transactions for address

​Check if address is active

​Parameters reference