> ## 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.

# Coverage

> Which assets, which venues, which data domains, and how Shumi reports freshness instead of promising it.

What Shumi can see, and how to tell how stale it is.

## Venues

**Perpetual futures**, with funding rates and open interest. Binance, Bybit, OKX, KuCoin, MEXC, Bitget, BingX.

**Spot.** A broad multi-exchange universe, with dedicated views for Binance, KuCoin, and Solana.

Backtests in [Evidence](/evidence/studies) are priced from Binance USDT perpetuals for the 2021–2025 windows and Hyperliquid OHLCV for the 2026 live window. Those are research price sources and are stated per study; they are not the same thing as the venues covered live.

## Data domains

Everything below is reachable from the [API](/api-reference/introduction), the [CLI](/agents/cli), and the [MCP server](/agents/mcp). The same data through three doors.

| Domain            | What is tracked                                                                  |
| ----------------- | -------------------------------------------------------------------------------- |
| Price and trend   | Live prices, SuperTrend on 4h / daily / weekly, trend streaks, breadth crossings |
| Market state      | Global snapshot, breadth and health, regime, reference baselines                 |
| Funding           | Per-asset funding, momentum tiers, funding alert events                          |
| Futures           | Futures signals across the seven perp venues                                     |
| Sentiment         | Per-coin and market-wide crowd sentiment, narrative momentum                     |
| Categories        | Narrative groupings (AI, DeFi, RWA, Meme, Gaming, L2) with aggregate trend data  |
| Relative value    | Pair suggestions and delta-neutral opportunities                                 |
| On-chain tracking | Tracked token holder counts over time, tracked wallet activity, basket snapshots |
| Transcripts       | Highlights mined from tracked video and podcast commentary                       |
| Real-world assets | Equities, gold, and commodities, see below                                       |
| Research record   | Walkforward signals, positions, and outcomes                                     |

## Identity resolution

Tickers collide across lanes, and this is the failure mode most likely to produce a confidently wrong answer. `GOLD` and `COIN` each name both a crypto token and a real-world asset.

Resolve before you fetch, `GET /api/cli/resolve`, `shumi resolve`, or `resolve_coin` in MCP. Coins are also addressable by contract address, canonical id, and display name, which matters for new or ambiguously-ticked tokens where the symbol alone is not enough.

<Note>
  **Real-world assets means actual equities, gold, and commodities.** It does not mean tokenized crypto wrappers of them. Wrapped or tokenized versions are classified separately and deliberately kept out of the RWA lane, so a query for gold returns the metal rather than a token that tracks it.
</Note>

Resolution is best-effort where a symbol is ambiguous or a contract is very new, and it says so rather than guessing silently.

## Freshness

Shumi **reports** freshness rather than promising it. Every typed response carries:

```json theme={"dark"}
"meta": {
  "ts": "2026-08-11T15:22:43.000Z",
  "as_of": "2026-08-11T15:20:00.000Z",
  "data_age_seconds": 163
}
```

`ts` is when the response was built. `as_of` and `data_age_seconds` describe the underlying data, whenever it is timestamped.

This is deliberate, and it is worth understanding why it is the stronger guarantee. A published refresh interval tells you what is supposed to happen; `data_age_seconds` tells you what did. Upstream venues rate-limit, stall, and go down, and an SLA does not prevent any of that. It just means you find out later. Read the age on anything trade-adjacent and set your own threshold.

Trend scans are deterministic and run on a fixed schedule, so a SuperTrend flip is reproducible from the same candles rather than being a model output that varies between calls.

## Live streams

`GET /api/cli/watch/{stream}` holds a connection open and emits newline-delimited JSON for continuously-updating data. Streams require a paid tier, see [Access and Quotas](/platform/access).

## Gaps worth knowing

* **No order books or fills.** Shumi sees prices, funding, and open interest; it does not see depth, and nothing here models slippage.
* **Sentiment coverage is uneven.** Large caps have far more social and transcript material than long-tail assets, so a divergence signal on a thin asset rests on thinner evidence. [Sentiment Divergence](/research/sentiment-divergence) is explicit about this.
* **Holder and wallet tracking is per-contract and opt-in**, covering watched contracts rather than the whole chain.
* **No execution anywhere.** No exchange keys, no custody, no order path.

## Related

* [API Overview](/api-reference/introduction), the envelope this freshness contract lives in
* [Access and Quotas](/platform/access), What you can call, how often
* [Evidence](/evidence/studies), where the research price sources are stated per study