FluxTrade guide

Platform documentation

DCA & Grid bots, SmartTrade, futures, webhooks, paper trading, and secure exchange APIs.

Introduction

FluxTrade is a crypto trading automation platform (3Commas-style) for multi-exchange bots and terminals.

  • DCA, Grid, Signal (webhook), and SmartTrade bots
  • Spot & futures (long/short + leverage)
  • Paper and Live modes
  • CCXT multi-exchange connectivity
  • Live deals, trade history, Telegram alerts

Quick start

  1. 1
    Sign in
  2. 2
    Test risk-free
    Open Spot or Futures in Paper mode.
  3. 3
    Connect API (optional)
    Add a Trade-only key under Exchanges.
  4. 4
    Create a bot
    Build DCA/Grid/Signal on New bot and Start it.
Always test strategies on Paper before going Live.

Sign-in

Authentication is Google Sign-In only. Session is stored in a secure JWT cookie. Sign out is available in the sidebar and mobile header.

Exchanges & API

Path: /exchanges

  • Pick a CCXT exchange and add API key + secret (+ passphrase when required)
  • Enable Trade only — disable Withdraw
  • Use Test connection to verify balances
  • Paper mode only needs a public price source exchange
Keys are encrypted with AES-256-GCM. Never share withdraw-enabled keys.

Paper & Live

Paper

Simulated balance, real market prices. No orders on the exchange.

Live

Real market orders via your API. Capital is at risk.

Spot trading

Path: /trade — market buy/sell by quote or base size, live price, trade history.

SmartTrade

Path: /smart-trade

Market entry plus take profit, stop loss, trailing TP/SL, and partial close. Worker monitors and exits automatically.

Futures

Path: /futures — perpetual long/short, leverage 1–125×, isolated/cross display, paper equity and liquidation estimate.

Futures are high risk. Liquidation estimates are approximate (no exact funding/fees).

Portfolio & deals

Bots

List: /bots · Create: /bots/new

DCA

Base + safety orders + TP/SL + trailing

Grid

Buy lower / sell higher in a range

Signal

Webhook buy/sell/close

Manual / Futures / Smart

Terminals auto-created

Controls: Start · Pause · Resume · Stop · Clone · bulk Pause/Stop all.

DCA strategy

Base order, safety orders on dips, take profit from average entry, optional fixed SL and trailing stop/TP. Ladder status is visible on the bot detail page.

Grid strategy

Define lower/upper range, levels, investment, geometric or arithmetic spacing. Idle outside range.

Signal / Webhook

Create Signal bot → Start → copy webhook URL into TradingView.

{"action":"buy"}
{"action":"sell"}
{"action":"close"}
{"action":"buy","quote":100}

Bot detail

Path: /bots/[id] — live strip, levels, trade history (filters/CSV), deals, live logs.

Telegram alerts

Path: /settings/telegram

Requires server TELEGRAM_BOT_TOKEN. Events: deal open/close/partial, TP, SL, errors.

Billing

Path: /billing — plan, trial, crypto invoices (admin confirm). FREE_MODE may unlock all users when enabled on the server.

Security

  • AES-256-GCM for API secrets
  • HttpOnly JWT cookie sessions
  • Rate limits on trading endpoints
  • Unique long webhook tokens

FAQ

Can I start without an API key?
Yes — Paper only needs public market data.
Spot vs futures?
Spot buys/sells assets. Futures are leveraged long/short positions.
Worker offline?
If bots are RUNNING but ticks are stale, check the fluxtrade-worker service.

Limits

  • Primarily market orders (not full limit-order books)
  • Futures liquidation is approximate
  • Funding rates not fully modeled
  • Exchange min-notional rules still apply in Live

Ready to start?

Begin with Paper, validate the strategy, then enable Live carefully.