# Your block rewards

`GET /wallet/rewards` · Lithos client API · Wallet · requires the `api_key` header

Source: https://lithosprotocol.org/docs/api/get-wallet-reward-summary

Coinbase reward boxes held by this wallet: how many are still behind the 720-block timelock, how many are spendable now, and the ERG totals.

## Responses

### 200: Reward box counts and totals

`WalletRewardSummary`

- `boxes` (integer · int32, required): Reward boxes held, including ones still behind the timelock
- `unlockedBoxes` (integer · int32, required): How many are spendable now
- `totalNanoErgs` (string, required): Every reward box together. Decimal string.
- `unlockedNanoErgs` (string, required): The part past its timelock. Decimal string.
- `blocksUntilFirstUnlock` (integer · int32): Blocks until the earliest still-locked box matures. Absent when none are locked.

### 403: Missing or wrong api_key

`ApiError`

- `error` (integer, required): Error code
- `reason` (string, required): Error message explaining the reason of the error
- `detail` (string, required): Detailed error description

### 503: Node or wallet unavailable. Retry.

`ApiError`

- `error` (integer, required): Error code
- `reason` (string, required): Error message explaining the reason of the error
- `detail` (string, required): Detailed error description

### default: Error

`ApiError`

- `error` (integer, required): Error code
- `reason` (string, required): Error message explaining the reason of the error
- `detail` (string, required): Detailed error description

## Example request

```bash
curl -X GET "http://localhost:9000/wallet/rewards" \
  -H "api_key: $LITHOS_API_KEY"
```

## Example response

```json
{
  "boxes": 4,
  "unlockedBoxes": 2,
  "totalNanoErgs": "12000000000",
  "unlockedNanoErgs": "6000000000",
  "blocksUntilFirstUnlock": 0
}
```