BOVOBot settings guide
Settings with a clear purpose.
Configure BOVOBot in a controlled sequence: account and route first, followed by capital, markets, signals, protection, and evaluation.
Community Edition 0.1.0.38
These defaults are examples, not recommendations.
The downloadable edition contains KuCoin Standard Futures only. Lead Trade, the Lead API, and Lead authorization are technically disabled. The following values apply only to a new local installation; existing databases and saved settings are not replaced.
- BTC whitelist
- Only BTC is enabled on first installation. This enables a market; it is not an automatic entry signal. Additional symbols are considered only after you deliberately add them. Market selection
- Initial Order: 20 USDT
- 20 USDT is the base amount for the first entry. At 20x leverage, this can produce nominal exposure of up to approximately 400 USDT before fees, slippage, and exchange limits. Base amount
- Leverage: 20x
- Leverage magnifies both gains and losses. 20x does not mean 20 times more safety or profit; it means substantially less distance from critical loss and liquidation levels. High risk
- DCA multiplier: x1
- A multiplier of x1 leaves the calculated DCA base size unchanged. It does not define the number or price spacing of DCA steps and does not guarantee execution. Size factor
- Safe Order multiplier: x1
- The Safe Order also uses the base factor. The open position, available margin, contract rules, and exchange maximum must still permit the actual order. Size factor
- Trailing Start: 0.50%
- From a positive distance of 0.50%, the trailing logic can begin monitoring the achieved move. Fees, rounding, and the actual execution price affect the real result. Activation
- Retracement: 0.10%
- If the relevant move retraces by the configured amount after activation, an exit may be triggered. A fast market can result in a different execution price. Retracement
- Boost: active from 0.52%
- The default increases target leverage by 5x, from 20x to no more than 25x. The actual limit remains constrained by the exchange. Boost increases risk and must be reviewed explicitly before the first start. Additional risk
Review in this order before the first start
- API: allow Futures trading and read access only; keep withdrawal permissions disabled.
- Market: confirm that only BTC is on the whitelist.
- Capital: review the 20 USDT base amount and potential total capital commitment, including DCA and Safe Orders.
- Risk: reduce or disable 20x leverage and Boost from 0.52% before starting if necessary.
- Exit: review Trailing Start at 0.50% together with Retracement at 0.10%.
- Monitoring: keep the bot and KuCoin account open side by side during the first run.
Standard Futures window
Every visible setting, explained in context.
Every public Standard Futures field is grouped by purpose. Values interact with one another; saving alone does not send an order.
Route and market
What is allowed to operate?
- Use Standard KuCoin Futures
- Activates the only trading route included in the public Community Edition. The public build contains no Lead Trade or bound-account authorization. Route enablement
- Quote Currency
- Sets the settlement and symbol currency, here USDT. This value does not automatically determine the account type, availability, or currency conversion. Market basis
- Trading Whitelist
- Only listed symbols are allowed for monitoring and trading. A small, well-understood selection is easier to control than a full scan. Market enablement
- Add / Remove
- “Add” adds a ticker; “Remove” removes the selected market from the enabled list. Changes become permanent only after “Save Settings”; existing open positions remain unaffected. List management
Capital and size
How large can the exposure become?
- Initial LONG / Initial SHORT
- Separate quote-margin inputs for each direction. A SHORT hedge always starts from Initial SHORT; a LONG hedge starts from Initial LONG. Directional margin
- Long Leverage / Short Leverage
- Independent requested leverage for each side. Leverage changes exposure, while margin caps and the exchange maximum still apply. Side risk
- Maximum Open Coins
- Limits the number of symbols active at the same time. This value must align with the Initial Order, reserves, and potential additional capital commitment. Concurrency limit
- Maximum Quote per Coin
- Upper limit for total quote allocation per coin. It includes not only the first entry but the planned total path for that symbol. Coin limit
- Maximum Capital Usage %
- Limits the total share of route capital that may be committed. A reserve remains important for fees, market movement, and protection actions. Route limit
DCA, Safe Order, and hedge
How are additional actions scaled?
- Parallel Live Tests
- Sets the number of parallel analysis test runs. These tests send no orders, but they can increase CPU, database, and data-fetch load. Analysis load
- DCA Multiplier
- Scales the calculated DCA quantity. x1 leaves the base unchanged; the factor does not automatically limit the number of steps or the total position. DCA factor
- Safe Order Multiplier
- Scales the calculated Safe Order or protection quantity independently of the DCA factor. Available margin, position size, and exchange rules must still permit the order. Safe Order factor
- Fixed hedge margin
- The hedge multiplier is fixed internally at x1. Hedge margin comes only from the configured initial value of the side being opened and is not increased by unrealized PnL. Deterministic sizing
- DCA Distance %
- Controls the distance between additional entries. Tighter spacing can consume reserves faster; wider spacing leaves the position longer without another step. Price distance
- Protection Distance %
- Defines the configured distance for position protection logic. It is not a guaranteed stop or execution price and requires sufficient capital and valid exchange limits. Protection distance
Trailing and Step Recompounding
LONG and SHORT progress independently.
- LONG Profit Step %
- Once LONG reaches this minimum profit, the bot must first obtain an accepted LONG trailing stop. Only then can the first LONG recompounding step become eligible. LONG activation
- SHORT Profit Step %
- SHORT works symmetrically in the falling-price direction: the SHORT trailing stop must be accepted at minimum profit before the first SHORT recompounding step can execute. SHORT activation
- Derived retracement
- The trailing retracement is derived from the directional Profit Step. A 0.50% step derives a 0.10% retracement for that side. Side-specific
- Enable Step Recompounding
- Every confirmed boost stores its own LONG or SHORT anchor. The next boost requires another full favorable Profit Step and never unlocks from the opposite side trailing stop. Independent sequence
- Boost Leverage
- Adds the configured leverage step only after trailing protection, available-capital checks, the exchange maximum and the projected minimum-profit exit all pass. Higher leverage increases liquidation sensitivity. High risk
Save behavior: “Save Settings” stores the reviewed values but does not by itself send a market order. “Cancel” discards unsaved changes.
Learn more about risk and protectionNew hedge system
Profit-Locked Hedge Release, step by step.
The optional system manages a LONG-primary position and its paired SHORT hedge. Once a valid LONG trailing stop is accepted and synchronized, the paired SHORT must be released even if its PnL is negative.
Sizing
Each side uses its own initial margin.
Initial LONG and Initial SHORT are independent. A hedge uses exactly the configured initial margin of the direction it opens, converted with that side leverage and capped by KuCoin.
Arming
A valid synchronized LONG trailing stop is the release condition.
The projected LONG and SHORT results still include fee cap, funding and accrued costs, slippage cap and Minimum Profit %. These values determine whether the release is profit-safe or a bullish risk override; a negative SHORT or basket does not block the close attempt.
Confirmation
SHORT disappearance is confirmed before the LONG boost.
The bot reads a fresh full ask-side order book for the complete SHORT and calculates best bid, best ask, spread, VWAP, worst ask and the exact depth gap. If the LONG trailing order fills first, the confirmed LONG exit continues to drive the remaining SHORT close.
Full FOK release
The complete SHORT is attempted; partial closes are forbidden.
One full reduce-only FOK limit order is submitted from the fresh order book. If the profit-safe boundary is not met, the bullish risk override still requires the attempt. If depth moves or the order cannot fill completely, FOK cancels it and the bot retries from fresh state. Only after the SHORT is gone may the LONG boost proceed and re-arm the full trailing quantity.
Two separate exchange positions cannot be closed atomically. Technical FOK rejection, incomplete order-book depth or delayed exchange synchronization can postpone the SHORT release. The bot retries, but this control cannot guarantee fills, profit or protection from liquidation.
Settings sections
From connection to evaluation.
The sections follow a sensible setup sequence for a new system. Changes to capital and execution should always be deliberate and made one at a time.
01 · Account and route
First validate the local Standard Futures connection.
The public Community Edition contains one Standard route. Lead Trade and private account authorization are absent.
- Standard API
- Connects regular KuCoin Futures access. Key, Secret, and Passphrase must belong to the same API credential set; withdrawal permissions remain disabled. For Standard Futures
- Public profile
- Lead Trade, Lead API, account binding and broker attribution are not compiled into this public package. Community Edition
- Local credentials
- API Key, Secret and Passphrase are entered only on the user-controlled system and must belong to one Standard credential set. Never send to the website
- Route status
- Shows whether the Standard API is validated and its route is ready. Before every start
02 · Capital and limits
Limit exposure before enabling signals.
Capital planning and position limits determine how much operating scope the bot receives.
- Capital allocation
- Defines the portion of available Futures capital allocated to the bot. A reserve prevents every available unit from being committed. Overall limit
- Base order size
- Defines the first position size. It should remain within the selected capital limit even with multiple simultaneous positions. Per entry
- Leverage
- Increases market exposure and risk. Higher leverage reduces the distance to critical loss levels. Risk driver
- Maximum positions
- Limits how many markets may commit capital at the same time. This value must fit the order size and reserve. Portfolio limit
- Additional-order budget
- Reserves capital for planned recovery or Safe Order steps. Without a reserve, a planned protection action may not be executable. Only when the strategy is active
- Capital Planner
- Checks whether order size, position limits, and reserve are mathematically consistent. It does not replace personal risk assessment. Consistency check
03 · Markets and signals
Define what is monitored and when a setup qualifies.
Market enablement limits the search space. Signals then determine which enabled markets qualify.
- Market whitelist
- Contains only the symbols BOVOBot may monitor and trade. A small selection is easier to control. Market enablement
- Timeframe
- Sets the candle resolution for charts and indicators. Shorter timeframes react faster and may contain more market noise. Analysis interval
- SignalScore
- Combines multiple market conditions into one score. A higher threshold requires stronger agreement. Entry filter
- Long and Short
- Controls which trading directions are allowed. Enable both directions only when they fit your setup. Direction enablement
- Auto-entry
- Allows automatic entries once score, route, and risk limits are satisfied. Observe the market display for stability before enabling it. Automation
- Coin-specific values
- Allow different rules for individual markets when volatility or contract structure requires separate treatment. Fine-tuning
04 · Protection and execution
Execution and protection must match the open position.
These settings affect real orders. Also verify their purpose and actual status directly in the KuCoin account.
- Safe Order
- Plans an additional order according to the selected strategy. Quantity and distance must fit the reserved capital. Recovery context
- Protection order
- Associates planned stop or exit orders with a position. Visible status helps identify missing orders early. Position protection
- Open Orders
- Shows unexecuted orders for each route and symbol. Zero open orders matters only when an open position is supposed to have protection. Exchange status
- Force Buy
- A deliberate manual order function. It does not bypass route, authorization, or broker checks. Manual command
- Loss protection on close
- Can restrict closes under configured conditions. It does not prevent liquidation by the exchange. Exit rule
- Profit-Locked SHORT release
- Once a valid LONG trailing order is synchronized, the complete paired SHORT close is attempted even with negative SHORT PnL; technical FOK and order-book conditions still apply. Bullish risk exit
05 · Testing and evaluation
Evaluate changes before increasing exposure.
Tests and learning metrics provide context. They are not forecasts or promises of profit.
- Live test
- Observes current market data using the selected rules without automatically deriving greater exposure. Current market
- Backtest
- Applies rules to historical data. Results depend on data quality, time period, and model assumptions. Historical context
- Indicator matrix
- Shows which component conditions contribute to a signal, making the score easier to interpret. Signal transparency
- Learning metrics
- Summarize past observations and results. They should be current and never used in isolation as a reason to trade. Additional information
- Reward evaluation
- Provides context for past decisions and helps compare changes over time. Development over time
- Change routine
- Change one area at a time whenever possible and observe the effect before adjusting additional parameters. Clear comparability
Recommended sequence
How to build a controlled initial configuration.
- 01Connect the Standard route
Enter your own Standard Futures credentials locally and validate the route status.
- 02Limit capital
Align order size, leverage, position limits, and reserve.
- 03Narrow the markets
Begin with a manageable whitelist and clear directions.
- 04Observe signals
Review SignalScore and indicators before enabling maximum automation.
- 05Monitor the first run
Actively compare positions, orders, and the exchange account during startup.
Before starting
The short checklist.
Continue to setup
Prepare the first start now.
The getting-started guide covers the API connection through the first controlled observation.