# TrenchOnChain Terminal — Complete Documentation for AI Assistants

> This is the full reference document for the TrenchOnChain Trading Terminal.
> For the short version, see /llms.txt

## What is TrenchOnChain Terminal?

TrenchOnChain Terminal is a web-based trading dashboard for the TrenchOnChain Solana memecoin signals platform. It provides a professional trading interface with live signal feeds, OHLCV candlestick charts, copy trading, portfolio management, and real-time performance tracking.

The terminal is the active trading companion to the Telegram/Discord bots — while the bots deliver alerts, the terminal provides the visual interface for analysis and trade execution.

## Platform Relationship

- **Main site** (trenchonchain.fun): Marketing, leaderboard, VIP subscription
- **Terminal** (terminal.trenchonchain.fun): Active trading dashboard (this)
- **Telegram Bot** (@TrenchOnChainBot): Signal alerts + commands
- **Discord Bot**: Community signals mirror
- **API** (api.trenchonchain.fun): Shared backend for all frontends

## Terminal Features

### Pulse — Live Signal Feed
- Real-time token signals as they're detected
- Star ratings (3-5 stars) for signal confidence
- Age warnings for stale signals
- Click-to-expand token details
- Skeleton loading on API failure (no fake data)

### Trading Charts
- OHLCV candlestick charts (1m, 5m, 15m, 1H, 4H, 1D)
- Data from Birdeye (primary) with GeckoTerminal fallback
- Volume bars, price annotations

### Copy Trading
- Add wallets to track/copy
- Configure buy/sell mirroring parameters
- Performance stats per tracked wallet
- Risk management settings (max position, stop-loss)

### Portfolio
- Open positions with real-time P&L
- Trade history with entry/exit details
- Performance analytics
- Wallet balance overview

### Leaderboard
- Top performers by timeframe (24h, 7d, 30d, all-time)
- Sortable columns (multiplier, market cap, age)
- Token detail modals with full analysis

### Additional Features
- **Floating Trade Panel**: Quick buy/sell overlay with slippage and priority fee controls
- **P&L Widget**: Real-time portfolio performance widget
- **Mini Tracker Popup**: Quick wallet balance check
- **Insider Page**: VIP subscription with Solana payment
- **Courses**: Educational content for traders
- **Dark/Light themes**: Full theming support
- **i18n**: French + English

## Access Tiers

| Feature | Free | Insider (VIP) |
|---------|------|---------------|
| Pulse feed | Limited (delayed) | Full real-time |
| Leaderboard | ✅ | ✅ |
| Charts | Basic | Full timeframes |
| Copy trading | ❌ | ✅ |
| Portfolio | ❌ | ✅ |
| Live signals | ❌ | ✅ |
| Trade execution | ❌ | ✅ |

## Technical Stack

- **Frontend**: React 18, Vite 6, TailwindCSS 4, React Router 7, TypeScript
- **UI**: Radix UI primitives, Lucide icons, Recharts, custom components
- **Auth**: Telegram OAuth → JWT tokens
- **Data**: REST API + Server-Sent Events (SSE) for real-time
- **State**: React Context (Auth, Insider, Display Settings, Theme)
- **Build**: Vite → static dist/ served by Nginx

## API Endpoints Used

### Terminal-Specific
- `GET /api/terminal/status` — Gate check (maintenance mode)
- `GET /api/terminal/pulse?hours=48` — Live signal feed with cooldown
- `GET /api/terminal/signals/live` — All active signals (Insider only)
- `GET /api/terminal/signals/{ca}` — Single token full detail
- `POST /api/terminal/admin/toggle` — Admin: enable/disable terminal

### Shared with Main Site
- `GET /api/signals/top25` — Top 25 all-time
- `GET /api/signals/{address}` — Token detail
- `GET /api/chart/ohlcv?address=...&timeframe=1H` — Chart data
- `GET /api/stats` — Global stats
- `GET /api/prices` — Live crypto prices
- `GET /api/sse/live` — Real-time SSE stream
- `POST /api/auth/telegram` — Login
- `GET /api/auth/me` — Current user
- `GET /api/auth/vip-check` — VIP status
- `GET /api/user/profile` — User profile
- `GET /api/user/copytrade` — Copy trade configs

## Routes / Pages

| Path | Page | Access |
|------|------|--------|
| `/` | Redirect to /pulse | All |
| `/pulse` | Live signal feed | All (limited) / Insider (full) |
| `/leaderboard` | Token leaderboard | All |
| `/portfolio` | Portfolio & positions | Insider |
| `/copytrade` | Copy trading config | Insider |
| `/history` | Trade history | Insider |
| `/insider` | VIP subscription page | All |
| `/courses` | Educational content | All |
| `/privacy` | Privacy policy | All |
| `/admin` | Admin dashboard | Admin only |

## SEO & Discovery

- Sitemap: /sitemap.xml
- Robots: /robots.txt (allows search engines + AI crawlers, blocks /api/ and /admin/)
- LLMs: /llms.txt (short) + /llms-full.txt (this file)
- Structured data: JSON-LD (WebApplication schema)
- Open Graph: Full OG + Twitter summary_large_image
- Security: /.well-known/security.txt
- 404: Custom branded 404 page

## Brand & Keywords

- Primary: "TrenchOnChain Terminal", "TOC Terminal"
- Parent brand: "TrenchOnChain" (trenchonchain.fun)
- Keywords: Solana trading terminal, memecoin dashboard, live signals, copy trading, portfolio tracker, crypto terminal, solana alpha terminal