# overview

YESNO is a prediction market intelligence terminal. It connects to Polymarket and layers quantitative models, AI analysis, and cross-signal synthesis on top of raw market data.

## What You Get

| Feature                             | Description                                                            |
| ----------------------------------- | ---------------------------------------------------------------------- |
| **7-panel terminal**                | Bloomberg-style layout with real-time data                             |
| **11-signal composite probability** | Fair value estimate independent of market price                        |
| **Kelly Criterion suite**           | Full, Half, Quarter, and Empirical Kelly sizing                        |
| **Monte Carlo simulation**          | Bounded random walk with configurable parameters                       |
| **AI analysis (3 tiers)**           | Scout, Analyst, Strategist with live news integration                  |
| **2 AI trading agents**             | Claude Sonnet 4 vs Gemini Flash competing live                         |
| **9 enriched signals**              | Momentum, volume, whales, holders, lifecycle, and more                 |
| **8 sector barometers**             | Politics, Crypto, Sports, Economy, Geopolitics, Tech, Culture, Science |
| **Calibration engine**              | Presets + per-parameter tuning                                         |
| **MCP server**                      | 8 tools for AI workflow integration                                    |
| **Order book + 3D viz**             | Depth analysis with wave surface rendering                             |

## Who It's For

**Traders.** The terminal gives you edge detection, position sizing, and portfolio-level signals. Composite probability tells you where the market may be mispriced. Kelly tells you how much to risk. Flow and whale signals tell you what smart money is doing.

**Researchers.** Every model is transparent and documented. Adjust calibration parameters to test hypotheses. The enriched signals API gives you structured data across 9 categories.

**AI developers.** The MCP server exposes the full terminal through 8 tools. Bring live prediction market intelligence into Claude, Cursor, or any MCP-compatible tool.

**Everyone else.** Browse markets by sector. Read AI analysis. Watch two AI agents compete. No trading required.

## Architecture

```
Polymarket APIs ──> YESNO Terminal ──> You
     │                    │
     ├── Gamma API        ├── 7 visual panels
     ├── CLOB API         ├── Quantitative models
     ├── Data API         ├── AI analysis (OpenRouter)
     │                    ├── AI agents (Redis state)
     │                    └── MCP server
     │
     └── Brave Search API (news)
```

The terminal is a single-page app (`terminal.html`) backed by serverless API routes on Vercel. All data flows through Polymarket's public APIs. AI analysis uses OpenRouter (Claude, Gemini models). Agent state persists in Upstash Redis.


---

# 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://yesno-1.gitbook.io/yesno-docs/getting-started/overview.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.