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

# Shumi plans, pricing and question quotas

> What each plan gives you, how the free counter works, and what you see when it runs out.

Pick a plan, see how many questions it gives you, and check what you have left. Every question you ask Shumi uses one question from your plan.

## Plans

| Plan | Price | Questions |
| - | - | - |
| Free | Free | 10 to start, then 1 per day |
| Plus | \$20 / month | 50 per day, one budget shared by the web chat, the CLI and the API |
| Pro | \$200 / month | No limit |
| Genesis | \$500 once | Same as Pro, for life |

On Plus, a web question uses one of the 50, and so does a CLI or API call when it writes a fresh AI answer or reading. Never counted on Plus: `coin risk`, `market health`, `market prices`, `funding momentum` and `scan`.

Compare and buy plans at [shumi.ai/pricing](https://shumi.ai/pricing).

## Free counter

A free account starts with 10 questions. They never refill. When they are gone you get 1 question per day, and the day resets at 00:00 UTC.

On the web you can ask one question with no account, on each device. After that the page asks you to sign in. Email or a crypto wallet both work.

On the free plan, every data call from the terminal, the API or an AI agent takes one question from the same counter. `shumi billing tier` never counts.

## Out of questions

| Where | What happens |
| - | - |
| Web chat | "You've used your 10 free queries. Upgrade to keep going." Once the daily question is spent: "You've used today's 1 query. Resets at 00:00 UTC." A **See plans →** button sits under the message. |
| Terminal, API, AI agent | The call answers `402 Payment Required` with an offer to pay for that one call in USDC. Live streams (`shumi watch`) run while you have questions left. Once the quota is spent they answer `429 RATE_LIMITED` instead, and a stream cannot be paid per call. |

## Check your plan

```bash theme={"dark"}
shumi billing tier
```

Over the API, call `GET https://api.shumi.ai/api/cli/billing/tier` with your Bearer token. The call is free and works when your quota is spent.

```json theme={"dark"}
{ "schemaVersion": 1, "data": { "tier": "pro", "source": "manual", "expiresAt": null }, "meta": { "route": "billing/tier" } }
```

In `data`, `tier` is your plan (Plus shows as `access`), `source` is how you got it, and `expiresAt` is when it ends. `null` means no end date.

## Pay per call

No subscription needed. [Fund a wallet](https://shumi.mintlify.site/agents/payments.md#set-up-a-wallet) with USDC on Base (`shumi wallet create`, then `shumi wallet fund`) and each call pays for itself: 0.005 USDC for a data call, 0.05 for a plain-word question, `pairs` or `walkforward`. A call that fails on our side is not charged. `--auto-pay` pays without a prompt, up to \$0.10 per call by default.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.