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

# Signals

> One verdict per coin, from bullish to bearish, with the evidence behind it and a confidence level.

`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 confidence only. You get the verdict, the score behind it, a confidence level and the evidence as plain sentences.

## Get a verdict

<Tabs>
  <Tab title="Terminal">
    ```bash theme={"dark"}
    shumi signal SOL
    ```

    Bare `shumi SOL` does the same. Add `--agent` for JSON.
  </Tab>

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

  <Tab title="AI agent">
    Connect the [MCP server](/agents/mcp) and call `get_signal` with `symbol`.
  </Tab>
</Tabs>

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

## What comes back

| 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` | `high`, `medium` or `low`: 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)"
]
```

## How the score is built

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](/research/market-health#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](/research/sentiment) explains the words. Regime counts toward confidence 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` |

Confidence is `high` when all four readings answered, `medium` for two or three, `low` for fewer. The readings refresh on their own schedules, so two calls minutes apart can give different scores. Read `as_of`. For the carry behind the funding line, see [Funding](/trade-decisions/funding-momentum).


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