# TrenchOnChain — Complete Documentation for AI Assistants

> This is the full reference document for AI assistants interacting with TrenchOnChain.
> For the short version, see /llms.txt

## What is TrenchOnChain?

TrenchOnChain (often abbreviated "TOC") is a professional Solana memecoin trading signals platform. It automatically scans on-chain data, detects early tokens before they pump, and delivers real-time alerts via Telegram and Discord.

The platform removes 95% of market noise by analyzing internal signals (KOL wallets, smart money activity, volume patterns, liquidity events) and delivers only high-confidence calls with star ratings (3-5 stars).

## Platform Components

### 1. Marketing Website (trenchonchain.fun)
- **Purpose**: Public landing page showcasing features, live leaderboard, VIP subscription
- **Stack**: React 18, Vite 6, TailwindCSS 4, TypeScript
- **Languages**: English, French, Spanish, German, Portuguese, Turkish, Russian, Chinese, Japanese, Korean
- **Key features**: Live signal leaderboard, token performance cards, Solana VIP payments, Telegram OAuth

### 2. Trading Terminal (terminal.trenchonchain.fun)
- **Purpose**: Full trading dashboard for active traders
- **Stack**: React 18, Vite 6, TailwindCSS 4, React Router 7, TypeScript
- **Key features**: Live signal feed (Pulse), OHLCV charts, copy trading, portfolio tracking, leaderboard
- **Access**: Free tier + Insider (VIP) tier for advanced features

### 3. Telegram Bot (@TrenchOnChainBot)
- **Purpose**: Primary alert delivery + user interaction
- **Features**: Real-time signal alerts, progression updates, winner recaps, copy trading commands, wallet management
- **Users**: 100+ concurrent users
- **VIP tier**: More signals, faster alerts, exclusive calls

### 4. Discord Bot
- **Purpose**: Community signals + notifications mirror
- **Features**: Same signals as Telegram, formatted for Discord embeds

### 5. Backend API (api.trenchonchain.fun)
- **Stack**: FastAPI (Python), SQLite databases
- **Endpoints**: Signals, leaderboard, authentication, payments, charts, SSE real-time feed

## Signal Rating System

| Stars | Meaning | Criteria |
|-------|---------|----------|
| 5★ | Ultra-high conviction | Multiple KOL buy signals + volume surge + strong fundamentals |
| 4★ | High conviction | KOL activity detected + good volume patterns |
| 3★ | Standard signal | Volume/liquidity events detected, moderate confidence |

## Performance Tracking

- **Multiplier tracking**: Signals tracked from entry to peak (e.g., "2x", "10x", "121x")
- **Winner recaps**: Automatic recap when a signal completes its cycle
- **Progression updates**: Real-time notifications at key thresholds (1.5x, 2x, 3x, 5x, 10x, 20x, 50x, 100x...)
- **Anti-rug protection**: Dead token detection, liquidity monitoring

## Pricing

- **Free tier**: Access to public signals, leaderboard, basic features
- **Insider tier**: All signals, faster delivery, copy trading, portfolio, exclusive tools
- **Payment**: Solana-based (SOL/USDC), unique wallet per transaction, on-chain verification

## Key URLs

- Main site: https://trenchonchain.fun
- Terminal: https://terminal.trenchonchain.fun
- Telegram Bot: https://t.me/TrenchOnChainBot
- Discord: https://discord.gg/RXvjghJmKz
- API: https://api.trenchonchain.fun

## API Reference

### Public Endpoints (no auth required)
- `GET /api/signals/top25` — Top 25 all-time performers
- `GET /api/signals/top10-48h` — Top 10 last 48 hours
- `GET /api/signals/top10-24h` — Top 10 last 24 hours
- `GET /api/signals/recent-winners` — Recent winners (7d, ≥1.4x)
- `GET /api/signals/recent` — 25 most recent signals
- `GET /api/signals/all?page=1&limit=25` — Paginated all signals
- `GET /api/signals/{address}` — Single token by contract address
- `GET /api/stats` — Global stats (total signals, win rate, avg multiplier)
- `GET /api/prices` — SOL/BTC/ETH live prices
- `GET /api/chart/ohlcv?address=...&timeframe=1H` — OHLCV chart data
- `GET /api/sse/live` — Server-Sent Events for real-time updates

### Authenticated Endpoints (JWT required)
- `POST /api/auth/telegram` — Login via Telegram OAuth
- `GET /api/auth/me` — Current user info
- `GET /api/auth/vip-check` — VIP status check
- `GET /api/user/profile` — Full user profile
- `GET /api/user/wallets` — User wallets
- `GET /api/user/copytrade` — Copy trade configurations
- `POST /api/payments/create` — Create payment session
- `GET /api/payments/status/{id}` — Payment status

### Terminal-Specific
- `GET /api/terminal/status` — Terminal enabled/disabled
- `GET /api/terminal/pulse?hours=48` — Pulse feed
- `GET /api/terminal/signals/live` — All active signals (Insider only)

## Technical Architecture

```
┌─────────────────────────────────────────────────────────┐
│                     USERS                                 │
│  Telegram │ Discord │ Website │ Terminal │ Extension      │
└─────────────┬───────────┬────────┬────────┬─────────────┘
              │           │        │        │
              ▼           ▼        ▼        ▼
┌─────────────────────────────────────────────────────────┐
│                   BACKEND (FastAPI)                       │
│  Auth │ Payments │ Signals API │ SSE │ Charts │ Admin    │
└───────────────────────┬─────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────────┐
│              PYTHON BOT ENGINE                            │
│  Signal Detection │ PnL Tracker │ Copy Trading           │
│  Anti-Rug │ Progression Updates │ Winner Recaps          │
└───────────────────────┬─────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────────┐
│              SOLANA BLOCKCHAIN                            │
│  Jupiter Swaps │ Wallet Management │ TX Verification     │
└─────────────────────────────────────────────────────────┘
```

## SEO & Discovery

- Sitemap: /sitemap.xml (with hreflang for all languages)
- Robots: /robots.txt (allows all search engines + AI crawlers)
- LLMs: /llms.txt (short) + /llms-full.txt (this file)
- Structured data: JSON-LD (WebApplication, Organization)
- Open Graph: Full OG + Twitter Card tags
- Security: /.well-known/security.txt

## Brand & Search Terms

- Primary: "TrenchOnChain", "trenchonchain.fun"
- Abbreviations: "TOC", "toc.fun"
- Common misspellings: "trench on chain", "trenchonchian", "trenchonchein"
- Keywords: Solana memecoin signals, trading signals, crypto analytics, pump fun signals, degen signals, solana alpha