Money
The CLI token
Buy hosting credit with the CLI token, stake it to earn credit and perks, and understand how its price is set.
CLI has an optional token on Robinhood Chain. You never need it: cards and USDC work exactly the same. If you hold it, you can buy credit with it for a bonus, or stake it to earn credit and perks for a project.
How to do it: open Stake CLI in the sidebar (it only appears when your CLI server supports the token).
This isn't financial advice: the token's price can fall, and credit you get is for hosting, not money you can withdraw.
CLI has its own token, CLI, on Robinhood Chain. It's optional: USDC and cards work exactly the same without it, and nothing on CLI is locked behind holding it. You can use it two ways: pay for credit with it (and get bonus credit), or stake it to earn credit and perks for a project.
Check whether your server takes CLI
GET /v1/tokenThe answer has the current price, the bonus for paying in CLI, the staking tiers and locks, the perks per tier (benefits) and the contract addresses. If it says "enabled": false, this CLI server doesn't take the token.
Ask your agent:
"Does this CLI server take the CLI token, and what's the bonus for paying with it?"
Buy credit with CLI
Credit bought with CLI is valued at the token's oracle price, plus a bonus for paying in CLI (10% on the default settings).
In the dashboard
- Open the project and go to Usage and credit, then Add credit.
- Under Pay with CLI, enter an amount of CLI and press Quote.
- Check the quote: how much credit it buys, and the least it will buy if the price moves before it's mined.
- Press Approve and buy (or Buy credit if no approval is needed) and confirm in your wallet.
- The credit lands on the project a few blocks after the purchase is mined.
If the price is out of date, the panel says so and purchases are paused until it updates.
With the API
Quote. Ask what an amount of CLI (or of credit) comes to for a project:
APIPOST /v1/token/quoteJSON{ "projectId": "prj_7a2c91e04b5f3d18a6c2", "tokens": "1000", "from": "0x8f3a…c41d" }Use
"usd": 20instead oftokensto ask for an amount of credit.from(your wallet) lets CLI skip an approval you don't need.Read the answer. It has
credit(micro-USDC),minCreditOut, the price used, andtransactionsto send in order: anapprovefor exactly that many tokens if needed, thenbuyCredit(project, tokens, minCreditOut).Send the transactions from the wallet holding the CLI, on Robinhood Chain.
Wait for confirmations. After a few blocks (5 by default) CLI books the credit on the project, raises a
payment_receivedevent, and shows it as "Bought with CLI" in the money flow.
The buyer's minimum
minCreditOut is your protection: 1% below the quoted credit. If the price moves further than that before your purchase is mined, the purchase fails instead of giving you less.
The contract also checks that the price is fresh, and limits purchases to between $1 and $5,000 each and $50,000 a day across everyone.
Stake CLI
Staked CLI earns hosting credit for a project, and unlocks perks for it.
In the dashboard: open Stake CLI from the sidebar. Connect your wallet, choose an amount, a lock and the project the credit goes to (Credit goes to), then press Stake. Your stakes lists each position with its lock, rate, credit per day and credit so far.
With the API:
POST /v1/token/stake-tx{ "action": "stake", "amount": "5000", "lockId": 2, "projectId": "prj_7a2c91e04b5f3d18a6c2" }The answer is the transactions to send from your wallet: an approval if needed, then the stake. The same endpoint builds "unstake" and "setProject" (moving a position's credit to another project) with a positionId.
Locks
| Lock | Multiplier |
|---|---|
| None | 1× |
| 30 days | 1.25× |
| 90 days | 1.5× |
| 180 days | 2× |
| 365 days | 3× |
Tiers and rate
Your tier comes from the total your wallet has staked; each tier has a yearly rate (for example Starter 4%, Builder 8%, Scale 12%, Founding 16%). GET /v1/token gives the live table.
Each position earns:
stake value at the oracle price × tier rate × lock multiplier
For example, $1,000 of CLI at an 8% tier with a 90-day lock earns about $120 of credit a year, or about $0.33 a day.
Credit is counted by the second and paid into the position's project as "Staking credit" every 15 minutes. While the oracle price is stale, payments pause and the time is paid later. No tokens are minted: rewards are credit.
Withdraw
Once a position's lock has ended, press Withdraw on it, or build an unstake transaction. Locked tokens can't be withdrawn early.
Nobody else can move your staked tokens, CLI included.
With the API:
GET /v1/token/stakes/0x8f3a…c41dshows a wallet's positions, tier, the next tier, credit per day and credit paid.
Tier perks
Staking also unlocks perks for the project the stake points at. The perk tier counts everything staked for that project, across its positions.
| Perk | What it does |
|---|---|
| Lower marketplace fee | A smaller fee than the usual 2.5% on what the project sells (see /docs/selling-apis) |
| Priority builds | The project's builds go ahead of the queue when build slots are busy |
| GPU waitlist priority | A better place in line when you ask for GPUs and none are free |
On the default settings, the first tier lowers the fee to 2%, the second to 1.5% and adds priority builds, the third to 1% and adds GPU priority, and the fourth to 0.5%. Each server sets its own perks: GET /v1/token lists them as benefits.
See a project's tier and perks:
GET /v1/projects/:id/benefits{
"tier": "Builder",
"staked": "25000",
"feeBps": 150,
"priorityBuilds": true,
"gpuPriority": false
}The answer also includes the full perk table, the project's place in the GPU waitlist and how many builds are queued.
The price oracle
CLI never uses the pool's spot price, which a single trade can move. Instead:
- Every minute, CLI reads the CLI/ETH pool on Robinhood Chain and the ETH/USD price, and stores a sample.
- Every 10 minutes, or when the price moves 1%, it publishes the median of the last 30 minutes to the oracle contract.
- The contract only accepts a price with at least 10 samples over at least 15 minutes, a minute or more apart, and moving at most 15% from the last one. A bigger real move is reached over several updates.
- A price older than 2 hours is stale: purchases stop and staking payments pause until it updates.
For agents
Agents use the cli_token MCP tool:
| Action | Does |
|---|---|
info | Price, bonus, tiers and locks |
quote | What an amount comes to for a project, with the transactions to send |
stake | The transactions to stake |
stakes | A wallet's positions and the credit they earn |
The tool doesn't send transactions itself: the agent hands them to your wallet, unless it holds a wallet on Robinhood Chain of its own. Agents are told to confirm any purchase with you first, and never to stake for you unless you ask, since staking locks your tokens.
Credit bought or earned with CLI is ordinary credit: the same budgets, caps and approvals apply (see /docs/agent-permissions).