CLI - Shumi Docs

shumi puts every Shumi data route in your terminal. It prints readable text for you and JSON for scripts and agents.

Install

Needs Node 22 or later.

npm install -g shumi

shumi login

This opens your browser. If the browser shows a connection error after you signed in, run shumi login --paste and paste that page’s URL. shumi logout clears the stored credentials.

Check the setup

shumi init

It checks your login and the network and suggests the next commands.

Get data

You want	Command
A verdict on one coin, with evidence	`shumi BTC` or `shumi signal BTC`
Risk context for one coin	`shumi coin risk BTC`
Which asset a ticker points to	`shumi resolve GOLD`
Trend counts UP, HODL and DOWN	`shumi market health`
Live prices	`shumi market prices --symbols BTC,ETH,SOL`
Today’s biggest movers	`shumi scan --sort change24h --limit 10`
Coins that match a filter	`shumi scan --category Meme --trend UP --limit 20`
Where funding is hot or cold	`shumi funding momentum [--symbol ETH]`
Sentiment on one coin	`shumi sentiment coin BTC`
Two coins to trade against each other	`shumi pairs suggestions`
A stock, metal or commodity perp	`shumi rwa lookup AAPL`
A question in plain words	`shumi ask "is BTC funding crowded?"`

shumi scan --sort needs CLI 0.9.1 or later, and the current trend on shumi coin lookup needs 0.9.0. shumi version shows yours, and Market Screener covers every scan flag. shumi help prints the full grouped list and every command takes --help. On the Free plan each data command counts as one question. Plans and Quotas has the numbers.

Use it in scripts and agents

Output switches to JSON on its own when you pipe it, so shumi market health | jq .data.trends works with no flag. The JSON is the same envelope the API returns.

Flag or variable	What it does
`--json`	Force JSON on stdout
`--agent`	JSON, no spinner, no colour, no update notice. Errors go to stderr as JSON
`--fields <list>`	Keep only these top-level keys, comma separated
`--top <n>`	Keep the first N items when the response is a list
`--auto-pay`	Pay a per-call price without asking, up to `SHUMI_MAX_PRICE_USDC` (0.10 by default). See Pay Per Call
`SHUMI_TOKEN`	An API key, created with `shumi keys create` on a machine with a browser and copied to one without

shumi funding momentum --agent | jq '.data.assets[] | select(.tier == "hot")'

shumi commands --json prints a manifest of every command with its arguments, so an agent can discover what it can call.

Create an API key

A server, a bot or an MCP client needs a key instead of your login.

shumi keys create my-bot
shumi keys list
shumi keys revoke <prefix>

Keys start with shumi_sk_. keys list shows each key’s prefix, and that is what revoke takes. A key carries the plan of the account that created it.

Fix a problem

shumi doctor

It checks the config file, the login token and its expiry, the network, the API and whether your version is current. shumi billing tier shows the plan the API applies to you. Both work when you are out of quota.

​Install and sign in

​Get data

​Use it in scripts and agents

​Create an API key

​Fix a problem

Install and sign in

Get data

Use it in scripts and agents

Create an API key

Fix a problem