Docs

Core Concepts

Understand Gunbot Live core concepts before configuring automation: instances, bots, pairs, strategies, API keys, orders, balances, exposure, and risk.

See features
Everything included - $29/mo
Short answer

Gunbot Live is easier to use when terms are clear: an instance is a connected Gunbot environment, a strategy defines trading rules, a pair defines the market being traded, and risk concepts such as exposure and drawdown describe what can go wrong during automated operation.

Operating Concepts

Instance: a connected Gunbot environment or setup. This is a program you run on a Windows, Linux, MacOS or ARM device. Bot: the automation process running strategy logic. Strategy: a set of rules and parameters used by the bot. Custom strategy: you JavaScript strategy logic and metadata surfaced in the frontend when supported. Trading pair: the market being traded, such as USDT-BTC in Gunbot naming or BTC/USDT in common exchange notation. Exchange account: the exchange-side account and API permissions used by a setup.

Trading State Concepts

Open order: an order submitted but not fully filled. Filled order: an executed order that changed balance or position. Balance: available or wallet funds reported by the connected account. Portfolio value: the aggregate value shown by the dashboard when your setup provides the data. Exposure: capital currently at risk in open positions or orders. Drawdown: decline from a prior wallet or equity peak.

Testing And Execution

Backtest: a historical simulation with assumptions for spot or futures markets when supported. Live trading: trading against current market and exchange conditions. Copy trading: following or purchasing strategy activity when the module is enabled. Arbitrage: a workflow that reviews spot or futures market differences but still carries execution risk; the spot and futures arbitrage workflow explains its execution limits. Autoconfig: rules that can adjust selected settings as market conditions change. Manual override: your intervention through available controls or exchange-side actions.

Automation Failure Modes

Most automation failures are ordinary operational problems: an exchange outage, a rate limit, the wrong pair, the wrong market type, a strategy setting that no longer fits the market, a custom code error, missing balance, missing margin, a network interruption, or a copied signal or arbitrage assumption that was not understood before use.

External references

FAQ

Why define pair notation?

Gunbot and exchanges may display pairs differently. Misreading base and quote assets can cause wrong market selection.

Is drawdown the same as realized loss?

No. Drawdown measures decline from a peak and can include unrealized changes depending on the metric.

Last updated: