# Shumi Docs > Shumi docs: ask crypto market questions on the web, in the terminal, over the API or from an AI agent. - [Overview](https://docs.shumi.ai/index.md): What Shumi is, where to use it, and how to get your first answer. - [Overview](https://docs.shumi.ai/index.md): What Shumi is, where to use it, and how to get your first answer. - [Shumi Chat](https://docs.shumi.ai/research/shumi-chat.md): Ask about any coin, sector, narrative or the whole market, and get one read that weighs trend, funding, sentiment and positioning together. - [Shumi Chat](https://docs.shumi.ai/research/shumi-chat.md): Ask about any coin, sector, narrative or the whole market, and get one read that weighs trend, funding, sentiment and positioning together. - [Coin Lookup](https://docs.shumi.ai/research/coin-analysis.md): Price, market cap, trend history and the risk picture for one coin, and the same for a stock or commodity. - [Market Screener](https://docs.shumi.ai/research/market-screener.md): Rank the day's biggest movers, or filter the tracked coins by trend, category and market cap. - [CoinRotator](https://docs.shumi.ai/coinrotator.md): The rule-based crypto screener at coinrotator.app, and how Shumi links to it. - [Signals](https://docs.shumi.ai/trade-decisions/signals.md): One verdict per coin, from bullish to bearish, with the evidence behind it and a confidence level. - [Signals](https://docs.shumi.ai/trade-decisions/signals.md): One verdict per coin, from bullish to bearish, with the evidence behind it and a confidence level. - [Market State](https://docs.shumi.ai/research/market-health.md): How many coins are trending up, sideways or down, whether the market has flipped, BTC dominance, and the regime signal log. - [Funding](https://docs.shumi.ai/trade-decisions/funding-momentum.md): Perp funding per coin as an APR, ranked against every perp in the market, plus market temperature and funding alerts. - [Pairs and Delta Neutral](https://docs.shumi.ai/trade-decisions/pair-trading.md): Long one coin against another, or the same coin long on one venue and short on another to collect the funding gap. - [Sentiment and Narratives](https://docs.shumi.ai/research/sentiment.md): What the crowd is saying about a coin or the market, which categories are heating up, and which narratives are active. - [API Quickstart](https://docs.shumi.ai/quickstart.md): Get an API key, call the Shumi API from your own code, and add the MCP server to your AI agent. - [API Quickstart](https://docs.shumi.ai/quickstart.md): Get an API key, call the Shumi API from your own code, and add the MCP server to your AI agent. - [API Overview](https://docs.shumi.ai/api-reference/introduction.md): Base URL, authentication, the response envelope, error codes and quotas for the Shumi API. - [CLI](https://docs.shumi.ai/agents/cli.md): Install the shumi command, sign in, create API keys and pull market data into scripts and agents. - [MCP Server](https://docs.shumi.ai/agents/mcp.md): Give an AI agent Shumi's market data as MCP tools, hosted or run locally. - [Pay Per Call](https://docs.shumi.ai/agents/payments.md): Pay for single API calls in USDC on Base with the x402 protocol, with no subscription. - [Ask a natural-language question](https://docs.shumi.ai/api-reference/ask/ask-a-natural-language-question.md): Runs the full Shumi engine: classify, plan, execute tools, generate. Returns a streamed response. - [Synthesised verdict for one asset](https://docs.shumi.ai/api-reference/trade-decisions/synthesised-verdict-for-one-asset.md): Fans out to risk context, funding momentum, active regime, and coin sentiment, then returns a rules-based verdict with the evidence behind it. No model call. - [Market regime](https://docs.shumi.ai/api-reference/trade-decisions/market-regime.md) - [Perpetual funding momentum](https://docs.shumi.ai/api-reference/trade-decisions/perpetual-funding-momentum.md): Market-wide when `symbol` is omitted, otherwise scoped to one asset. - [Recent funding alert events](https://docs.shumi.ai/api-reference/trade-decisions/recent-funding-alert-events.md) - [Futures signal engine](https://docs.shumi.ai/api-reference/trade-decisions/futures-signal-engine.md) - [Pair trading and delta-neutral](https://docs.shumi.ai/api-reference/trade-decisions/pair-trading-and-delta-neutral.md): `suggestions` pairs two different coins. `delta-neutral` is the same coin across two venues, earning the funding spread. They are not interchangeable. - [Trend state across the market](https://docs.shumi.ai/api-reference/trade-decisions/trend-state-across-the-market.md) - [Walkforward backtest records](https://docs.shumi.ai/api-reference/trade-decisions/walkforward-backtest-records.md): Historical record of a forward-testing engine. Read it as history — an empty `positions` list means the engine has written nothing, not that the market has no setups. - [Signal quality scoring](https://docs.shumi.ai/api-reference/trade-decisions/signal-quality-scoring.md) - [Resolve free text to an asset](https://docs.shumi.ai/api-reference/coins/resolve-free-text-to-an-asset.md): Probes the crypto and RWA lanes and returns ranked matches, each tagged with how it was found. Use this to disambiguate a ticker that exists in both lanes, such as `GOLD` or `COIN`. - [Look up a coin by ticker](https://docs.shumi.ai/api-reference/coins/look-up-a-coin-by-ticker.md): Returns coin metadata and trend state. If the ticker also matches a real-world asset, the response carries a `note` naming the collision. - [Bundled risk context](https://docs.shumi.ai/api-reference/coins/bundled-risk-context.md): Price, funding, trend alignment, sentiment stance, and BTC correlation in one payload. Fields that could not be refreshed are listed in `_stale_fields`. - [Crowd sentiment for one coin](https://docs.shumi.ai/api-reference/coins/crowd-sentiment-for-one-coin.md) - [Historical metadata](https://docs.shumi.ai/api-reference/coins/historical-metadata.md) - [Resolve a contract address to a coin](https://docs.shumi.ai/api-reference/coins/resolve-a-contract-address-to-a-coin.md) - [Coin by canonical id](https://docs.shumi.ai/api-reference/coins/coin-by-canonical-id.md) - [Coin by display name](https://docs.shumi.ai/api-reference/coins/coin-by-display-name.md) - [Live prices](https://docs.shumi.ai/api-reference/market/live-prices.md): Symbol-keyed. Tickers are resolved to canonical ids server-side. - [Global market snapshot](https://docs.shumi.ai/api-reference/market/global-market-snapshot.md) - [Breadth crossings](https://docs.shumi.ai/api-reference/market/breadth-crossings.md): Always returns a `crossings` array. It is empty when nothing has fired, so callers never branch on shape. - [Market breadth and health](https://docs.shumi.ai/api-reference/market/market-breadth-and-health.md) - [Reference baselines](https://docs.shumi.ai/api-reference/market/reference-baselines.md) - [Filterable market screener](https://docs.shumi.ai/api-reference/market/filterable-market-screener.md): Accepts the same filter parameters as the web screener and passes them through. - [All categories](https://docs.shumi.ai/api-reference/categories/all-categories.md) - [Category trend breakdown](https://docs.shumi.ai/api-reference/categories/category-trend-breakdown.md) - [Coins in a category](https://docs.shumi.ai/api-reference/categories/coins-in-a-category.md) - [Sentiment for a category](https://docs.shumi.ai/api-reference/categories/sentiment-for-a-category.md) - [Sentiment and narrative momentum](https://docs.shumi.ai/api-reference/sentiment/sentiment-and-narrative-momentum.md) - [Active narratives](https://docs.shumi.ai/api-reference/sentiment/active-narratives.md) - [Tracked token holder counts](https://docs.shumi.ai/api-reference/tracking/tracked-token-holder-counts.md) - [Tracked wallet activity](https://docs.shumi.ai/api-reference/tracking/tracked-wallet-activity.md) - [Highlights mined from tracked transcripts](https://docs.shumi.ai/api-reference/tracking/highlights-mined-from-tracked-transcripts.md): Spoken-word commentary from tracked video and podcast sources, tagged with the coins, sectors, and macro topics mentioned. - [Tracked basket snapshots](https://docs.shumi.ai/api-reference/tracking/tracked-basket-snapshots.md) - [List real-world assets](https://docs.shumi.ai/api-reference/rwa/list-real-world-assets.md): Equities, metals, and commodities. These are real-world instruments, not tokenised crypto wrappers. - [One real-world asset](https://docs.shumi.ai/api-reference/rwa/one-real-world-asset.md) - [Real-world asset by ticker](https://docs.shumi.ai/api-reference/rwa/real-world-asset-by-ticker.md) - [Stream updates as NDJSON](https://docs.shumi.ai/api-reference/streaming/stream-updates-as-ndjson.md): Long-lived newline-delimited JSON. One object per line, emitted every `interval` seconds until the client disconnects. Opening a stream counts against quota; it is not payable per call, so an exhausted quota returns 429 rather than a payment challenge. - [Resolve the caller's entitlement](https://docs.shumi.ai/api-reference/account/resolve-the-callers-entitlement.md): Reports the tier the gate will actually apply to this credential, so a client never has to guess why a request was refused. - [Plans and Quotas](https://docs.shumi.ai/platform/access.md): What each plan gives you, how the free counter works, and what you see when it runs out. - [Plans and Quotas](https://docs.shumi.ai/platform/access.md): What each plan gives you, how the free counter works, and what you see when it runs out. - [Coverage](https://docs.shumi.ai/platform/coverage.md): What you can look up with Shumi: any listed coin, any token with a DEX pool, perps on 17 exchanges, and real-world assets (RWA). - [Evidence](https://docs.shumi.ai/evidence/studies.md): The published studies, what each one tested, and how to check the walk-forward record yourself. - [FAQ](https://docs.shumi.ai/platform/faq.md): Short answers to the questions traders ask most about Shumi. - [Changelog](https://docs.shumi.ai/platform/changelog.md): Updates to Shumi Chat, the CLI, the API and CoinRotator. ## OpenAPI Specs - [openapi](/api-reference/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.