Set Up Your Trading Agent
Step by Step

The agent lives on your own machine or VPS — Quantilan never touches your API keys or funds.

• Go to github.com/Quantilan/trading-agent and copy the HTTPS clone URL
• Run git clone https://github.com/Quantilan/trading-agent.git
• Or download the ZIP and unzip to any folder

Run make start (or docker compose up) and open 127.0.0.1:8000 in your browser.

The GUI has six collapsible sections — fill them top to bottom. The Readiness panel at the bottom shows which checks have passed.

Paper mode simulates trades using real market data — no API keys needed, zero risk. Perfect to verify everything works first.

When you're ready to trade with real funds, switch to Trade (Real Orders).

Four exchanges supported out of the box:

• Binance USD⑤-M Futures
• Bybit Linear Futures
• Hyperliquid Perps
• OKX Swap

Paste your exchange API Key and Secret. Keys are stored locally in your .env file — never sent to Quantilan servers.

• Create API keys on your exchange with Futures trading permission only
• Disable withdrawal permissions for extra safety
• IP-whitelist your VPS address if the exchange supports it

Click Test Public API — the agent checks connectivity and lists all 33 supported coins.

A green Connection successful toast confirms you're good to go. Any error here means a network or key permission issue — not a trading risk.

For live mode: click Run Test to execute a full mini-cycle — open a small position, adjust the stop-loss, then close it. The live log shows each step in real time.

• Confirms your API keys have the right permissions
• Costs roughly 2× exchange fee (~0.05% × 2)
• Takes about 5 seconds

Five sliders control your risk profile. No manual position sizing — the agent calculates everything automatically from these settings:

• Margin per trade — % of balance per position (e.g. 4%)
• Max leverage — cap on exchange leverage (e.g. 5×)
• Max open positions — total concurrent trades allowed
• Default Stop-Loss % — fallback SL if signal doesn't specify
• Default Take-Profit % — fallback TP (0 = disabled)

The agent talks to you through a private Telegram bot you create yourself — no third-party access.

• Message @BotFather → /newbot to create a bot and get the token
• Get your Chat ID from @userinfobot
• Paste both into the GUI, click Test Bot

Two modes for receiving trade signals:

• Quantilan Server — connect with a license key to receive curated algo signals automatically
• Telegram — forward messages from any channel or type commands yourself; choose Regex (fast) or LLM (flexible) parser

On every trade event — open, close, or stop adjustment — the agent sends a candlestick chart to your Telegram showing the position: entry price, stop-loss, and take-profit levels.

• Choose timeframe: 5m / 15m / 1h / 4h
• Choose candle count: 25 / 50 / 75 / 100

The Readiness panel shows green checkmarks for each validated component. When all required checks pass:

• Click Save .env to write your config to disk
• Click Start Agent — the agent is now live
• From this point, manage everything from Telegram