> For the complete documentation index, see [llms.txt](https://docs.byreal.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.byreal.io/byreal-agent-stack/realclaw/credits.md).

# Credits

Credits (CR) are the usage units that power your RealClaw. Every message you send and every action your agent takes consumes Credits.

## Your Free Credits

Every new RealClaw comes with **2,000 Credits** at no cost — no payment required. Your free trial ends when either condition is met first:

* Your 2,000 CR balance is used up, or
* 14 days have passed since you created your RealClaw

Your Credits balance is always visible in the [Console](https://www.byreal.io/en/realclaw/console).

{% hint style="danger" %}
**When Credits reach zero, your agent stops.** Active strategies are no longer managed. Top up to resume.
{% endhint %}

## How Credits Are Used

| Action                         | Approximate Cost     |
| ------------------------------ | -------------------- |
| Each message or agent response | \~2 CR               |
| Strategy execution             | Varies by complexity |
| Monitoring checks              | Minimal              |

Usage varies depending on how many steps your agent takes to complete a task. Complex multi-step strategies consume more Credits than simple queries.

## Topping Up

You can top up your Credits at any time from the [RealClaw Console](https://www.byreal.io/en/realclaw/console). Payments are made in **USDC on Solana**.

{% stepper %}
{% step %}

### Go to the Console

Go to the [Console](https://www.byreal.io/en/realclaw/console) and click **Top Up**.
{% endstep %}

{% step %}

### Select an amount

Select an amount or enter a custom value.

| Amount        | Credits       |
| ------------- | ------------- |
| $5            | 1,500 CR      |
| $10           | 3,000 CR      |
| $20           | 6,000 CR      |
| $50           | 15,000 CR     |
| Custom        | 300 CR per $1 |
| {% endstep %} |               |

{% step %}

### Review and confirm

Review the confirmation — amount, Credits to be added, and source wallet — then confirm.
{% endstep %}

{% step %}

### Credits are added

Credits are added to your balance immediately once the transaction is confirmed on-chain.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Make sure your wallet has sufficient USDC on Solana before topping up.** If your balance is insufficient, the transaction will not proceed.
{% endhint %}

## Rescue Credits

If your Credits run out, you can claim a one-time **Rescue allocation of 200 CR** for free — no payment needed. This is designed to give you enough runway to close active strategies or complete a final action before topping up.

To claim your Rescue Credits, go to the [Console](https://www.byreal.io/en/realclaw/console) when your balance reaches zero.

* Rescue is available **once per account**
* No wallet balance required to claim

## Key Rules

* **Credits do not expire.** Any Credits you top up accumulate and carry over indefinitely.
* **Nothing is charged without your confirmation.** Every top-up requires you to review and confirm the transaction before any USDC leaves your wallet.
* **Byreal does not hold your funds.** Payments go directly from your Privy wallet on-chain. Your USDC stays in your wallet until the moment you confirm a top-up.
