# Free Chat Limits

## Why There Are Limits

Free-form chat with ORACLE uses real AI provider tokens (Gemini 2.5 Flash, with DeepSeek V3 fallback). Each message costs \~$0.0003 in API calls. Without limits, a single abusive user could rack up $50+/day in costs.

## The Limits

| Limit      | Value         | Scope              |
| ---------- | ------------- | ------------------ |
| Rate limit | 20 req/min    | Per IP             |
| Daily cap  | 40 messages   | Per wallet         |
| Global cap | 2000 messages | All users combined |

## What Happens at the Limits

| Situation                 | What you see                                                                                                                                       |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| IP rate-limited (>20/min) | "Slow down — too many requests"                                                                                                                    |
| Hit your daily 40         | "You've used today's 40 free Oracle chat messages. Resets in \~Xh. Token risk scans are still free + unlimited — just paste any contract address." |
| Global cap hit            | "The Oracle is at capacity for today — high demand. Try again later. Token risk scans are still free — paste any contract address."                |

## CA Scans Are Always Free

The 40/day cap **only** applies to free-chat. Pasting a contract address bypasses the AI providers entirely and runs on our own infra (trustfi + DexScreener). Scan as many tokens as you want — there's no cap.

## When ORACLE Is Offline

If both Gemini and DeepSeek fail:

> "⚠ Oracle is offline right now. Paste a Solana CA and I can still scan it via trustfi — that path doesn't need AI."

The CA-scan path stays alive even when the chat path is down.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.snake-os.com/oracle-ai-risk-scanner/chat-limits.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.