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

# FAQ

> Short answers to the questions traders ask most about Shumi.

<AccordionGroup>
  <Accordion title="How do I ask about a position I hold?">
    Tell Shumi the coin and your side, long or short, and it answers for that position. [Shumi Chat](/research/shumi-chat) has tips for asking.
  </Accordion>

  <Accordion title="Why did it pick the wrong GOLD?">
    Some tickers name more than one asset. GOLD is both a crypto token and the metal. Run `shumi resolve GOLD` to see every match. [Coin Lookup](/research/coin-analysis) shows the other ways to pin an asset down.
  </Accordion>

  <Accordion title="Why is today's answer different from yesterday's?">
    The inputs moved. A verdict is built from the daily and weekly trend, funding and sentiment; the regime read only affects confidence. Most of those refresh every hour. Two calls a few seconds apart can differ if an input refreshed in between. [Signals](/trade-decisions/signals) shows how the score is put together.
  </Accordion>

  <Accordion title="I ran out of questions. What now?">
    On the free plan you get 10 questions to start, then 1 per day, and the day resets at 00:00 UTC. Wait for the reset, buy a plan at [shumi.ai/pricing](https://shumi.ai/pricing), or, in the terminal and API, pay per call in USDC. [Plans and Quotas](/platform/access) has the prices.
  </Accordion>

  <Accordion title="How fresh is the data?">
    Most responses carry `meta.data_age_seconds`, the age of the data in seconds when you asked. Prices are live, funding and signals refresh every hour, and the screener every 4 hours. [Coverage](/platform/coverage) has the full refresh table.
  </Accordion>

  <Accordion title="Where can I see how the signals performed?">
    The published studies at [shumi.ai/studies](https://shumi.ai/studies) list every outcome and every limit. [Evidence](/evidence/studies) explains how to read both.
  </Accordion>

  <Accordion title="Can I use Shumi from my own code or an AI agent?">
    Yes. Keys come from the CLI: install it, run `shumi login`, then `shumi keys create`. Call `https://api.shumi.ai` with the key, or add `https://mcp.shumi.ai/mcp` as a connector in your MCP client. The [API Quickstart](/quickstart) walks through both.
  </Accordion>
</AccordionGroup>