Glossary

Common terms used throughout Botmarley and cryptocurrency trading.

A

Action A trading command defined in a strategy: open_long (enter position), buy (DCA), or sell (exit).

Apache Arrow A columnar data format used by Botmarley to store historical candle data. Provides fast read/write performance for time-series data.

ATR (Average True Range) A volatility indicator that measures the average range between high and low prices over a period. Higher ATR means more volatile market.

Average Price / DCA Dollar-Cost Averaging — buying additional amounts at different price levels to reduce the average entry price of a position.

B

Backtest Running a strategy against historical market data to evaluate its performance without risking real funds.

Bollinger Bands A volatility indicator consisting of three lines: a middle SMA, an upper band (SMA + 2 standard deviations), and a lower band (SMA - 2 standard deviations).

Broadcast Channel An internal Rust channel that distributes trade action notifications to multiple consumers (web SSE, Telegram bot).

C

Candle (Candlestick) A data point representing price movement over a time period, containing: open, high, low, close, and volume.

Cross Above / Cross Below A signal that occurs when one value (e.g., fast EMA) moves from below to above (or above to below) another value (e.g., slow EMA).

D

DCA (Dollar-Cost Averaging) See Average Price.

Drawdown The peak-to-trough decline in portfolio or position value, usually expressed as a percentage.

E

EMA (Exponential Moving Average) A moving average that gives more weight to recent prices, making it more responsive than a Simple Moving Average.

Engine The TradingEngine — the core component that evaluates strategy triggers against live market data and executes actions.

H

HTMX A JavaScript library that allows server-driven HTML updates via HTML attributes (hx-get, hx-swap). Used by Botmarley for dynamic page updates without a JavaScript framework.

K

Kraken A cryptocurrency exchange supported by Botmarley for live trading and market data.

L

Lightweight Charts A charting library by TradingView used by Botmarley to render candlestick charts in the browser.

Lookback The number of historical candles considered when evaluating a trigger or indicator.

M

MACD (Moving Average Convergence Divergence) A momentum indicator showing the relationship between two EMAs (12-period and 26-period). Consists of a MACD line, signal line, and histogram.

max_count A trigger parameter that limits how many times the trigger can fire per position.

max_open_positions A strategy setting that caps the number of concurrent open positions.

MiniJinja A Rust template engine (similar to Jinja2) used by Botmarley to render HTML pages on the server.

O

OBV (On Balance Volume) A volume indicator that adds volume on up-days and subtracts on down-days, helping confirm price trends.

Open Position An active trade that has been entered but not yet closed.

P

Pair (Trading Pair) Two assets that can be traded against each other (e.g., XBTUSDT = Bitcoin vs Tether).

Paper Account A simulated account for testing strategies without real funds.

PnL (Profit and Loss) The net gain or loss from a trade or trading session, expressed as an absolute amount or percentage.

Position A trade — from entry (buy) to exit (sell). Can include multiple DCA entries.

R

ROC (Rate of Change) A momentum indicator measuring the percentage change in price over a specified period.

RSI (Relative Strength Index) A momentum oscillator (0–100) that measures the speed and change of price movements. Below 30 is considered oversold, above 70 is overbought.

Rule In Botmarley strategies, a rule is an action combined with its triggers.

S

Session (Trading Session) An instance of a strategy running against a specific trading pair on a specific account. Can be started, paused, resumed, or stopped.

SMA (Simple Moving Average) The arithmetic mean of closing prices over a specified period.

SSE (Server-Sent Events) A web technology for pushing real-time updates from server to browser over HTTP. Used by Botmarley for live trading updates.

Stochastic RSI A momentum indicator that applies the Stochastic formula to RSI values, providing a more sensitive oversold/overbought signal than standard RSI.

Strategy A set of trading rules defined in TOML format that tell Botmarley when to buy and sell.

T

Task Queue A background job system in Botmarley that handles long-running operations (backtests, data downloads, account syncs) without blocking the web interface.

Timeframe The duration of each candle: 1m (1 minute), 5m, 15m, 1h, 4h, 1d.

TOML Tom's Obvious Minimal Language — the configuration format used for defining strategies in Botmarley.

Trailing Stop An order type that follows the price in the profitable direction and triggers a sell when the price reverses by a specified percentage.

Trigger A condition that must be met for a strategy action to execute. Multiple triggers per action use AND logic.

TTM Trend A trend indicator that provides directional signals.

W

Win Rate The percentage of trades that were profitable. Calculated as (winning trades / total trades) x 100.