Glossary

Reference definitions
Definitions for terms used throughout the GridBT documentation. Jump to any term using the links below.

OPEN order

A limit order that increases your position size. For a long track, this is a buy order. For a short track, this is a sell order. OPEN orders build inventory.

CLOSE order

A limit order that decreases your position size. For a long track, this is a sell order. For a short track, this is a buy order. CLOSE orders take profit.
GridBT uses "OPEN" and "CLOSE" rather than "buy" and "sell" because the same action (buying) can open a long or close a short depending on which track is active.

Anchor price

The reference price around which the grid is centered. Set from market price when a symbol is first enabled and stored in the database. The bot does not require you to configure this - it is managed automatically.

Baseline

The bot's record of the expected position size based on grid fills it has tracked. Used by the rebalancer to detect drift. When you manually open a position on Bybit (outside the bot), your actual position becomes larger than the baseline, creating excess. When the bot missed fills during downtime, the actual position is smaller than the baseline, creating a deficit.

Coverage

How far price can move against you before one side of the grid runs out of inventory. Calculated from inventory slots and geometric grid spacing. Long coverage measures upside distance. Short coverage measures downside distance and cannot exceed 100%. See Position Sizing and Formulas.

Deficit

When your actual position is smaller than the baseline. Usually caused by the bot being offline and missing fills. The rebalancer corrects a deficit by slightly oversizing OPEN orders until position returns to baseline.

Effective leverage

abs(longUsd - shortUsd) / walletBalance. Your actual risk exposure in Bybit hedge cross margin. Long and short positions net each other, so only the difference between them drives leverage. A $1,000 long and $600 short with a $500 wallet produces ($1,000 - $600) / $500 = 0.8x effective leverage. Higher leverage means larger equity swings per price move. See Formulas.

Excess

When your actual position is larger than the baseline. Usually caused by manually adding to a position outside the bot. The rebalancer corrects excess by slightly oversizing CLOSE orders until position returns to baseline.

Extension

When price moves away from the current grid, the bot extends the grid by placing additional orders further out to maintain coverage. Extension is automatic and does not require configuration beyond extensionThreshold.

FIFO PnL (Realized PnL)

Profit or loss calculated using first-in-first-out accounting on your position entries. When the bot sells inventory that was bought at a higher price, FIFO PnL goes negative. This is normal and expected during down trends - it reflects the bot improving your average entry price. Bybit displays this as "Realized PnL." See Understanding PnL.

Grid reconstruction

When the bot tears down all outstanding orders for a symbol/mode and rebuilds the grid from scratch around the current price. Triggered by significant price moves, feature state changes (e.g., Hedge Guard activating), or cooldown expiry. Brief gap in coverage while reconstruction runs.

Hedge Mode (Bybit account setting)

A Bybit account-level setting that allows holding independent long and short positions on the same symbol simultaneously. Required for GridBT. Without it, opening a short would close your long. Different from GridBT's "Hedge Guard" feature. Enable it in Bybit account settings.

Imbalance

The difference between your actual position and the baseline. Expressed as a ratio: imbalance ÷ orderSizeUsd. When this ratio exceeds minTriggerRatio, the rebalancer activates.

Pure Grid Profits

GridBT's primary performance metric. The sum of profit from every completed buy-sell cycle: each matched pair earns spacingPct of the order value. Always positive - it can only go up. This is what the dashboard displays. Contrast with FIFO PnL which can be negative. See Understanding PnL.

Seed mode (seedMode)

A config flag that permanently disables rebalancing when set to true. With seedMode: true, the bot will never run deficit or excess correction regardless of position drift. Useful when you want to manage position size manually without the rebalancer intervening. The default is false (rebalancing enabled). See Config Reference.

Seeding / seed position

Manually opening initial long and short positions on Bybit before starting the bot. Required because the bot cannot open a position from scratch - it needs existing inventory to place counter orders against. See Quick Start → Step 2.

spacingPct

The percentage gap between adjacent grid levels. Default is 0.37 (0.37%). Each completed buy-sell cycle at this spacing captures 0.37% of the order value as profit. Lower spacing = more frequent fills, smaller profit per cycle. Higher spacing = less frequent fills, larger profit per cycle. See How GridBT Works and Config Reference.

UTA (Unified Trading Account)

A Bybit account type that pools margin across all positions. Long and short positions share the same collateral, so long profits reduce net margin requirements for shorts and vice versa. Required for GridBT. See What is Grid Trading?.