# MVP Requirements – AI Trading Bot (BTCUSDT Futures)

**Client:** Must Finance Technologies
**Prepared by:** Balpreet Singh
**Date:** 2026-05-08
**Budget:** ₹70,000
**Timeline:** 15 days – 1 month

---

## 1. Overview

Build an AI-driven crypto trading platform that executes trades on Binance Futures (BTCUSDT only) using Claude AI for trading decisions. The platform consists of an Admin Panel (where the AI trades the house capital) and a User Panel (where users can copy-trade by connecting their own Binance API keys).

## 2. Goals

- Automate intraday scalping on BTCUSDT futures using Claude AI.
- Allow the admin to monitor live trades, history, and P&L.
- Allow end users to mirror the AI's trades on their own Binance accounts via API.
- Keep the design minimal — functionality first.

## 3. Scope

### In-scope
- Single trading pair: **BTCUSDT** (Binance Futures, USDT-M).
- Trading mode: **Futures only**, leverage **2x – 125x** (AI-decided).
- Timeframes: **1m, 3m, 5m, 15m, 30m** (intraday scalping).
- Claude AI (paid) integration via API or email-linked subscription.
- Admin Panel + User Panel + Copy-trading.
- Trade-only Binance API permissions (no deposit / no withdrawal).
- Risk toggle: **Low / Medium / High** (controls AI aggressiveness).
- Per-trade stop loss: **10% of capital** (predefined safeguard).
- Take profit: **maximum possible** (AI-driven).

### Out-of-scope (MVP)
- Spot trading.
- Multi-pair trading.
- Deposit / withdrawal flows / P2P transfers.
- TradingView / Pine Script integration (deferred — Binance data is sufficient for now).
- Custom Python algos (deferred).
- Mobile app.

## 4. User Roles

### 4.1 Admin
- Connects Claude AI (paid) — via API key or linked email.
- Connects house Binance account (Trade-only API).
- Funds USDT-M Futures Wallet — this is the margin pool the AI trades from.
- Sees full dashboard: live positions, history, P&L graph, capital deployed.
- Configures the **risk toggle** (Low / Medium / High).

### 4.2 User
- Registers / logs in.
- Connects their own Binance Futures API (Trade-only permission).
- Toggles "Copy AI trades" on/off.
- Sees their own dashboard: their trades (mirrored), their P&L.

## 5. Functional Requirements

### 5.1 AI Trading Engine
- Connects to Claude AI to receive trade signals/decisions.
- Inputs: Binance market data (price, candles for 1/3/5/15/30 min), open positions, available margin.
- AI decides: entry, exit, leverage (2x–125x), position size, direction (long/short).
- Risk toggle modulates AI behavior:
  - **Low** → conservative leverage, smaller size, tighter stops.
  - **Medium** → balanced.
  - **High** → aggressive leverage and size.
- Hard safeguard (outside the AI): **10% of capital stop-loss per trade**.
- Take profit: AI-determined (no upper cap).

### 5.2 Binance Integration
- API: Binance Futures REST + WebSocket.
- API permissions required: **Read + Futures Trade only** (no withdrawal).
- USDT-M Futures Wallet is the only margin source.
- Order types: Market / Limit / Stop-loss as needed by AI.

### 5.3 Admin Panel
- **Connections page:** Claude AI status, Binance API status.
- **Live Trades:** open positions with entry, leverage, unrealized P&L, current price.
- **Trade History:** closed trades — entry/exit, size, leverage, realized P&L, duration.
- **P&L Graph:** profit/loss over time (cumulative + per-trade) — minimal design.
- **Capital Deployed:** how much margin is currently in open positions vs free.
- **Risk Toggle:** Low / Medium / High.
- **Start / Stop AI** trading switch.

### 5.4 User Panel
- **Onboarding:** sign up, connect Binance API (Trade-only).
- **Copy-trade toggle:** ON/OFF.
- **Allocation control:** fixed % of their wallet to mirror per trade (sane default, e.g., proportional to admin sizing).
- **My Dashboard:** open positions, trade history, P&L graph.
- View-only of admin's strategy performance (so user can decide whether to copy).

### 5.5 Copy-Trading Logic
- When AI opens a trade on the admin account, the same trade is mirrored on each user with copy-trade ON, scaled to their wallet.
- Same applies to closes / SL / TP.
- Failure on a user's side (e.g., insufficient margin) does not block the admin trade or other users.

## 6. Non-functional Requirements

- **Latency:** trade mirroring should fire within seconds of admin trade.
- **Reliability:** if Binance API fails, retry with backoff; surface errors in dashboard.
- **Security:**
  - API keys stored encrypted at rest.
  - Only Trade permission required — reject keys with Withdraw enabled.
  - Per-user isolation; one user cannot see another's keys or trades.
- **Auditability:** every trade (admin + user mirror) logged with timestamp, signal source, AI rationale snippet if available.
- **Design:** minimal, functional — visuals are not the priority.

## 7. Risk & Safeguards

| Layer | Safeguard |
|---|---|
| Per-trade | 10% capital stop-loss (hard rule, outside AI) |
| Risk profile | Low / Medium / High toggle caps leverage and size |
| API | Trade-only keys; reject withdrawal-enabled keys |
| User-side | Each user can pause copy-trading instantly |
| Admin-side | Master Stop button halts all AI trading immediately |

## 8. Open Items / Deferred

- Pine Script / TradingView signal ingestion — defer; revisit after MVP.
- Custom Python strategy layer — defer.
- Additional pairs beyond BTCUSDT — defer.
- Revenue / profit-sharing model with the client — to be agreed separately.

## 9. Deliverables

1. Admin Panel (web).
2. User Panel (web) with copy-trading.
3. Binance Futures + Claude AI integration.
4. Risk toggle + 10% per-trade stop-loss safeguard.
5. P&L graphs and trade history for admin and users.
6. Deployment + handover documentation.

## 10. Commercials

- **Quote:** ₹70,000 (one-time build).
- **Timeline:** 15 days – 1 month from kickoff.
- **Billed to:** Must Finance Technologies.
- Open to **revenue / profit sharing** post-MVP as the platform scales.