# Shumi

> Shumi answers crypto market questions with live data: trend, funding, sentiment, narratives and market breadth, across spot markets and perpetual futures on 17 exchanges.

## Where to use Shumi

- [Shumi Web](https://shumi.ai/app): Chat in the browser. The first question on the shumi.ai homepage needs no account.
- Shumi CLI: `npm install -g shumi` (Node 22 or later), then `shumi login`.
- Shumi API: `https://api.shumi.ai`, routes under `/api/cli`. Public manifest at `https://api.shumi.ai/api/cli/manifest`.
- Shumi MCP server: `https://mcp.shumi.ai/mcp` for Claude, Cursor or any MCP client.

## Reference

- [Shumi Docs](https://docs.shumi.ai): How to use Shumi and how to read what it returns.
- [SHUMI Token Verification](https://shumi.ai/token): Official SHUMI metadata reference for reviewers, including the Base contract, SHUMI/VIRTUAL pool, explorer, Virtuals source, website, and X links.

## Start here

- [Overview](https://docs.shumi.ai/): What Shumi is, ways to use it, your first question, plans.

## Using Shumi

- [Shumi Chat](https://docs.shumi.ai/research/shumi-chat): Asking questions on the web, in the terminal, over the API or from an agent.
- [Coin Lookup](https://docs.shumi.ai/research/coin-analysis): One coin by ticker, contract address, id or name, with its current trend, plus stocks and commodities.
- [Market Screener](https://docs.shumi.ai/research/market-screener): Rank the biggest 24h or 7d movers, or filter coins by trend, category and market cap.
- [CoinRotator](https://docs.shumi.ai/coinrotator): The rule-based screener Shumi's answers link to for each coin and for market breadth.

## Reading the data

- [Signals](https://docs.shumi.ai/trade-decisions/signals): The per-coin verdict, its score and its evidence.
- [Market State](https://docs.shumi.ai/research/market-health): Breadth, trend crossings and regime signals.
- [Funding](https://docs.shumi.ai/trade-decisions/funding-momentum): Perp funding by asset, crowding tiers and market temperature.
- [Pairs and Delta Neutral](https://docs.shumi.ai/trade-decisions/pair-trading): Pair suggestions and cross-exchange funding spreads.
- [Sentiment and Narratives](https://docs.shumi.ai/research/sentiment): Crowd sentiment by coin and category, and active narratives.

## Build

- [API Quickstart](https://docs.shumi.ai/quickstart): API key, first API call, MCP setup.
- [API Overview](https://docs.shumi.ai/api-reference/introduction): Auth, the response envelope, errors and quotas.
- [CLI](https://docs.shumi.ai/agents/cli): Commands, flags and machine-readable output.
- [MCP Server](https://docs.shumi.ai/agents/mcp): Hosted and local setup and the tool list.
- [Pay Per Call](https://docs.shumi.ai/agents/payments): Paying per API call in USDC on Base.

## Reference pages

- [Plans and Quotas](https://docs.shumi.ai/platform/access): Plans, the free question counter, what happens when you run out.
- [Coverage](https://docs.shumi.ai/platform/coverage): Exchanges, assets and how fresh each data type is.
- [Evidence](https://docs.shumi.ai/evidence/studies): Published studies and how to check the walk-forward record yourself.
- [FAQ](https://docs.shumi.ai/platform/faq): Short answers to common questions.
- [Changelog](https://docs.shumi.ai/platform/changelog): What changed and when.