Market AI

# Meme Coin Trading Bot Blueprint

## Product Vision

Bot ini menjadi trading assistant khusus meme coin: scan token yang sedang aktif, menilai kualitas setup, memberi warning risiko, dan menyiapkan transaksi dengan paper-first guardrail.

## Target User

- Trader crypto retail yang memantau meme coin Solana/EVM.
- User Telegram yang butuh scanner cepat tanpa membuka banyak chart.
- Operator yang ingin menambahkan executor live setelah risk control matang.

## Core Features

- Meme coin scanner via DexScreener.
- Token analysis dengan score, verdict, trend, liquidity, volume, buy/sell pressure, dan warning.
- Telegram menu native untuk scanner, top picks, analyze, buy, sell, positions, watchlist, alerts, settings.
- Paper trade preview dan result.
- Live trade gateway opsional via executor eksternal.
- Optional AI risk review.

## User Flow

1. User membuka `/start`.
2. User menjalankan `/scan solana` atau menekan Scanner.
3. Bot menampilkan kandidat berdasarkan score dan risiko.
4. User memilih token atau menjalankan `/analyze TOKEN`.
5. Bot memberi signal card dan warning.
6. User membuat preview `/buy TOKEN_ADDRESS 0.05`.
7. Bot menampilkan quote, slippage, risk warning, dan tombol Confirm/Cancel.
8. Confirm menjalankan paper trade, atau live executor jika env live valid.

## AI Signal Flow

Scanner data -> scoring engine -> mode threshold -> action `BUY`, `SELL`, atau `WAIT` -> AI risk review opsional -> Telegram signal card.

## Realtime Price Flow

DexScreener token profiles/search/pairs digunakan sebagai primary source. Jika provider gagal, adapter fallback mock menjaga bot tetap hidup, tetapi source akan terlihat sebagai mock.

## Risk Management Flow

- Paper trading default.
- Live trade perlu `TRADING_MODE=live`, `TRADE_EXECUTOR_URL`, dan `TRADE_EXECUTOR_TOKEN`.
- Semua trade perlu konfirmasi Telegram.
- Score tinggi tetap bukan jaminan profit.
- Low liquidity, sell pressure, pair terlalu baru, dan candle parabolic memberi penalti.

## Database Design

- `MemeToken`: token identity per chain.
- `MemeAnalysis`: snapshot signal.
- `MemeScanRun` dan `MemeScanItem`: hasil scanner.
- `TradeOrder`: quote/execution snapshot.
- `Position`: paper/live position state.
- `WatchlistItem`: token favorit user.
- `AlertRule`: alert price, volume, score, liquidity.

## System Architecture

Telegram bot dan API memakai package core yang sama. Provider-adapters mengisolasi DexScreener, AI, dan trade executor. Worker menangani scan/analysis/alert background via Redis/BullMQ.

## Queue Architecture

- `meme-scan`: scan kandidat background.
- `meme-analysis`: analisis token background.
- `alert-scan`: evaluasi alert database-backed.

## Telegram UI Example

```text
Meme Coin Trading Bot
Scanner | Top Picks
Analisis BONK | Analisis WIF
Watchlist | Alerts
Positions | Settings
```

## Signal Card Example

```text
Token: BONK
Action: WAIT
Confidence: 66%
Score: 71/100
Risk: High
Liquidity: $1,850,000
Volume 24h: $43,000,000
Warnings:
- Meme coin bisa rug-pull.
- Jangan market buy saat candle parabolic.
```

## Security & Risk Disclaimer

Bot tidak menyimpan secret di kode. Live executor harus berada di service terpisah, memakai bearer token, audit log, dan limit transaksi. Analisis bukan nasihat keuangan.

## Development Roadmap

1. Scanner dan paper trade MVP.
2. Persist scan/trade/positions ke PostgreSQL.
3. Alert scheduler dan Telegram notification.
4. Rug-check, holder distribution, liquidity lock, dan honeypot provider.
5. Live executor hardening dan audit.