# Introduction

Real-time crypto token monitoring platform. Signals from Telegram/Discord are captured, linked to tokens, scored by AI, and broadcast to subscribers via WebSocket.

## Architecture Overview

Three layers: **scrapers** (t2d, stalker, Cielo, GMGN) → **v2 MongoDB** (message\_pipeline: quality scoring, token linking, brainometer, strategy engine) → **output** (WebSocket to Telegram/group clients). v1 MongoDB (history2, tokensV2) provides token metadata and swap data, connected via dexscreener API bridge.

## Documentation

* [Architecture & Data Sources](/docs/architecture.md)
* [AI Models](/docs/ai-models.md)
* [Message Quality Scoring](/docs/quality.md)
* [Token-Message Linker](/docs/linker.md)
* [Feedback System](/docs/feedback.md)
* [Reward System](/docs/rewards.md)
* [Strategy Engine](/docs/strategy.md)
* [MongoDB Schema](/docs/database.md)
* [API Reference](/docs/api.md)
* [File Map](/docs/files.md)

## Tech Stack

| Layer            | Technology                                 |
| ---------------- | ------------------------------------------ |
| Frontend         | Next.js 14+, TypeScript, Tailwind, Zustand |
| Real-time        | WebSocket (direct to backend)              |
| Storage          | IndexedDB (client), MongoDB (server)       |
| Backend scrapers | Python, Telegram/Discord APIs              |


---

# 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://istory.ai/docs/readme.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.