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

# Signals

> One verdict per coin, from bullish to bearish, with the evidence behind it and its coverage.

`shumi signal BTC` gives one verdict for a coin, built from four readings: trend on the daily and weekly chart, funding, sentiment and the regime read. The first three set the score. The fourth counts toward coverage only. You get the verdict, the score behind it, its coverage and the evidence as plain sentences.

## Get a verdict

> [tab] Terminal
>
> ```bash theme={"dark"}
> shumi signal SOL
> ```
>
> Bare `shumi SOL` does the same. Add `--agent` for JSON.

> [tab] API
>
> ```bash theme={"dark"}
> curl "https://api.shumi.ai/api/cli/signal/SOL" \
>   -H "Authorization: Bearer shumi_sk_your_key_here"
> ```

> [tab] AI agent
>
> Connect the [MCP server](https://shumi.mintlify.site/agents/mcp.md) and call `get_signal` with `symbol`.

An unknown ticker returns `404` with "Check the ticker, or use /api/cli/resolve to find it." `shumi resolve <name>` finds the right symbol.

## Response fields

| Field | Meaning |
| - | - |
| `verdict` | `strong-bull`, `bull`, `neutral`, `bear` or `strong-bear` |
| `score` | The number the verdict is cut from, in steps of 0.5 |
| `confidence` | Coverage: `high`, `medium` or `low`, by how many of the four readings answered |
| `evidence` | Plain sentences describing the readings, including some that did not change the score (funding at 0, a neutral stance, BTC correlation) |
| `sources` | Whether `risk_context`, `funding_momentum`, `regime_active` and `sentiment_coin` each came back `fulfilled` or `rejected` |
| `as_of` | Time of the freshest reading used |

A real evidence list for BTC:

```json theme={"dark"}
"evidence": [
  "trend (daily) is bullish since 2026-09-19T00:00:00.000Z",
  "trend (weekly) is bullish since 2026-08-16T00:00:00.000Z",
  "sentiment stance (from risk-context): accumulation",
  "funding APR 11.00% (percentile 0.65, tier neutral)"
]
```

Ask it in chat: [What is the signal verdict on SOL right now, and what evidence is behind it?](https://shumi.ai/app?q=What%20is%20the%20signal%20verdict%20on%20SOL%20right%20now%2C%20and%20what%20evidence%20is%20behind%20it%3F\&cta=docs-signals)

## Score

The score starts at 0. Each reading adds to it or subtracts from it.

| Reading | Effect on score |
| - | - |
| Daily trend | up +1, down -1, sideways 0 |
| Weekly trend | up +1, down -1, sideways 0 |
| Sentiment stance | accumulation +1, capitulation +0.5, exhaustion -0.5, distribution or euphoria -1, neutral 0 |
| Funding APR | above 30% -1, above 10% +0.5, below -10% +1, otherwise 0 |

Trend is the same UP, HODL or DOWN state the [market breadth counts](https://shumi.mintlify.site/research/market-health.md#count-the-coins-trending-up-sideways-or-down) use, read on the daily and on the weekly chart. An UP or DOWN trend adds an evidence line that says bullish or bearish, with the date the current state began. A HODL trend adds no line. A stance appears only when sentiment has set one; [Sentiment and Narratives](https://shumi.mintlify.site/research/sentiment.md) explains the words. Regime counts toward coverage and does not move the score.

| Score | Verdict |
| - | - |
| 2.5 or more | `strong-bull` |
| 0.5 to 2 | `bull` |
| above -0.5 and below 0.5 | `neutral` |
| -2 to -0.5 | `bear` |
| -2.5 or less | `strong-bear` |

Coverage (the `confidence` field) is `high` when all four readings answered, `medium` for two or three, `low` for fewer. It measures how much of the evidence came back. Readings refresh on their own schedules, so two calls minutes apart can score differently; check `as_of`. For the carry behind the funding line, see [Funding](https://shumi.mintlify.site/trade-decisions/funding-momentum.md).


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