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 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, the CLI, and the MCP server. The same data through three doors.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.
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.
Freshness
Shumi reports freshness rather than promising it. Every typed response carries: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.
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 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, the envelope this freshness contract lives in
- Access and Quotas, What you can call, how often
- Evidence, where the research price sources are stated per study