> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ralphstudio.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Addresses

> Query balances, UTXOs, and transactions for any Alephium address.

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.

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

```json theme={null}
{
  "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.

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

```json theme={null}
{
  "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.

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

```json theme={null}
{
  "group": 0
}
```

## Get token balances

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

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

```json theme={null}
{
  "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.

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

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

## Get mempool transactions for address

Returns pending (unconfirmed) transactions for an address.

```bash theme={null}
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.

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

```json theme={null}
{
  "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)       |