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

# Overview

> What Shumi is, where to use it, and how to get your first answer.

Shumi answers questions about crypto markets using live data: trend, funding, sentiment, narratives and market breadth. It covers spot markets and perpetual futures on 17 exchanges, led by Binance, Hyperliquid, Bitget, OKX and Bybit, plus the perp DEXes Aster, Variational and Lighter. See [full coverage](/platform/coverage).

## Ways to use Shumi

<CardGroup cols={2}>
  <Card title="Web" icon="globe" href="https://shumi.ai/app">
    Ask on the shumi.ai homepage, or use the full chat at shumi.ai/app. Your first question needs no account.
  </Card>

  <Card title="Terminal" icon="terminal" href="/agents/cli">
    `npm install -g shumi`, then `shumi login`. Needs Node 22 or later.
  </Card>

  <Card title="HTTP API" icon="code" href="/api-reference/introduction">
    Keys come from the CLI: install it, run `shumi login`, then `shumi keys create`. Then call `https://api.shumi.ai`.
  </Card>

  <Card title="AI agent" icon="plug" href="/agents/mcp">
    Add `https://mcp.shumi.ai/mcp` as a connector in your MCP client.
  </Card>
</CardGroup>

Every one of these reads the same data, so you get the same numbers wherever you ask.

## Ask your first question

<Tabs>
  <Tab title="On the web">
    <Steps>
      <Step title="Open shumi.ai">
        Go to [shumi.ai](https://shumi.ai). You can ask your first question without an account.
      </Step>

      <Step title="Type a question and send it">
        Type in the **Ask a market question** box, for example "is BTC funding crowded?", and click **Run query**. Shumi fetches the data and writes the answer.
      </Step>

      <Step title="Continue in the full app">
        Under the answer, click **Continue in app** (or **Open app** next to the box). On [shumi.ai/app](https://shumi.ai/app), sign in with your email or a crypto wallet. A free account gets 10 questions, then 1 per day.
      </Step>
    </Steps>
  </Tab>

  <Tab title="In the terminal">
    <Steps>
      <Step title="Install the Shumi CLI">
        Needs Node 22 or later.

        ```bash theme={"dark"}
        npm install -g shumi
        ```
      </Step>

      <Step title="Sign in">
        ```bash theme={"dark"}
        shumi login
        ```
      </Step>

      <Step title="Get Shumi's verdict on a coin">
        ```bash theme={"dark"}
        shumi BTC
        ```

        You get a verdict from bullish to bearish, the evidence behind it and a confidence level. It is scored from trend, funding and sentiment.
      </Step>

      <Step title="Ask a question in plain words">
        ```bash theme={"dark"}
        shumi ask "is BTC funding crowded?"
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

To use Shumi from your own code or an AI agent, see the [API Quickstart](/quickstart).

## Terminal commands to try

| You want to know | Command | Read more |
| - | - | - |
| What is Shumi's verdict on this coin? | `shumi signal SOL` | [Signals](/trade-decisions/signals) |
| How many coins are trending up, sideways or down? | `shumi market health` | [Market State](/research/market-health) |
| Where is funding crowded? | `shumi funding momentum` | [Funding](/trade-decisions/funding-momentum) |
| Which coins match my filters? | `shumi scan` | [Market Screener](/research/market-screener) |
| Which pairs could I trade against each other? | `shumi pairs suggestions` | [Pairs and Delta Neutral](/trade-decisions/pair-trading) |
| Anything else, in plain words | `shumi ask "…"` | [Shumi Chat](/research/shumi-chat) |

On the web, ask any of these as a normal question.

## Plans

<Tabs>
  <Tab title="Subscription">
    | Plan | Price | What you get |
    | - | - | - |
    | Free | Free | 10 questions to start, then 1 per day |
    | Plus | \$20 / month | 50 per day in the web chat |
    | Pro | \$200 / month | No limit |
    | Genesis | \$500 once | Same as Pro, for life |

    On the free plan, each terminal or API command also counts as one question. The daily question resets at 00:00 UTC. The first 10 never refill.
  </Tab>

  <Tab title="Pay per call">
    No subscription needed. Fund a wallet with USDC on Base, and each API call pays for itself: 0.005 USDC for a data call, 0.05 for a question, `pairs` or `walkforward`. A call that fails on our side is not charged. [Pay Per Call](/agents/payments) has the setup.
  </Tab>
</Tabs>

[Plans and Quotas](/platform/access) has the details.

## Check the data and the method

<Columns cols={2}>
  <Card title="How fresh is the data?" icon="clock" href="/platform/coverage#how-fresh-the-data-is">
    Most responses show their age: `shumi signal BTC --agent | jq .meta.data_age_seconds`. Check it before you act on a funding rate or a price. Coverage lists the refresh schedule.
  </Card>

  <Card title="Does the method work?" icon="chart-line" href="/evidence/studies">
    The studies publish every tracked outcome, the sample size, the test window and the losses.
  </Card>
</Columns>

## CoinRotator

[coinrotator.app](https://coinrotator.app) is the screener. It applies fixed rules to the market data, so the same data always gives the same trend, streak and ranking. Shumi reads that data together with funding, sentiment and narratives, and weighs them into an answer. When an answer names a coin, it links to that coin's page on coinrotator.app, so you can see the numbers it started from. [CoinRotator](/coinrotator) lists the screener's pages.


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