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

# Crypto Price Snapshot

> Latest spot price + 24h stats for a crypto pair.

<Note icon="sparkles">
  **Available as MCP tool**: `crypto_snapshot` — call directly from Claude / Cursor / any MCP client. See [MCP Server](/en/integration/mcp-server) for the 60-second setup.
</Note>

<Badge color="green" icon="circle-check">Live</Badge>
 
<Badge color="gray" size="sm">free · snapshot</Badge>

## What it does for your agent

`crypto_snapshot` returns the current spot price for a single crypto pair plus its 24-hour change and volume. Use it as a **pricing checkpoint** mid-task — when an agent needs to verify current price levels, compare assets, or tag a market regime — without pulling the full klines history.

`crypto_snapshot({ ticker })` → `price`, `dayChange`, `dayChangePercent`, `volume24h`, `time`. That's it.

## Response

<ResponseField name="data" type="CryptoSnapshot" required>
  <Expandable title="CryptoSnapshot fields">
    <ResponseField name="ticker" type="string" required>
      The trading pair in `BASE-QUOTE` format (e.g. `BTC-USD`).
    </ResponseField>

    <ResponseField name="price" type="number" required>
      Latest traded price.
    </ResponseField>

    <ResponseField name="dayChange" type="number" required>
      Absolute price change over the last 24 hours.
    </ResponseField>

    <ResponseField name="dayChangePercent" type="number" required>
      Percentage price change over the last 24 hours.
    </ResponseField>

    <ResponseField name="volume24h" type="number" required>
      24-hour trading volume in the base asset.
    </ResponseField>

    <ResponseField name="time" type="string" required>
      Snapshot timestamp (ISO-8601 UTC).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta.creditsUsed" type="number">Always `0` — this endpoint is free.</ResponseField>
<ResponseField name="meta.remainingCredits" type="number">Account credits remaining.</ResponseField>

```json title="200 OK · crypto_snapshot" expandable theme={null}
{
  "data": {
    "ticker": "BTC-USD",
    "price": 87200.00,
    "dayChange": 1200.50,
    "dayChangePercent": 1.26,
    "volume24h": 12345678,
    "time": "2026-04-29T12:30:00Z"
  },
  "meta": { "creditsUsed": 0, "remainingCredits": 99 }
}
```

## Notes

<Tip>
  For **historical bars**, use `crypto_historical_klines` — it returns OHLCV candles at `1h`, `4h`, `1d`, or `1w` intervals. `crypto_snapshot` is only for "right now".
</Tip>

<Warning>
  **Spot markets only.** Futures, perpetuals, funding rates, and open interest are not exposed by this tool.
</Warning>

<Warning>
  Not trading-grade real-time. It can lag the latest market print by up to 30 seconds. Don't trade on it.
</Warning>

## Direct invocation

<Accordion title="HTTP / SDK examples" icon="terminal">
  <CodeGroup>
    ```typescript MCP (Claude / Cursor) theme={null}
    {
      "method": "tools/call",
      "params": {
        "name": "crypto_snapshot",
        "arguments": { "ticker": "BTC-USD" }
      }
    }
    ```

    ```python Python (HTTP) theme={null}
    import os, requests

    resp = requests.get(
        "https://api.llmquantdata.com/api/crypto/snapshot",
        headers={"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"},
        params={"ticker": "BTC-USD"},
    ).json()
    d = resp["data"]
    print(f"{d['ticker']}: ${d['price']:,.2f} ({d['dayChangePercent']:+.2f}%)")
    ```

    ```bash cURL theme={null}
    curl "https://api.llmquantdata.com/api/crypto/snapshot?ticker=BTC-USD" \
      -H "Authorization: Bearer $LLMQUANT_API_KEY"
    ```
  </CodeGroup>
</Accordion>

## Full parameter reference

<Accordion title="crypto_snapshot — request parameters" icon="sliders">
  <ParamField query="ticker" type="string" required>
    Trading pair in `BASE-QUOTE` format. Examples: `BTC-USD`, `ETH-USD`, `SOL-USD`.
  </ParamField>
</Accordion>

## Related

<Columns cols={2}>
  <Card title="Crypto Historical Klines" icon="chart-line" href="/en/api/prices/crypto-historical">
    OHLCV candles at `1h`, `4h`, `1d`, or `1w` intervals.
  </Card>

  <Card title="Equity Snapshot" icon="square-chart-gantt" href="/en/api/prices/equity-historical">
    Same shape for US equities (different endpoint).
  </Card>
</Columns>