📈 Binance Futures Trading Dashboard

A full-stack Binance Futures trading dashboard with real-time price data, order execution, position tracking, and automated trading strategies.

---

✨ Features

• Live Trading — Market & Limit orders via Binance Futures Testnet
• Real-time Data — Live price feed, balance, and position updates
• Position Tracking — Monitor open positions, P&L, and liquidation prices
• Order Management — View and track open orders
• Trading Strategies — TWAP and Grid strategy automation
• Dark / Light Theme — Persistent theme with instant toggle
• Wallet Overview — USDT balance and account info

---

🗂️ Project Structure

Binanace/
├── backend/          # FastAPI REST API
│   └── app.py
├── frontend-next/    # Next.js 15 + Tailwind CSS v4
│   └── src/
├── trading/          # Binance API client & order logic
├── strategies/       # TWAP & Grid trading strategies
├── utils/            # Logger & formatters
├── config.py         # API keys & settings
└── main.py           # CLI entry point

---

🚀 Quick Start

1. Clone & Setup Python

git clone https://github.com/yourusername/binanace.git
cd binanace
python -m venv venv
venv\Scripts\activate        # Windows
source venv/bin/activate     # Mac/Linux
pip install -r requirements.txt

2. Configure API Keys

cp .env.example .env

Edit .env with your Binance Testnet credentials:

BINANCE_API_KEY=your_testnet_api_key
BINANCE_SECRET_KEY=your_testnet_secret_key
TESTNET=True

Get free testnet keys at: https://testnet.binancefuture.com

3. Start Backend

python -m uvicorn backend.app:app --reload --port 8000

API available at http://localhost:8000

4. Start Frontend

cd frontend-next
npm install
npm run dev

Dashboard available at http://localhost:3000

---

🔌 API Endpoints

Method	Endpoint	Description
GET	/balance	USDT futures balance
GET	/price/{symbol}	Live price for symbol
GET	/orders	Open orders
GET	/positions	Open positions
GET	/account	Account info
GET	/status	Combined status (fast load)
POST	/order	Place market/limit order

---

🤖 CLI Usage

python main.py

---

🛠️ Tech Stack

Layer	Technology
Frontend	Next.js 15, React 19, TypeScript
Styling	Tailwind CSS v4, CSS Variables
State	Zustand with persistence
Backend	FastAPI, Python 3.x
API	Binance Futures Testnet
Charts	Recharts

---

_{Built with ❤️ using Binance Futures Testnet}