# Affiliate Partners Source: https://docs.quantumvoid.org/affiliates Sign up with our partner exchanges for exclusive benefits **5% cashback on trading fees** Leading CEX with advanced futures trading, low fees, and excellent liquidity. * Spot & Futures trading * Up to 150x leverage * Advanced order types * 24/7 customer support **Sui-based perpetual DEX** Decentralized perpetual futures exchange built on Sui blockchain. * On-chain perpetuals * Non-custodial trading * Low gas fees on Sui * Deep liquidity pools **Leading derivatives platform** One of the world's largest crypto derivatives exchanges. * Spot, Futures & Options * Up to 100x leverage * Industry-leading security * Copy trading features ## Why Use Affiliate Links? Get special perks like cashback on fees, reduced trading costs, and priority support when signing up through our links. Using affiliate links helps fund VOIDX development and keeps the platform free for PUMPKIN holders. All listed exchanges are verified partners that we actively use and recommend for automated trading. Partner exchanges often provide enhanced API limits and better support for affiliated users. ## Getting Started Select an exchange from the cards above based on your needs Click the referral link and complete registration Complete KYC verification if required Generate API credentials for bot trading Add your exchange credentials in the dashboard Always verify you're on the official exchange domain before entering credentials. Never share your API keys or secrets with anyone. ## Exchange Comparison | Feature | BloFin | Bluefin | Bybit | | ----------------- | ----------- | --------------- | ------------- | | Type | CEX | DEX | CEX | | KYC Required | Yes | No | Yes | | Max Leverage | 150x | 25x | 100x | | Trading Fees | 0.02% | 0.03% | 0.055% | | Affiliate Benefit | 5% cashback | Trading rewards | Fee discounts | | Bot Support | ✅ Full | ✅ Full | ✅ Full | Ready to set up your first bot? Follow our quick start guide # Bot Configuration Source: https://docs.quantumvoid.org/bot-configuration Complete guide to configuring your trading bot parameters # Bot Configuration Parameters Understanding bot configuration parameters is essential for optimizing your trading strategy. This guide covers all parameters for both single-symbol and multi-symbol configurations. **Multi-symbol configs** give you more control and allow per-symbol customization. Single-symbol configs are simpler but less flexible. ## Core Strategy Parameters ### Grid Configuration **Number of grid clusters** - How many layers of orders to place on each side * **Conservative**: 2-3 clusters (fewer, safer positions) * **Moderate**: 4 clusters (balanced approach) * **Aggressive**: 5+ clusters (more positions, more risk) **Outer grid distance** - How far from current price to place the furthest orders (as decimal) * `0.03` = 3% from current price * `0.04` = 4% from current price (recommended) * `0.05` = 5% from current price Wider grids (0.04-0.05) work better in volatile markets **Grid distribution power** - Controls how grid orders are spaced * `1.0` = Linear spacing (equal distance between orders) * `1.2-1.4` = Slight geometric spacing * `1.6` = Strong geometric spacing (more orders near price) Higher values concentrate more orders near the current price. **First order distance** - Distance to the first grid order (as decimal) * `0.002` = 0.2% from price (tight) * `0.0025` = 0.25% from price (recommended) * `0.003` = 0.3% from price (wider) ### Grid Clustering Algorithms The Vortex DCA strategy supports intelligent grid placement using three different clustering algorithms. Each algorithm determines where to place your grid levels based on different market analysis methods. **Enable clustering** - Activate intelligent grid placement algorithms When disabled, uses traditional geometric grid distribution. **Clustering algorithm** - Choose how grid levels are calculated Available options: * `LINEAR` - Evenly-spaced geometric distribution (default) * `PEAKS_TROUGHS_HIGHLOW` - Historical support/resistance levels * `KMEANS` - Statistical price clustering zones #### LINEAR (Default) Traditional geometric grid distribution with equal spacing controlled by `ratio_power`. **Best for:** * Stable market conditions * Beginners learning grid trading * Assets with predictable volatility **Configuration:** ```json theme={null} { "clustering_enabled": true, "clustering_algo": "LINEAR" } ``` **Characteristics:** * No historical data required * Fast computation * Predictable, symmetric grid placement *** #### PEAKS\_TROUGHS\_HIGHLOW Analyzes historical price data to identify swing highs and lows, placing grid levels at proven support and resistance zones where price historically reversed. **Best for:** * Range-bound markets * Assets with clear support/resistance levels * Technical analysis-focused trading * Markets with strong price memory **Historical lookback period** - How far back to analyze price data Options: `1W`, `1M`, `3M`, `6M`, `1Y` * `1W-1M` = Responsive to recent market structure (altcoins) * `3M-6M` = Balanced, medium-term S/R levels * `1Y` = Long-term view (Bitcoin, major assets) **Candle timeframe** - Resolution of historical data Options: `1m`, `5m`, `15m`, `1h`, `4h`, `1d` * `1m-5m` = High precision, large datasets (liquid pairs) * `15m-1h` = Balanced precision and performance * `4h-1d` = Macro view, lighter data requirements **Configuration Example:** ```json theme={null} { "clustering_enabled": true, "clustering_algo": "PEAKS_TROUGHS_HIGHLOW", "clustering_period": "3M", "clustering_timeframe": "1m", "nr_clusters": 4 } ``` Use `3M` with `1m` timeframe for BTC - captures recent swing points with high precision *** #### KMEANS Uses K-Means machine learning algorithm to identify natural price consolidation zones where price historically spent the most time. Grid levels are placed at cluster centroids. **Best for:** * Volatile markets with consolidation zones * Assets that range-trade before breakouts * Finding hidden liquidity zones * Statistical/ML-based trading approaches **Configuration Example:** ```json theme={null} { "clustering_enabled": true, "clustering_algo": "KMEANS", "clustering_period": "1W", "clustering_timeframe": "5m", "nr_clusters": 6 } ``` **How it works:** 1. Collects closing prices from historical period 2. Uses K-Means to cluster prices into `nr_clusters` groups 3. Places grid levels at each cluster centroid 4. Levels naturally concentrate where price consolidated K-Means works best with shorter periods (1W-1M) for recent consolidation zones *** #### Choosing the Right Algorithm * You're new to grid trading * Market conditions are stable and predictable * You want consistent, geometric grid distribution * Historical patterns aren't reliable for the asset * Asset shows clear support/resistance levels * You trust technical analysis * Market is range-bound with defined levels * You want grids at proven reversal zones * Asset is highly volatile with consolidation zones * You want to find hidden liquidity areas * Traditional S/R isn't obvious visually * You trust statistical/ML approaches All clustering algorithms respect your `outer_distance` and `ratio_power` settings. Historical data is fetched once per grid refresh (default: 3 minutes). If data fetch fails, automatically falls back to LINEAR. *** ### Position Management **Wallet exposure per symbol** - Percentage of wallet to allocate per symbol * `0.05` = 5% per symbol (conservative) * `0.1` = 10% per symbol (recommended) * `0.15` = 15% per symbol (aggressive) With 6 symbols at 10% each = 60% total exposure. Keep total under 100%! **Initial entry size** - Size of first grid order as fraction of exposure * `0.005` = 0.5% of exposure * `0.01` = 1% of exposure (recommended) * `0.02` = 2% of exposure (larger first orders) **Quantity multiplier** - How much each successive grid order increases * `1.5` = Each order 50% larger than previous * `2` = Each order doubles in size (recommended) * `3` = Each order triples in size (aggressive DCA) ### Take Profit Settings **Minimum take profit** - Minimum profit percentage to close positions * `0.0015` = 0.15% profit (tight) * `0.0022` = 0.22% profit (recommended) * `0.003` = 0.3% profit (wider) Lower values = more frequent but smaller profits **Grid refresh threshold** - Price movement % needed to refresh grid * `0.03` = Refresh at 3% movement * `0.05` = Refresh at 5% movement (recommended) * `0.08` = Refresh at 8% movement **Grid refresh interval** - Seconds between grid recalculations * `120` = 2 minutes (frequent updates) * `180` = 3 minutes (recommended) * `300` = 5 minutes (less frequent) ## Risk Management ### Liquidation Protection **Enable liquidation safeguard** - Prevents orders too close to liquidation price **Highly recommended** - Always keep this enabled **Liquidation distance %** - Minimum distance from liquidation price * `5` = Orders must be 5% away from liquidation (recommended) * `10` = Extra safe, 10% buffer * `3` = Risky, only 3% buffer Never set below 5% - risk of liquidation increases significantly ### Virtual Chunking (Position Recovery) **Enable virtual chunking** - Advanced position recovery for underwater positions When enabled, splits large losing positions into smaller "chunks" for gradual recovery. **Chunking threshold** - Unrealized loss % that triggers chunking * `2` = Activate at 2% loss (aggressive recovery) * `3` = Activate at 3% loss (recommended) * `5` = Activate at 5% loss (conservative) **Number of chunks** - How many pieces to split position into More chunks = more granular recovery but slower **Chunk profit target** - Profit % for each chunk exit * `0.0008` = 0.08% profit per chunk (tight) * `0.001` = 0.1% profit per chunk (recommended) * `0.0015` = 0.15% profit per chunk ## Trading Modes **Enable long trades** - Allow bot to open long (buy) positions **Enable short trades** - Allow bot to open short (sell) positions Enable both for balanced trading. Markets trend up and down! **Always maintain both sides** - Keep grids on both long and short simultaneously Recommended: `true` for maximum opportunity capture ## BloFin-Specific Settings **Round to minimum quantity** - Automatically round order sizes to BloFin's minimum Always enable this for BloFin to avoid order rejections **Cleanup on startup** - Cancel all existing orders when bot starts Recommended: `true` to start with clean state ## Multi-Symbol Configuration Multi-symbol configs allow you to customize parameters per symbol in the `symbol_config` section. ### Example Multi-Symbol Config ```json theme={null} { "symbols": ["DOGEUSDT", "ADAUSDT", "SUIUSDT"], "symbol_config": { "DOGEUSDT": { "wallet_exposure": 0.1, "minimum_tp": 0.0025 }, "ADAUSDT": { "wallet_exposure": 0.08, "minimum_tp": 0.002 }, "SUIUSDT": { "wallet_exposure": 0.12, "minimum_tp": 0.003 } } } ``` ### Per-Symbol Parameters You can override these parameters per symbol: * `wallet_exposure` - Different allocation per coin * `minimum_tp` - Different profit targets per coin * `nr_clusters` - More/fewer grids per coin * `outer_distance` - Wider/tighter grids per coin Use higher exposure for stable coins (BTC, ETH) and lower for altcoins ## Advanced Parameters **Allow smaller additions** - Permit adding to positions with smaller orders Usually false - maintains consistent DCA scaling **Minimum order distance** - Closest two orders can be to each other Prevents orders from clustering too tightly **Desired grid spread** - Target total distance for grid Works with `outer_distance` to size the grid **No entry above price** - Don't open positions above this price Set to limit entries in overextended markets. Example: `50000` for BTC **No entry below price** - Don't open positions below this price Set a floor to avoid catching falling knives. Example: `30000` for BTC ## Configuration Tips Use smaller exposure (5-8%), fewer clusters (2-3), and tighter grids (0.02-0.03) when learning Increase exposure and clusters only after observing performance for several days Use 4-6 different symbols to spread risk. Avoid correlated pairs (e.g., all memecoins) Check bot performance daily. Adjust `minimum_tp` and `outer_distance` based on volatility Always use `liquidation_safeguard: true` with `liquidation_safeguard_pct_dist: 5` minimum ## Preset Configurations VOIDX provides pre-built configurations for different risk levels: * 2-3 clusters * 5-8% exposure * Tight grids * Lower leverage * 4 clusters * 10% exposure * Balanced grids * Standard leverage * 5+ clusters * 12-15% exposure * Wide grids * Higher leverage See all available presets in the Quick Start Guide *** **Always test with small amounts first.** Start with 1-2 symbols at low exposure, monitor for 24-48 hours, then scale up gradually. # Contact & Community Source: https://docs.quantumvoid.org/contact Get in touch with the VoidX team and join the community # Contact & Community Have questions, feedback, or want to connect with other traders? Here's how to reach us. *** ## Official Channels Join our Telegram group for real-time support, trading discussions, and platform updates. The fastest way to get help. Follow the official PUMPKIN token account for token updates, announcements, and community highlights. Follow the team behind VoidX for development updates, new features, and technical deep-dives. Explore the open-source components, report issues, and contribute to the project. *** ## Quick Links | Channel | Link | Best For | | --------- | -------------------------------------------------------------------- | ---------------------------- | | Telegram | [t.me/pumpkinsui](https://t.me/pumpkinsui) | Live support, community chat | | PUMPKIN X | [x.com/thepumpkintoken](https://x.com/thepumpkintoken) | Token news, announcements | | QV Labs X | [x.com/quantumvoidlabs](https://x.com/quantumvoidlabs) | Dev updates, new features | | GitHub | [github.com/donewiththedollar](https://github.com/donewiththedollar) | Code, issues, contributions | | Dashboard | [voidx.trade](https://voidx.trade) | Launch bots, manage vaults | | Docs | [docs.quantumvoid.org](https://docs.quantumvoid.org) | Guides, API reference | *** ## Get Support Most questions are answered in our [FAQ](/faq) and [Troubleshooting](/troubleshooting) guides. Your question may have already been answered in the Telegram group. Post your question in [t.me/pumpkinsui](https://t.me/pumpkinsui) — the community and team are active daily. **Beware of scams.** VoidX team members will **never** DM you first, ask for your private keys, or request funds. If someone contacts you claiming to be support, verify in the public Telegram group first. # DEX Overview Source: https://docs.quantumvoid.org/dex/overview The VOIDX on-chain DEX — a non-custodial central limit order book on Sui, built on DeepBook v3 # VOIDX DEX The VOIDX DEX at [voidx.trade/dex](https://voidx.trade/dex) is a fully on-chain exchange built on **DeepBook v3**, the native central limit order book (CLOB) on the Sui blockchain. Unlike an AMM where you trade against a pricing curve, every order on the VOIDX DEX rests in a real order book and every fill settles directly on-chain. It is **non-custodial by design**: you trade from your own Sui wallet, you sign every transaction, and VOIDX never holds, moves, or can access your funds. There are no deposits to VOIDX and no withdrawal rights — your money stays in objects controlled by your wallet. VOIDX DEX trade page showing the candlestick chart, order book, live trades, and order ticket. **New to on-chain order books?** Start with this page, then follow the step-by-step guide in [Trading](/dex/trading). If you just want to exchange one coin for another without learning order types, use [Swap](/dex/swap) — it requires nothing beyond a connected wallet. *** ## What You Can Do Full CLOB terminal: live order book and trades, candlestick chart with multiple timeframes, limit and market orders, open-order management, and cross-session history. Aggregator-style market swap routed through DeepBook order books. One card, no order types — just pick a pair and an amount. Trending and discovery view across every DeepBook market — price, 24h change, volume, highs and lows. Click any market to trade it. Permissionless market creation: list any Sui coin pair as a new DeepBook pool, directly from the UI. *** ## The Non-Custodial Model Three principles, taken directly from the DEX's built-in Security panel: 1. **Non-custodial by design.** VOIDX never holds, moves, or can access your funds. There are no deposits to VOIDX and no withdrawal rights. Your money stays in your wallet — yours. 2. **On-chain settlement.** Every trade executes directly on Sui DeepBook, the native on-chain order book. No off-chain matching engine, no hidden books — every fill is verifiable on-chain. 3. **You sign everything.** No transaction can happen without your wallet's explicit signature. Successful actions link straight to the transaction on Suiscan so you can verify them yourself. Click the **Security** button in the DEX navigation bar at any time to read the full security model inside the app. *** ## The BalanceManager, Explained Simply DeepBook limit orders do not spend coins straight out of your wallet. They settle through a small on-chain object called a **BalanceManager** — think of it as your personal trading account *on the blockchain*, created once and controlled only by your wallet. Here is the whole flow in one picture: ``` Your Sui wallet ──deposit──▶ Your BalanceManager ──orders──▶ DeepBook pool ▲ (on-chain object, (order book) │ only YOUR wallet └─────withdraw anytime──────can operate it) ``` Key facts: * **You create it once.** It is a one-time setup transaction that costs only gas. You don't even need to do it manually — the UI **auto-provisions a BalanceManager on your first limit order** (it just asks for one extra signature). * **Your wallet custodies it — not VOIDX.** Every deposit, withdrawal, order, and cancel on the BalanceManager requires an ownership proof generated by *your* wallet's signature. VOIDX has no access. * **Deposit and withdraw freely.** Move coins from your wallet into the BalanceManager to fund orders, and pull them back out to your wallet at any time. * **It remembers your history.** Your order and trade history is keyed to your BalanceManager on-chain, so the Account panel can show it across sessions and devices. A BalanceManager is a *shared* Sui object, which means it cannot be auto-discovered from your wallet alone. The UI remembers its ID per wallet in your browser. If you switch browsers or clear storage, you can re-import your existing BalanceManager by pasting its object ID (find it on Suiscan) — you never lose the funds in it. **Swaps and market orders don't need one.** The swap path is "manager-less": it spends the input coin directly from your wallet in a single transaction, and the output plus any unused coins are returned straight to your address. *** ## What's Live vs. Preview The DEX is honest about what is real. Here is the current state: | Area | Status | | ------------------------------------------------ | ------------------------------------------------------------------------- | | Trade (order book, chart, limit + market orders) | **Live** — real on-chain orders | | Swap | **Live** — real on-chain swaps | | Markets / discovery | **Live** — real indexer data | | Pool creator | **Live** (Phase 1) — real on-chain pool creation, see [Pools](/dex/pools) | | Account (balances, portfolio, history) | **Live** — real on-chain and indexer data | | Margin | **Preview** — actions disabled | | Earn | **Preview** — actions disabled | **Margin and Earn are clearly-labeled previews.** DeepBook v3 is spot-only today — there is no margin, lending, or liquidation protocol wired to these pages yet. All trade/borrow/deposit actions on them are disabled, and figures like APR, borrowing, and estimated liquidation prices are illustrative. The only live numbers on those pages are oracle prices from the Pyth network. *** ## Wallets, Prices, and Themes * **Wallets** — connect any Sui wallet through the standard Sui wallet connect modal (dapp-kit). Your address is your identity; no sign-up. * **USD prices** — USD reference values throughout the DEX come from the **Pyth oracle network**. If the oracle is unreachable, prices degrade to "—" rather than showing stale or fabricated numbers. * **Market data** — order books, trades, and tickers come from the public DeepBook indexer; a health pill in the UI shows live indexer connectivity and latency. * **Themes** — toggle between **Dusk** (warm dark) and **Dune** (warm light) from the navigation bar. VOIDX DEX swap page showing the centered swap card with pair selection, amount, and slippage controls. *** ## Next Steps Step-by-step: connect, fund, and trade on the order book. The simplest way to use the DEX — one transaction, no setup. Discover trending markets or list a new trading pair yourself. # Markets & Pools Source: https://docs.quantumvoid.org/dex/pools Discovering DeepBook markets on the VOIDX DEX and creating new pools permissionlessly # Markets & Pools Every market on the VOIDX DEX is a **DeepBook pool** — a shared on-chain order book for one coin pair on Sui. This page covers both sides: finding markets to trade, and creating brand-new ones yourself. *** ## Browsing Markets The Markets page at [voidx.trade/dex/markets](https://voidx.trade/dex/markets) is a discovery view across every DeepBook market: * **Ranked market rows** (cards on mobile) with token logos, price, 24h change, 24h volume, and 24h high/low. * **Trending highlights** surfacing the most active markets. * **Search** to filter by symbol. * **Click-to-trade** — selecting any market takes you straight to the [Trade page](/dex/trading) with that pool loaded. All figures come from the public DeepBook indexer in two batched calls, and token logos are resolved from each coin's on-chain metadata. Brand-new permissionless pools take time to appear in the public indexer. Until then they're still listed, with stats shown honestly as "—" rather than fabricated numbers. *** ## Creating a Pool The VOIDX DEX includes a **permissionless pool creator**: anyone can list a new market for any Sui coin pair, directly from the UI, with no permission from VOIDX or anyone else. Under the hood it calls DeepBook's `create_permissionless_pool` function on-chain. **Pool creation is irreversible and costs real money.** It requires a one-time fee of **500 DEEP** (paid to the DeepBook protocol, not to VOIDX) plus gas, and it creates a *permanent* shared on-chain market. There is no edit and no refund. Wrong tick/lot/min parameters produce a permanently broken market that burned the fee — which is exactly why the creator validates everything hard before letting you sign. ### What you need * A connected Sui wallet (the creator is connect-gated). * At least **500 DEEP** in your wallet, plus SUI for gas. * The full coin type of your base asset (e.g. `0x…::mycoin::MYCOIN`). Quick-pick chips are provided for **SUI** and **USDC** as the quote side. ### The three parameters Every DeepBook pool is defined by three numbers. Choose them carefully — they are permanent: | Parameter | Meaning | Denominated in | | ------------- | ------------------------------------------- | ------------------------ | | **Tick size** | The smallest price increment orders can use | Quote coin per base coin | | **Lot size** | The smallest quantity increment for orders | Base coin | | **Min size** | The smallest order the pool accepts | Base coin | ### Built-in validation The creator shows a live math preview of your parameters and refuses to enable **Create** until all of these pass: * Base and quote coin types resolve on-chain (symbol and decimals are fetched from coin metadata) and are different coins. * Tick, lot, and min are all positive — and not so small that they round to zero in the pool's on-chain units (which would create a broken market). * **Min size ≥ lot size**, and min size is an exact integer multiple of lot size. Each failed check produces a plain-language error so you can fix it before anything is signed. ### Creating it From the DEX, open the **Create Pool** modal and connect your wallet if you haven't. Paste the base coin type and pick or paste the quote coin type. The creator resolves both coins' metadata on-chain and shows their symbols and decimals. Enter the three parameters and check the live preview. Fix any validation errors — the Create button stays disabled until everything is sane. Confirm and sign in your wallet. The transaction pays the one-time 500 DEEP fee to the DeepBook registry and creates the pool as a permanent shared object. On success you get the new pool's object ID with a Suiscan link. The new market appears in your market selector right away and is fully tradeable on the [Trade page](/dex/trading). ### Phase 1 scope — what to expect honestly Pool creation is currently **Phase 1**, and there are real limits worth understanding: * **Local listing at first.** Your new pool is saved in your browser and surfaced in the market selector immediately, so *you* can trade it right away. The public DeepBook indexer takes time to pick up new permissionless pools — until it does, other users won't discover the market through the indexer-backed lists, and stats render as "—". * **No history until indexed.** Charts, 24h stats, and order/trade history all come from the indexer, so a fresh pool shows honest empty states rather than data. * **No liquidity included.** Creating a pool creates an *empty* order book. A market is only as good as the orders resting in it — you (or a market maker) need to place limit orders to give it prices and depth. * **Pools are public.** Anyone can trade on a pool once they have it, regardless of who created it. After creating a pool, seed it with resting limit orders from the [Trade page](/dex/trading) so the market has a real book for others to trade against. *** ## FAQ No. The fee is defined by the DeepBook protocol and paid to the DeepBook registry as part of the on-chain pool-creation call. VOIDX takes nothing. No. DeepBook pools are permanent shared objects with no edit function. That is why the creator validates so aggressively before letting you sign — a wrong parameter cannot be fixed afterward. Those come from the public DeepBook indexer, which lags behind newly created permissionless pools. The market is fully tradeable on-chain in the meantime; the stats fill in once the indexer picks it up. The success state links the pool on Suiscan. The pool is also remembered in your browser and shown in the market selector. # Swap Source: https://docs.quantumvoid.org/dex/swap Swapping coins on the VOIDX DEX — DeepBook-routed market swaps with slippage protection # Swap The Swap page at [voidx.trade/dex/swap](https://voidx.trade/dex/swap) is the simplest way to use the VOIDX DEX: a single card where you pick a pair, enter an amount, and sign one transaction. No order types, no BalanceManager, no setup — the swap spends directly from your wallet and the output comes straight back to your address. VOIDX DEX swap card with pair selection, amount entry, quote readout, and slippage controls. Unlike most "swap" interfaces, this is **not an AMM**. Your swap executes against real resting orders in DeepBook's on-chain central limit order book. The quote you see is computed by walking the live book level by level — the same prices a manual trader would get. *** ## How a Swap Works 1. **Routing** — the page loads every DeepBook pool and routes your pair through the matching order book. Real liquidity only: if no DeepBook pool exists for a pair, you get an honest "no route" instead of a synthetic price. 2. **Quoting** — the live level-2 order book is walked to compute your expected output, the realized average price, and whether the book has enough depth to fill your whole amount. 3. **Protection** — your slippage tolerance converts the expected output into a guaranteed **minimum output**. The transaction enforces it on-chain: if the book moves beyond your tolerance before the transaction lands, the swap fails instead of filling worse. 4. **Settlement** — one transaction, signed by your wallet. The output coin and any unused input are transferred back to your address. The success state links the transaction on Suiscan. The card's fine print states it plainly: *"On-chain swap signed by your wallet. Fees paid in \[the input coin]. Output and any unused coins are returned to your address."* *** ## Making a Swap Click **Connect Wallet** and approve in your wallet extension. Choose what you're paying and what you want to receive. Pairs map to DeepBook pools (e.g. SUI/USDC). Enter the amount in the input coin, or flip the unit toggle to type the amount in the other coin — the card converts via the current mid price. The quote updates live: expected output, average price, and USD reference values from the Pyth oracle. Presets are **0.1% / 0.5% / 1%** (default 0.5%). You can change the default in the DEX settings; once you touch the control on the card, your manual choice wins. Lower tolerance = tighter price protection but higher chance the transaction fails in a fast market. The review step shows exactly what you're sending, the minimum you'll receive, and the average price — nothing executes on a single click. Confirm, then sign in your wallet. *** ## Constraints to Know ### Minimum size Every DeepBook pool has a **min size** — the smallest order it accepts, denominated in the base coin. If your swap works out to less base than the pool's minimum, the card blocks it with a "below min size" message. Increase the amount to proceed. ### Book depth Order-book liquidity is finite. If the resting orders can't absorb your full amount, the quote tells you the book can only partially fill it. For large swaps, check the expected average price against the top of the book — a big gap means you're eating through multiple price levels. ### Lot alignment Quantities on a DeepBook pool move in increments of the pool's **lot size**. The card aligns amounts for you; you may notice your effective amount round slightly. *** ## Fees Swap fees are DeepBook protocol fees, **paid in the input coin** as part of the transaction — no DEEP token balance is required. VOIDX never holds your funds or your fees. You also pay normal Sui network gas. *** ## Troubleshooting | Message | Meaning | | ------------------------------------------- | --------------------------------------------------------------------------------- | | "No route" | No DeepBook pool exists for this pair. | | "Below min size" | The swap is smaller than the pool's minimum order — increase the amount. | | "Price moved beyond slippage tolerance" | The book moved while your transaction landed — try again, or raise the tolerance. | | "Insufficient balance or gas for this swap" | Top up the input coin, or SUI for gas. | | "Transaction rejected in wallet" | You declined the signature — nothing happened on-chain. | Want more control — choosing your exact price and resting in the book instead of crossing it? Use a limit order on the [Trade page](/dex/trading). # Trading on the DEX Source: https://docs.quantumvoid.org/dex/trading Placing limit and market orders on the VOIDX DEX — reading the order book, managing orders, and understanding fees # Trading on the VOIDX DEX The Trade page at [voidx.trade/dex](https://voidx.trade/dex) is a full order-book terminal for DeepBook markets on Sui. This guide walks through everything from reading the screen to placing, managing, and reviewing orders — assuming you have never used an on-chain order book before. VOIDX DEX trade page with chart, order book, live trades, and the order ticket. *** ## The Layout * **Market selector & stats bar** — pick a market (e.g. SUI/USDC) and see last price, 24h change, high/low, and volume. A Pyth oracle USD reference price is shown alongside. * **Chart** — candlestick chart with **1m, 5m, 15m, 1h, 4h, and 1d** timeframes. Shorter timeframes are always available, built live from recent trades; 4h and 1d need the deep candle history service and show an honest "Deep history unavailable" state for markets it doesn't cover yet. * **Order book & live trades** — real resting bids and asks, plus a live tape of recent fills (green = taker bought, red = taker sold). Clicking a price in the book pre-fills your order ticket. * **Order ticket** (right side) — where you place **Limit** and **Market** orders. * **Account panel** (bottom) — tabs for **Balances, Portfolio, Activity, Open Orders, Order History, Trade History**. The full ticket stays visible even before you connect a wallet, so you can explore the interface freely — inputs simply stay disabled until you connect. *** ## Before Your First Order: the BalanceManager Limit orders on DeepBook settle through your personal **BalanceManager** — a one-time on-chain trading account controlled only by your wallet (explained in the [Overview](/dex/overview#the-balancemanager-explained-simply)). The order ticket includes a **Getting Started** guide that tracks exactly these steps: 1. **Connect wallet** — sign in with your Sui wallet. 2. **Create trading account** — created automatically on your first order (one extra signature). 3. **Deposit** — fund it from the wallet menu (top right) → BalanceManager. 4. **Trade** — place your first order. Once all steps are done, the guide collapses to a "Ready to trade" check. You do **not** need to create the BalanceManager manually. If you place a limit order without one, the UI first asks you to sign a small setup transaction that creates it (costs only gas), then immediately continues to your order. You can also create or import one explicitly from the wallet menu. *** ## Placing a Limit Order A limit order rests in the book at your chosen price until it fills or you cancel it. Click **Connect Wallet** and approve in your wallet extension. Open the wallet menu (top right) and deposit the coin you want to spend into your BalanceManager — the quote coin (e.g. USDC) to buy, the base coin (e.g. SUI) to sell. Limit orders spend from the BalanceManager, not directly from your wallet. You can withdraw back to your wallet at any time. Select **Buy** or **Sell**. The price field is pre-seeded with the current **mid price** (halfway between best bid and best ask). You can type a price, or click any level in the order book to adopt it. Prices snap to the market's **tick size**. Enter the quantity in base units, or flip the unit toggle to enter it in quote terms. You can also type directly into the **Order Value** field — the ticket back-solves the quantity from your value and price. Percentage buttons size the order from your available balance. Quantities snap to the market's **lot size**, and orders below the market's **min size** are blocked with a clear warning. The ticket shows the market's tick / lot / min values in its fine print. * **GTC** (default) — rests until filled or cancelled. * **IOC** — fills what it can immediately, cancels the rest. * **FOK** — fills completely and immediately, or not at all. * **Post-Only** (checkbox) — guarantees your order only *adds* liquidity; it is rejected if it would cross the book. Post-Only overrides the GTC/IOC/FOK selector. Click the action button to open a **review box** summarizing side, price, quantity, and order value — nothing fires on a single click. Confirm, then sign in your wallet. (If this is your first order, you'll sign the BalanceManager setup first.) On success the ticket shows the transaction digest with a direct **Suiscan** link. Your resting order appears under **Account → Open Orders**. The ticket's own fine print states the model exactly: *"Resting order signed by your wallet, custodied by your BalanceManager. Fees paid in the input coin. Manage / cancel from the Account → Open Orders tab."* *** ## Placing a Market Order Switch the ticket to **Market** to trade immediately against the live book. Market orders use a different mechanism than limit orders: they are executed as a **manager-less swap** straight from your wallet — no BalanceManager needed, no deposit step. The ticket: 1. Walks the live order book to estimate your fill — expected output, average price, and whether the book has enough depth for your full amount. 2. Applies your **slippage tolerance** (presets 0.1% / 0.5% / 1%, default 0.5%, configurable in DEX settings) to derive a protected minimum output. If the price moves beyond that while your transaction lands, the transaction fails rather than filling at a worse price. 3. Builds the swap, you review and confirm, and sign once in your wallet. The output and any unused input coins are returned directly to your wallet address. See [Swap](/dex/swap) for the same mechanism in a standalone page. *** ## Managing Orders and Reading Your History The **Account panel** at the bottom of the trade page (and the full-page version at `/dex/account`) has six tabs: | Tab | What it shows | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | **Balances** | Wallet and BalanceManager balances for the active market's coins plus SUI, USDC, and DEEP, with Pyth USD valuations | | **Portfolio** | Position and average cost replayed from your actual fills, realized PnL, and total fees observed | | **Activity** | Recent actions in this session | | **Open Orders** | Your live resting orders on the current market, read directly from the chain — with one-click **Cancel** (signed by your wallet) | | **Order History** | Cross-session order events (Placed / Filled / Canceled / Modified) with price, original, filled, and remaining quantities | | **Trade History** | Cross-session fills from your perspective — side, **Maker/Taker** role, price, size, value, and the fee you paid (with its asset). Exportable as CSV. | Order and trade history is fetched from the DeepBook indexer keyed by your BalanceManager ID, so it follows you across sessions and devices. Markets that are not yet indexed (e.g. freshly created permissionless pools) honestly show no history rather than an error. *** ## Fees * **Trading fees are paid in the input coin** — the coin you are spending (quote coin when buying, base coin when selling). This applies to both limit orders and market orders/swaps. VOIDX does not take custody of fees; they are DeepBook protocol fees handled on-chain as part of the trade. * DeepBook also supports paying fees in its native DEEP token; the VOIDX ticket places orders with input-coin fees, so **no DEEP balance is required to trade**. Your Trade History shows the exact fee and its asset for every fill. * Creating a BalanceManager and cancelling orders cost only network gas. The exact fee *rate* is set by the DeepBook protocol per pool and is not set by VOIDX. Check your **Trade History** tab to see the precise fee charged on each fill. *** ## Troubleshooting | Message | Meaning | | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | "Below min size" | Your quantity is under the market's minimum order size — increase it (the min is shown in the ticket fine print). | | "Post-Only order would cross the book" | Your Post-Only price would have executed immediately — move it away from the touch. | | "Insufficient manager balance or gas" | Deposit more of the input coin into your BalanceManager, or top up SUI for gas. | | "Order could not be filled under its time-in-force" | An IOC/FOK order couldn't fill as required — the book moved or lacks depth. | | "Transaction rejected in wallet" | You declined the signature — nothing happened on-chain. | # BloFin Setup Guide Source: https://docs.quantumvoid.org/exchanges/blofin Complete guide to setting up BloFin exchange with VoidX # How to Start a New BloFin Bot Welcome to the **VoidX Trading Bot Guide**! This step-by-step walkthrough will help you set up your bot securely and efficiently. Follow these instructions exactly to avoid issues. You'll need a wallet (SUI, Solana, or BASE) with **any amount of PUMPKIN tokens** ready. *** ## Step 1: Sign Up for BloFin 1. Open your browser and go to **[https://partner.blofin.com/d/quantumvoidlabs](https://partner.blofin.com/d/quantumvoidlabs)** 2. Sign up using the referral code **`quantumvoidlabs`** (it should appear in the dropdown for 5% cash back) 3. Agree to the terms and conditions 4. Verify you're human to complete registration This referral code ensures you get that extra 5% cash back—don't skip it! *** ## Step 2: Set Up Two-Factor Authentication (2FA) Your new account will prompt you immediately about low security. **This is mandatory for safety.** 1. Enable 2FA on all your devices and accounts using Google Authenticator (or similar) 2. **Save your Google Authenticator backup code securely**—you'll need it if you lose access 3. Once saved, click **"I have saved the backup key properly"** 2FA protects against unauthorized access. Never share your backup code! *** ## Step 3: Create Your Exchange API Key 1. In the BloFin dashboard, look at the top right next to **Assets**—hover over the figurine icon and select **API** 2. Click **+ Create API Key** 3. In the **Application Name** dropdown, select **"Quantum Void Labs"** as the 3rd party 4. Name your key something memorable (e.g., `qvlbot`) 5. In the **Permissions** section, **checkmark the Trade permission** to allow the bot to trade 6. Enter a simple **passphrase** you'll remember (you'll need it later) 7. Click **Next** 8. Verify with your email and Google Authenticator prompt, then submit **A popup will show your API Key and Secret Key. Copy these immediately—you'll paste them into the bot dashboard next.** *** ## Step 4: Prepare Your Wallet and Navigate to the Bot Dashboard 1. Ensure your wallet has **any amount of PUMPKIN tokens** (SUI, Solana, or BASE) 2. Open a new browser window and go to **[voidx.trade](https://voidx.trade)** (keeps things organized) 3. Click **Connect Wallet** and choose your wallet type 4. Connect and sign the authorization message *** ## Step 5: Add BloFin Credentials to the Bot 1. Navigate to **Settings** → **Exchanges** 2. Click **Add Exchange** and select BloFin 3. Paste your **API Key** and **Secret Key** from Step 3 4. Enter the **passphrase** you created earlier 5. Click **Test Connection** then **Save** Double-check your pastes—no typos here, or the bot won't connect! *** ## Step 6: Configure Your Bot Settings 1. Click **Bot Management** 2. Click **New Bot** or **Create Bot** 3. Select BloFin as your exchange 4. Choose a symbol (e.g., DOGEUSDT) 5. Select a preset like **Minimalist Alpha** for beginners 6. Review and customize settings as needed *** ## Step 7: Deposit Funds into BloFin 1. Back in BloFin, click **Assets > Funding** 2. Choose your deposit asset (recommended: **USDC on the SUI network** for speed and low fees) 3. Deposit your funds and wait for them to arrive Always send a small test amount (e.g., \$10) before transferring larger sums. *** ## Step 8: Convert Funds to USDT-M (Bot's Trading Account) 1. Once deposited, move your USDC to the **Spot** account 2. Swap it for **USDT** in Spot 3. Transfer the USDT to the **USDT-M** account (this is where the bot trades) *** ## Step 9: Set Leverage on BloFin Futures 1. Go to **BloFin Futures > USDT-M** 2. Change the leverage type to **Cross** (instead of Isolated) for shared margin 3. Set your leverage for each trading symbol (e.g., **10x** is a safe starting point) *** ## Step 10: Launch and Monitor Your Bot 1. Return to the bot dashboard and click **Start** on your bot 2. Watch orders populate in your BloFin account 3. For real-time monitoring: * Click **Trading Console > Bot Logs** to view event logs 4. If you see any **RED errors**, report them to the Telegram group for quick fixes *** ## Congratulations—Your Bot is Live! Monitor it closely at first, and remember: **trading involves risk**. Start small, learn from logs, and reach out in Telegram for support. ### Final Reminder Follow these steps precisely. If something goes wrong, it's often a small detail like a missed permission or test deposit. **Happy trading with VoidX!** # BloFin Perp MM Quickstart Source: https://docs.quantumvoid.org/exchanges/blofin-perp-mm-quickstart Get a perpetual market making bot running on BloFin in 15 minutes # BloFin Perp MM Quickstart This guide gets you running the **Perpetual Market Maker** strategy on BloFin - the most advanced strategy for active traders who want to profit from bid-ask spreads. **What is Perp MM?** Instead of just buying dips and selling highs, market makers quote BOTH sides - placing buy orders below price AND sell orders above price. You profit from the spread when both sides fill. *** ## Prerequisites BloFin account with completed KYC $500+ USDT in your BloFin USDT-M futures wallet Sui wallet with $100+ PUMPKIN tokens API keys created (see [BloFin Setup Guide](/exchanges/blofin) if needed) *** ## Step 1: Connect to Dashboard (2 min) Go to [trade.quantumvoid.org](https://trade.quantumvoid.org) Click **Connect Sui Wallet** and sign the authentication message Click **BloFin Perps** on the main screen *** ## Step 2: Add BloFin Credentials (3 min) If you haven't added credentials yet: Click the **gear icon** or go to **Settings > Exchanges** Click **Add Exchange** and select **BloFin** * **API Key**: Paste from BloFin * **Secret Key**: Paste from BloFin * **Password**: The passphrase you set when creating the key Click **Test Connection** - should show green success. Then **Save**. *** ## Step 3: Create Your Bot (5 min) Click **Bot Management** in the sidebar Click **New Bot** or **Create Bot** Choose **BloFin** from the dropdown Type your trading pair. Recommended starters: * `ASTER/USDT:USDT` - Moderate volatility, good for learning * `DOGE/USDT:USDT` - High volume, tight spreads Select **BloFin v7 Long Short Counterscalp** This is the recommended preset for BloFin. It uses the latest v7 features including equity-based sizing and automatic counter-scalping. *** ## Step 4: Understand Your Preset The **BloFin v7 Long Short Counterscalp** preset is pre-configured with: | Setting | Value | What It Means | | ------------------ | ------- | -------------------------------------- | | **equity\_pct** | 5% | Uses 5% of your account per grid cycle | | **leverage** | 75x | High leverage for capital efficiency | | **quote\_size** | \$7 | Each order is \$7 | | **max\_position** | \$2000 | Won't exceed \$2000 per side | | **time\_decay** | 48h/48h | Exits stale positions automatically | | **xgrid\_counter** | Enabled | Scalps opposite direction when stuck | ### What This Bot Does ``` Market price: $1.00 Your bot places: BUY @ $0.9985 (15 bps below) ← Waiting to buy cheap SELL @ $1.0015 (15 bps above) ← Waiting to sell high When BOTH fill: Bought at $0.9985 Sold at $1.0015 Profit: $0.0030 per unit (30 bps) minus fees ``` ### Risk Protection Built-In * **Loss tiers**: Reduces activity as losses grow (1% → 3% → 6% → 10% hard stop) * **Time decay**: Forces exit after 24h if position stuck * **Counter-scalp**: When main position underwater, opens opposite side to offset losses *** ## Step 5: Start the Bot (1 min) Check the settings look correct Hit the **Start Bot** button Read the confirmation and click **Confirm** *** ## Step 6: Monitor Your Bot ### What to Watch **Status: Running** (green) - Bot is active **Orders appearing** - You should see bid/ask orders within seconds **No red errors** - Check Trading Console for issues ### Understanding the Display ``` Position: LONG 150 ASTER @ $1.0234 uPnL: -$2.45 (-0.8%) Orders: 4 BUY / 4 SELL SPACING: base=15bps × reactive=1.2x → final=18bps ``` * **Position**: Your current holdings * **uPnL**: Unrealized profit/loss * **Orders**: Active quotes on each side * **SPACING**: How far orders are from mid-price (wider = safer but fewer fills) *** ## First Hour Expectations **Normal behavior:** * Multiple order placements and cancellations * Small positions opening and closing * P\&L fluctuating between small gains and losses **Warning signs:** * No orders appearing after 1 minute * Constant red errors in logs * Position growing without any take-profits *** ## Adjusting Settings ### Quick Settings (Scaling Agent) Use the Trading Console to adjust on-the-fly: ``` /set equity_pct 3 # Reduce to 3% for smaller positions /set equity_pct 7 # Increase to 7% for larger positions ``` ### Common Adjustments | Want to... | Change | From → To | | --------------- | ----------------- | --------- | | Reduce risk | `equity_pct` | 5% → 3% | | More aggressive | `equity_pct` | 5% → 8% | | Wider spreads | `base_spread_bps` | 15 → 25 | | Tighter spreads | `base_spread_bps` | 15 → 10 | *** ## Troubleshooting Check that: 1. You have USDT in the **USDT-M futures** wallet (not Spot) 2. Leverage is set on BloFin for that symbol 3. Symbol format is correct (e.g., `ASTER/USDT:USDT`) This is often normal - the bot refreshes quotes every 2 seconds. If ALL orders cancel: 1. Check exchange rate limits 2. Reduce `geometric_max_levels` in config The bot has built-in recovery: 1. **Wait** - Time decay will handle it (up to 24h) 2. **Counter-scalp** - XGrid may open opposite position to offset 3. **Check tier** - At 6%+ loss, bot enters defensive mode *** ## Next Steps Compare all available presets Full strategy documentation AI assistant for live adjustments Protect your capital # Bybit Setup Guide Source: https://docs.quantumvoid.org/exchanges/bybit Complete guide to setting up Bybit exchange with VoidX # How to Start a New Bybit Bot Welcome to the **Bybit Trading Bot Setup Guide**! This step-by-step walkthrough will help you set up your bot securely and efficiently on Bybit. You'll need a wallet (SUI, Solana, or BASE) with **any amount of PUMPKIN tokens** ready. *** ## Step 1: Sign Up for Bybit 1. Open your browser and go to **[https://partner.bybit.com/b/quantumvoid](https://partner.bybit.com/b/quantumvoid)** 2. Sign up using the referral link **`quantumvoid`** for exclusive benefits 3. Complete email verification 4. Set a strong password and agree to terms of service Using our referral link supports the project and may unlock trading fee discounts! *** ## Step 2: Complete KYC Verification (Recommended) While not always mandatory, KYC increases withdrawal limits and account security. 1. Go to **Account & Security > Identity Verification** 2. Select your country and verification level (Basic or Advanced) 3. Upload required documents (government ID, proof of address if needed) 4. Wait for approval (usually 5-30 minutes) Higher verification levels unlock larger withdrawal limits and better features. *** ## Step 3: Set Up Two-Factor Authentication (2FA) Protect your account with 2FA—this is **strongly recommended** for security. 1. Go to **Account & Security > Two-Factor Authentication** 2. Download **Google Authenticator** or **Authy** on your phone 3. Scan the QR code and enter the 6-digit code 4. **Save your backup key securely**—you'll need it if you lose access to your phone Never share your 2FA backup code with anyone! *** ## Step 4: Create Your Bybit API Key 1. In the Bybit dashboard, click your profile icon (top right) and select **API** 2. Click **Create New Key** under **API Management** 3. Choose **System-generated API Keys** (recommended for trading bots) 4. Set the following permissions: * ✅ **Read-Write** (for order placement) * ✅ **Contract Trading** (for USDT perpetual futures) * ❌ **Withdrawal** (disable this for security—bots don't need it) 5. (Optional) Set **IP Restriction** to your server's IP for extra security 6. Click **Submit** and complete 2FA verification **Copy your API Key and Secret immediately—Bybit only shows the Secret once!** Store your API credentials in a password manager—you'll need them for the bot dashboard. *** ## Step 5: Prepare Your Wallet and Navigate to the Bot Dashboard 1. Ensure your wallet has **any amount of PUMPKIN tokens** (SUI, Solana, or BASE) 2. Open a new browser window and go to **[voidx.trade](https://voidx.trade)** 3. Click **Connect Wallet** and choose your wallet type 4. Authorize the connection and sign the message *** ## Step 6: Add Bybit Credentials to the Bot 1. Navigate to **Settings** → **Exchanges** 2. Click **Add Exchange** and select Bybit 3. Paste your **API Key** from Step 4 4. Paste your **API Secret** from Step 4 5. Click **Test Connection** then **Save** Double-check your pastes—any typos will prevent the bot from connecting! *** ## Step 7: Configure Your Bot Settings 1. Click **Bot Management** in the sidebar 2. Click **New Bot** or **Create Bot** 3. Select Bybit as your exchange 4. Choose a symbol (e.g., DOGEUSDT) 5. Select a preset like **Minimalist Alpha** for beginners 6. Review and customize settings as needed *** ## Step 8: Deposit Funds into Bybit 1. In Bybit, click **Assets > Deposit** 2. Select **USDT** (or another stablecoin like USDC) 3. Choose your preferred network: * **Sui Network** (fast, low fees—recommended) * **Ethereum (ERC20)**, **Polygon**, **Arbitrum**, etc. 4. Copy the deposit address and send funds from your wallet Always send a small test deposit first (e.g., \$10) to verify the address! *** ## Step 9: Transfer Funds to USDT Perpetual Account The bot trades on **USDT Perpetual Futures**, so you need to move funds to that account. 1. Go to **Assets > Transfer** 2. From: **Funding Account** → To: **USDT Perpetual** 3. Asset: **USDT** 4. Amount: Enter the amount you want to trade with 5. Click **Confirm Transfer** *** ## Step 10: Set Leverage and Margin Mode 1. Go to **Derivatives > USDT Perpetual** 2. For each symbol you're trading: * Click the **leverage icon** (e.g., `10x`) * Set your desired leverage (start with **5x-10x** for safety) * Change margin mode to **Cross** (recommended for shared margin) Cross margin shares your balance across all positions, reducing liquidation risk. *** ## Step 11: Launch and Monitor Your Bot 1. Return to the bot dashboard at **[voidx.trade](https://voidx.trade)** 2. Click **Start** on your bot configuration 3. Watch orders appear in your Bybit account within seconds 4. Monitor in real-time: * **Dashboard**: View P\&L, positions, and performance metrics * **Trading Console > Bot Logs**: See detailed event logs 5. If you see any **RED errors**, report them in the [Telegram group](https://t.me/pumpkinsui) *** ## Congratulations—Your Bybit Bot is Live! Your bot is now trading on Bybit! Monitor it closely at first, start with small amounts, and scale up as you gain confidence. ### Key Reminders: * ✅ **Cross margin mode** is recommended for safer position management * ✅ **Start small** and increase exposure gradually * ✅ **Monitor logs** regularly for any errors or warnings * ✅ **Join Telegram** for community support and updates **Trading involves risk. Never invest more than you can afford to lose.** *** ## Troubleshooting ### Bot won't connect: * Verify API Key and Secret are correct * Check API permissions include **Contract Trading** * Ensure **IP restrictions** (if set) include your server's IP ### Orders not placing: * Confirm funds are in **USDT Perpetual** account (not Funding) * Check leverage and margin mode are set for each symbol * Verify minimum order sizes meet Bybit's requirements ### Need help? Join our [Telegram support group](https://t.me/pumpkinsui) for fast assistance! **Happy trading with VoidX!** # Defx Setup Guide Source: https://docs.quantumvoid.org/exchanges/defx Complete guide to setting up Defx perpetual DEX on Base with VoidX # How to Start a New Defx Bot Welcome to the **Defx Trading Bot Setup Guide**! This step-by-step walkthrough will help you set up your bot for trading on Defx, a decentralized perpetual exchange on Base (Ethereum L2). You'll need a wallet (SUI, Solana, or BASE) with **any amount of PUMPKIN tokens** ready. *** ## Step 1: Set Up MetaMask for Base Network Defx operates on **Base**, Coinbase's Ethereum Layer 2 network. You'll need a compatible wallet. 1. Install **[MetaMask](https://metamask.io)** browser extension if you don't have it 2. Create or import your Ethereum wallet 3. **Add Base Network** to MetaMask: * Click the network dropdown (top of MetaMask) * Click **Add Network** or **Add Network Manually** * Enter Base network details: * **Network Name**: Base * **RPC URL**: `https://mainnet.base.org` * **Chain ID**: `8453` * **Currency Symbol**: ETH * **Block Explorer**: `https://basescan.org` 4. Click **Save** You can also add Base automatically via [chainlist.org](https://chainlist.org/?search=base) - search "Base" and click Connect Wallet! *** ## Step 2: Bridge Funds to Base Network You'll need ETH on Base for gas fees and USDC for trading. ### Option A: Bridge via Official Base Bridge 1. Go to **[bridge.base.org](https://bridge.base.org)** 2. Connect your MetaMask wallet 3. Bridge **ETH** from Ethereum mainnet (you'll need \~\$20-50 for gas fees) 4. Wait 5-10 minutes for the bridge to complete ### Option B: Use Coinbase (Faster & Cheaper) 1. Buy ETH or USDC on **[Coinbase](https://coinbase.com)** 2. Withdraw directly to **Base Network** (select "Base" as the network) 3. Paste your MetaMask wallet address 4. Confirm withdrawal (usually arrives in 1-2 minutes) Always send a small test amount first to verify the address and network! *** ## Step 3: Get USDC on Base for Trading The bot trades with USDC on Base. You can: 1. **Bridge USDC** from Ethereum using [bridge.base.org](https://bridge.base.org) 2. **Swap ETH for USDC** on Base using a DEX: * Go to **[Uniswap](https://app.uniswap.org)** and switch to Base network * Swap ETH → USDC * Keep some ETH for gas fees (\~\$10-20 worth) *** ## Step 4: Create Defx Account 1. Sign up using the **Quantum Void Labs affiliate link**: **[https://app.defx.com/join/CVR3QJ](https://app.defx.com/join/CVR3QJ)** 2. Click **Connect Wallet** 3. Select **MetaMask** and authorize the connection 4. Sign the signature request to authenticate Join Defx using our referral code CVR3QJ for exclusive benefits Defx is non-custodial—you always maintain control of your funds! *** ## Step 5: Deposit USDC into Defx Before trading on Defx, you need to deposit USDC into their perpetual contract. 1. On the Defx dashboard, click **Deposit** or **Transfer** 2. Select **USDC** as the asset 3. Enter the amount you want to deposit 4. Click **Deposit** and approve the transaction in MetaMask 5. Wait for the transaction to confirm on Base (\~2-5 seconds) *** ## Step 6: Prepare Your Wallet (PUMPKIN Token Requirement) 1. Ensure your wallet has **any amount of PUMPKIN tokens** (SUI, Solana, or BASE) 2. Open **[voidx.trade](https://voidx.trade)** in a new tab 3. Click **Connect Wallet** and choose your wallet type 4. Authorize the connection and sign the message *** ## Step 7: Connect Your Base Wallet to VoidX Since Defx is a DEX, the bot needs your **wallet private key** or uses **WalletConnect** for non-custodial trading. **Security Note**: Only provide private keys to trusted platforms. The bot needs signing authority to execute trades on your behalf. ### Option A: Wallet Private Key (Direct Integration) 1. In MetaMask, click the three dots → **Account Details** → **Export Private Key** 2. Enter your MetaMask password 3. Copy your private key (keep this **extremely secure**) 4. In the VoidX dashboard, click **Add Defx Credentials** 5. Paste your Base wallet **private key** 6. Click **Save Credentials** ### Option B: WalletConnect (If Supported) 1. In the dashboard, click **Connect via WalletConnect** 2. Scan the QR code with your mobile MetaMask 3. Approve the connection Private key method gives the bot full trading authority. WalletConnect requires manual approval for each trade. *** ## Step 8: Configure Your Bot Settings 1. Click **Bot Management** in the sidebar 2. Click **New Bot** or **Create Bot** 3. Select Defx as your exchange 4. Choose a symbol (e.g., ETH-PERP) 5. Select a preset or customize settings 6. Save your configuration *** ## Step 9: Set Leverage on Defx (Optional) 1. On Defx, navigate to the trading pair you want to trade 2. Click the **leverage slider** (usually 1x-20x available) 3. Set your desired leverage (start with **5x-10x** for safety) 4. Choose **Cross** margin mode (shares margin across all positions) Cross margin reduces liquidation risk by pooling your balance across positions. *** ## Step 10: Launch and Monitor Your Bot 1. Return to the VoidX dashboard at **[voidx.trade](https://voidx.trade)** 2. Click **Start** on your Defx bot configuration 3. Watch transactions appear on Base network (view on [BaseScan](https://basescan.org)) 4. Monitor in real-time: * **Dashboard**: View P\&L, positions, and performance metrics * **Trading Console > Bot Logs**: See detailed event logs 5. If you see any **RED errors**, report them in the [Telegram group](https://t.me/pumpkinsui) *** ## Congratulations—Your Defx Bot is Live on Base! Your bot is now trading on Defx! Monitor it closely at first, start with small amounts, and scale up as you gain confidence. ### Key Reminders: * ✅ **Keep ETH on Base** for gas fees (transactions are cheap, \~\$0.01-0.10) * ✅ **Cross margin mode** is recommended for safer position management * ✅ **Start small** and increase exposure gradually * ✅ **Monitor logs** regularly for any errors or warnings * ✅ **Join Telegram** for community support and updates **Trading involves risk. Never invest more than you can afford to lose.** *** ## Troubleshooting ### Bot won't connect: * Verify your Base wallet has ETH for gas fees * Check that you've deposited USDC into Defx contract * Ensure private key is correct (no extra spaces) ### Transactions failing: * Confirm you have enough ETH on Base for gas * Check Defx contract has sufficient USDC deposited * Verify you haven't hit position limits on Defx ### High gas fees: * Base is an L2 with very low fees (\~\$0.01-0.10 per transaction) * If fees are high, check you're on **Base network** (Chain ID 8453), not Ethereum mainnet ### Deposits not showing: * Wait 5-10 seconds for Base block confirmation * Check transaction on [BaseScan](https://basescan.org) * Verify you approved the USDC spending limit ### Need help? Join our [Telegram support group](https://t.me/pumpkinsui) for fast assistance! *** ## Why Trade on Defx? Base L2 offers \$0.01-0.10 transaction costs Non-custodial trading—you control your funds 2-5 second block times on Base Integrates with MetaMask and other EVM wallets *** **Happy trading with VoidX on Base!** # HTX (Huobi) Setup Source: https://docs.quantumvoid.org/exchanges/htx Connect your HTX account to VoidX # HTX (Huobi) Exchange Setup HTX (formerly Huobi) is a major cryptocurrency exchange supporting perpetual futures trading. This guide covers API setup and configuration. ## Prerequisites If you don't have an account, register at [htx.com](https://www.htx.com) Identity verification is required for derivatives trading Navigate to Derivatives → USDT-M Futures and enable trading Transfer USDT to your USDT-M Futures wallet *** ## Creating API Keys ### Step 1: Access API Management 1. Log in to HTX 2. Click your profile icon (top right) 3. Select **API Management** 4. Click **Create API Key** ### Step 2: Configure Permissions **Security First**: Only enable the permissions you need. For VoidX, you need: * **Read** - Always required * **Trade** - Required for placing orders * **DO NOT enable Withdraw** - Never needed, keeps funds secure Select these permissions: * [x] Read Info * [x] Trade * [ ] Withdraw ← **Leave unchecked!** ### Step 3: Set IP Restrictions (Recommended) For maximum security, restrict API access to specific IPs: 1. Select **Bind IP addresses** 2. Add your server's IP address 3. This prevents unauthorized access even if keys are leaked ### Step 4: Save Your Credentials You will receive: * **API Key** (Access Key) * **Secret Key** **Save both immediately** - the Secret Key is only shown once! *** ## Adding HTX to VoidX ### Via Dashboard 1. Navigate to **Settings** → **Exchanges** 2. Click **Add Exchange** 3. Select **HTX** from the dropdown 4. Enter your credentials: * **API Key**: Your Access Key * **API Secret**: Your Secret Key 5. Click **Test Connection** 6. If successful, click **Save** ### Configuration Example ```json theme={null} { "exchange": { "name": "htx", "api_key": "your-api-key", "api_secret": "your-secret-key", "testnet": false } } ``` *** ## HTX-Specific Settings ### Supported Features | Feature | Supported | Notes | | ----------------- | --------- | --------------------------- | | USDT-M Perpetuals | Yes | Primary market | | Hedge Mode | Yes | Long + Short simultaneously | | Cross Margin | Yes | Default mode | | Isolated Margin | Yes | Per-position margin | | Maximum Leverage | 125x | Varies by symbol | ### Symbol Format HTX uses standard symbol format: * Dashboard: `BTCUSDT` * API: `BTC-USDT` The bot handles conversion automatically. ### Rate Limits HTX has strict rate limits: * 10 requests per second for order placement * 20 requests per second for market data The bot includes built-in rate limiting to stay within these bounds. *** ## Transferring Funds ### To Futures Wallet 1. Go to **Assets** → **Transfer** 2. From: **Spot Account** 3. To: **USDT-M Futures** 4. Enter amount and confirm Funds must be in the USDT-M Futures wallet before the bot can trade. ### Checking Balance Your futures balance shows: * **Available Balance**: Can be used for new positions * **Used Margin**: Locked for open positions * **Unrealized PnL**: Current position profit/loss *** ## Troubleshooting ### "Invalid API Key" 1. Verify you copied the full key (no spaces) 2. Check if key is expired or deleted 3. Ensure you're using the correct account (main vs sub-account) ### "Insufficient Balance" 1. Check funds are in **USDT-M Futures** wallet (not Spot) 2. Verify available margin after existing positions 3. Reduce position size or close existing trades ### "Order Rejected" 1. Check symbol is correct and tradeable 2. Verify leverage settings match exchange limits 3. Ensure order size meets minimum requirements ### "Rate Limit Exceeded" 1. Reduce number of simultaneous bots 2. Increase quote refresh interval 3. Reduce geometric sizing levels *** ## Security Best Practices Never enable withdraw - keeps funds secure even if keys leak Bind API to specific IPs for maximum security Rotate API keys every 90 days Check API logs regularly for unusual activity *** ## Next Steps Set up your trading bot Select a trading strategy # WEEX Setup Source: https://docs.quantumvoid.org/exchanges/weex Connect your WEEX exchange account to VoidX # WEEX Exchange Setup WEEX is a cryptocurrency derivatives exchange offering perpetual futures with competitive fees. This guide covers API setup and configuration. ## Prerequisites Register at [weex.com](https://www.weex.com) Complete identity verification for full trading access Navigate to Futures trading and enable your account Deposit USDT to your futures wallet *** ## Creating API Keys ### Step 1: Access API Settings 1. Log in to WEEX 2. Go to **Account** → **API Management** 3. Click **Create New API Key** ### Step 2: Set Permissions **Critical Security Settings**: Only enable: * [x] **Read** - Required * [x] **Trade** - Required for orders * [ ] **Withdraw** - **NEVER enable this!** ### Step 3: Create Passphrase WEEX requires a **passphrase** in addition to API key and secret. This is an extra security layer - choose a strong passphrase and save it securely. 1. Enter a secure passphrase (8+ characters) 2. Confirm the passphrase 3. Complete 2FA verification ### Step 4: Save Credentials You will receive three values: * **API Key** * **Secret Key** * **Passphrase** (you created this) Save all three immediately! The Secret Key is only shown once. *** ## Adding WEEX to VoidX ### Via Dashboard 1. Navigate to **Settings** → **Exchanges** 2. Click **Add Exchange** 3. Select **WEEX** from the dropdown 4. Enter your credentials: * **API Key**: Your API Key * **API Secret**: Your Secret Key * **Passphrase**: Your chosen passphrase 5. Click **Test Connection** 6. If successful, click **Save** ### Configuration Example ```json theme={null} { "exchange": { "name": "weex", "api_key": "your-api-key", "api_secret": "your-secret-key", "passphrase": "your-passphrase", "testnet": false } } ``` *** ## WEEX-Specific Features ### Supported Features | Feature | Supported | Notes | | ---------------- | --------- | ---------------- | | USDT Perpetuals | Yes | Primary market | | Hedge Mode | Limited | Check per-symbol | | Cross Margin | Yes | Default mode | | Isolated Margin | Yes | Available | | Maximum Leverage | 100x | Varies by symbol | ### Authentication WEEX uses HMAC SHA256 signature authentication with: 1. Timestamp header 2. Signature header (Base64 encoded) 3. Passphrase header The bot handles all authentication automatically - just provide your credentials. ### Symbol Format * Dashboard input: `BTCUSDT` * API format: `BTCUSDT_UMCBL` (handled automatically) *** ## Fee Structure | Type | Fee | | ----- | ------------- | | Maker | 0.02% (2 bps) | | Taker | 0.06% (6 bps) | Fees may vary based on VIP level. Check your account for current rates. Configure in your bot: ```json theme={null} { "perp_market_maker": { "maker_fee_bps": 2, "taker_fee_bps": 6 } } ``` *** ## Rate Limits WEEX enforces rate limits: * **Private endpoints**: 10 requests/second * **Public endpoints**: 20 requests/second The bot includes rate limiting, but running many symbols may require adjustment. ### If You Hit Rate Limits 1. Reduce number of trading symbols 2. Increase `grid_refresh_interval` 3. Reduce `geometric_max_levels` 4. Stagger bot start times *** ## Transferring Funds ### Deposit to Futures 1. Go to **Assets** → **Transfer** 2. Select **Spot to Futures** 3. Choose USDT 4. Enter amount and confirm ### Check Balance Navigate to **Assets** → **Futures Account** to see: * Available balance * Position margin * Unrealized PnL *** ## Troubleshooting ### "Authentication Failed" 1. Verify all three credentials are correct: * API Key * Secret Key * Passphrase 2. Check for extra spaces in copied values 3. Ensure API key hasn't expired ### "Invalid Passphrase" 1. Passphrase is case-sensitive 2. Re-enter exactly as created 3. If forgotten, delete and recreate API key ### "Insufficient Margin" 1. Transfer funds from Spot to Futures 2. Reduce position size 3. Check available balance vs used margin ### "Order Size Too Small" 1. Check minimum order size for symbol 2. Increase `quote_size_usdt` 3. Some symbols require larger minimum orders ### "Position Mode Mismatch" 1. Check if hedge mode is enabled on WEEX 2. The bot defaults to one-way mode 3. Adjust position mode in WEEX settings *** ## Security Recommendations WEEX's passphrase requirement adds an extra security layer beyond standard API keys. Even if your API key and secret are compromised, the attacker still needs your passphrase. ### Best Practices 1. **Strong Passphrase**: Use 12+ characters with mixed case, numbers, symbols 2. **No Withdraw Permission**: Never enable - funds stay secure 3. **IP Whitelisting**: If available, restrict to your server IP 4. **Regular Rotation**: Change API keys every 90 days 5. **Monitor Trades**: Check API activity logs periodically *** ## Next Steps Set up trading parameters Select your trading strategy # FAQ Source: https://docs.quantumvoid.org/faq Frequently asked questions about VOIDX # Frequently Asked Questions Quick answers to common questions about VOIDX. *** ## Getting Started **Yes.** Open [voidx.trade](https://voidx.trade), click Launch App, and browse freely. Guests can see everything — the Bot Marketplace, preset details, Markets data, strategy descriptions. Only *actions* (deploying bots, trading) require a connected wallet. Deploy buttons simply say "Connect wallet to deploy" until you do. **Not for the Free tier.** Connect a Sui, Solana, or EVM wallet and you're in — no PUMPKIN required. PUMPKIN is relevant for upgrading: burning PUMPKIN for the Pro tier is coming soon. See [PUMPKIN Token](/pumpkin-token). * **Free**: 1 bot, 1 symbol, 1 exchange * **Pro**: 5 bots, 10 symbols, 5 exchanges, plus priority support and advanced strategies A 14-day Pro trial is available — no card required. Upgrading to Pro via PUMPKIN burn is coming soon. **Minimum recommended**: \$500 USDT in your exchange futures wallet. **By strategy:** * Vortex DCA: \$500+ recommended * Market making strategies: \$1,000+ recommended * Multiple symbols: \$2,000+ recommended More capital gives DCA strategies more room to average in safely. Currently supported: * **BloFin** - Primary exchange, best integration * **Bybit** - Full support, popular choice * **HTX (Huobi)** - Perpetual futures * **WEEX** - Perpetual futures * **DEFX** - Decentralized derivatives Each exchange has a dedicated setup guide in the [Exchange Setup](/exchanges/bybit) section. **No!** VOIDX is designed for non-technical users. * Browse the Bot Marketplace and deploy presets with plain-English descriptions * The deploy wizard comes prefilled with the preset's settings * Advanced users can customize parameters if desired *** ## Funds & Custody **No. VOIDX is non-custodial.** * Your funds never leave your exchange account * Bots only use your API keys to place orders on your behalf * We never have access to your private keys or passwords * You can revoke API access at any time from your exchange **Read + Trade only. Never enable withdrawal permission.** With trade-only keys, even if your keys were somehow compromised, funds cannot be withdrawn from your exchange account. Every exchange guide in these docs walks you through creating keys with the right permissions. Each bot runs as its own process on VOIDX servers and trades through your exchange API keys. * No software to install, no VPS to manage * Bots keep running when your browser is closed * They cannot withdraw funds — withdrawal permission should stay disabled on your API key *** ## Marketplace & Bots The **Marketplace** currently groups 126 active presets into 80 cards across 9 strategy families: * **TBLTBS** — liquidation/volatility campaign admission, structural DCA, hedging, and durable ownership * **Vortex DCA** — widening grids and wave recovery * **XGrid** — high-frequency grid and momentum scalping * **GLFT MM** — model-driven quantitative market making * **Orderbook Walls** — liquidity-wall maker entry and recovery * **EMA Singularity** — completed-candle extreme reversion * **RetShock** — return-shock admission and recovery * **Hydra** — dynamic-universe coordinated recovery * **Long-Only DCA** — long-only geometric DCA Each card has a plain-English description, risk label, and values read from the canonical configuration—no invented performance numbers. Click a card for details, choose an available venue variant, and Deploy opens a prefilled wizard. **Quick guide:** | Your Situation | Recommended Strategy | | ----------------------------- | --------------------------------------------------------- | | Beginner | A lower-exposure Conservative preset from the Marketplace | | Want to accumulate | Vortex DCA or Long-Only DCA | | Range-bound market | GLFT MM | | Signal-driven reversion | EMA Singularity or RetShock | | Dynamic multi-symbol recovery | Hydra | | Liquidation-driven campaigns | TBLTBS—read the dedicated guide first | | High-frequency quoting | XGrid | | \$500-1000 capital | Single strategy, 1-2 symbols | | \$2000+ capital | Multiple strategies/symbols (Pro tier) | See the [Strategy Overview](/strategies/overview) for detailed comparison. **Honest answer:** Returns vary significantly based on market conditions, strategy, and settings. Bad conditions can result in losses. **Important:** * Past performance doesn't guarantee future results * Start small to understand behavior * Never risk more than you can afford to lose **Yes, depending on your tier:** * **Free**: 1 bot, 1 symbol, 1 exchange * **Pro**: up to 5 bots, 10 symbols, 5 exchanges Each bot runs as its own independent process. **Recommendation:** start with one bot, add more as you learn. Check these indicators: 1. **Status**: Green = running, Red = error (Bots tab) 2. **Orders**: Should see open orders in the terminal and on your exchange 3. **Logs**: The bot's log stream shows activity 4. **Portfolio**: Track positions, P\&L, and your equity curve If orders appear and fill, the bot is working correctly. **Yes.** When adding exchange credentials, toggle the **Testnet** flag to connect to your exchange's paper-trading environment instead of live markets. *** ## Portfolio & Tracking Once you've added exchange API keys, VOIDX records an equity snapshot every 5 minutes. The Portfolio tab shows: * **Equity curve** with 1D / 7D / 30D / 90D timeframes * Per-exchange allocation * Bot performance * Open positions The curve starts empty and fills in as history is recorded. *** ## Risk & Safety **Yes, trading involves risk.** Possible loss scenarios: * Market moves strongly against your position * Liquidation if using high leverage * Extended drawdown before recovery * Black swan events (exchange hacks, flash crashes) **Mitigation:** * Start with conservative presets * Never risk more than you can afford to lose * Diversify across symbols/strategies If the bot disconnects: * Existing positions remain open * Open orders stay on exchange * No new orders placed until reconnect * Positions may not be managed (risk!) **Protection:** * Set stop losses on exchange manually * Monitor positions even when bot is off **Liquidation** = Exchange forcibly closes your position when margin is insufficient. **Avoid by:** * Using lower leverage (start with 10x or less) * Keeping wallet exposure conservative * Setting hard stop losses * Monitoring positions regularly See [Risk Management](/risk-management/risk-management-best-practices) for details. *** ## Technical Issues Common issues: 1. **API Keys**: Verify correct and have Trade permission 2. **Balance**: Ensure funds in correct wallet (Futures, not Spot) 3. **Symbol**: Check symbol is valid and tradeable 4. **Exchange**: Use the Test button on your credentials to verify the connection See [Troubleshooting](/troubleshooting) for detailed solutions. Normal behavior: * Grid refresh repositions orders as price moves * Orders cancel when price moves too far * Rate limiting may cancel excess orders If excessive, see [Troubleshooting](/troubleshooting). VOIDX is a web application - no installation needed! Requirements: * Modern web browser (Chrome, Firefox, Safari, Edge) * Stable internet connection * Exchange account with API access No server, VPS, or technical setup required — bots run as processes on VOIDX servers. *** ## Account & Billing **The Free tier is free** — no subscription, no PUMPKIN requirement. * Free: 1 bot, 1 symbol, 1 exchange * Pro: more bots/symbols/exchanges; a 14-day trial is available, and upgrading via PUMPKIN burn is coming soon * No trading fees beyond your exchange's own fees VOIDX also runs a separate decentralized exchange at [voidx.trade/dex](https://voidx.trade/dex), built on DeepBook on Sui. It's fully on-chain — no exchange API keys involved. See the [DEX documentation](/dex/overview). **Community Support:** * [Telegram Group](https://t.me/pumpkinsui) **GitHub:** * [Issues & Feature Requests](https://github.com/donewiththedollar) Response time: Usually within 24 hours. *** ## Advanced Currently, you can: * Deploy any Marketplace preset and customize its parameters in the deploy wizard * Adjust extensive configuration options Fully custom strategies require code changes (advanced users only). Yes! The terminal uses a REST API that advanced users can access: * WebSocket for real-time updates * REST for configuration and control Documentation coming soon. The platform is currently hosted - self-hosting is not supported. Benefits of hosted: * No server management * Automatic updates * 24/7 uptime * No technical setup *** ## Still Have Questions? Get help from other users Learn trading terms Fix common issues Browse all docs # Bot Management Source: https://docs.quantumvoid.org/features/bot-management The Bots tab — monitor, start, stop, and configure your deployed trading bots # Bot Management The **Bots** tab is where your deployed bots live. It shows everything you are running across all exchanges in one place — live status, PnL, uptime, and order activity — with one-click controls for starting, stopping, configuring, and deleting bots. To *find new* bots, head to the **[Marketplace](/features/marketplace)** — the Bots tab links to it from a banner at the top, and a **Browse Presets** button opens the preset library directly. The Bots tab showing the summary band and glassy bot cards with live status and PnL. Bot management requires a connected wallet. Guests see a prompt to connect, plus a shortcut to browse the Marketplace catalog in the meantime. *** ## What You See ### Summary Band A row of stats across the top of the bot list aggregates your whole fleet: * **Active bots** — running vs. total * **Combined PnL** — total profit and loss across all bots * **Open positions** — positions currently held by your bots * **Exchanges** — which exchanges your bots are deployed on ### Bot Cards Each bot gets a glassy card showing: * **Status** — a pulsing green dot while running; muted when stopped, red on error * **PnL headline** — the bot's profit and loss, front and center * **Strategy and exchange badges** — what it runs and where * **Symbol icons** — the trading pairs it manages, with token logos * **Uptime** — how long it has been running * **Orders/h** — recent order placement rate * **Action buttons** — Start, Stop, Settings, Delete * **Diagnostics expand** — opens an inline panel with details such as uptime and open position count ### Cards / Table Toggle On desktop you can switch between **Cards** (the default, friendlier view) and **Table** (a dense row layout with Status, Bot Name, Strategy, Exchange, Symbols, Uptime, PnL, Orders/h, and Actions columns — handy when you run many bots). Your choice is remembered. ### Filter Chips The **My bots** row filters the list: **All**, **Running**, or **Stopped**, each with a live count. *** ## How to Use It ### Deploying a Bot Click **Deploy New Bot** in the Bots tab header, pick a preset from **Browse Presets**, or deploy straight from the [Marketplace](/features/marketplace) or [Vaults](/features/vaults) — they all feed the same deploy wizard. The wizard arrives prefilled from the preset you chose. Adjust symbols or settings if you want, or accept the defaults. Confirm, and the bot starts placing orders through your saved exchange API keys. ### Stopping a Bot Click the **Stop** button on the bot's card and confirm. The bot stops placing new orders. Stopping a bot does not close its open positions. Manage or close those yourself from the Trade tab or your exchange. ### Changing Settings Click the **gear (Settings)** icon on any bot card to open its configuration. Adjust parameters and save — this is also how you turn a vault or marketplace deployment into a custom setup. ### Deleting a Bot Stopped bots can be removed with the **Delete** action. A confirmation dialog warns you that the configuration is permanently removed — this cannot be undone. *** ## Monitoring Tips * **Live refresh** — bot status and PnL refresh automatically every few seconds; no manual reload needed. * **Diagnostics** — expand a card's diagnostics when something looks off; it shows uptime and open position counts straight from the bot. * **Cross-check with Trade** — the **Bots** tab in the Trade view's bottom drawer shows the same bots next to the live chart, so you can watch a bot's orders against price action. * **Portfolio view** — the [Portfolio](/features/portfolio) tab ranks your bots by PnL in the Bot performance card. ### Running Multiple Bots You can run several bots at once — on different symbols of the same exchange, or spread across exchanges. Sensible guardrails: * Keep total exposure across bots within what your account can support * Avoid running two strategies that fight each other on the same symbol * Start small with any new preset and scale up after you have watched it run *** ## Troubleshooting **Bot won't start** 1. Exchange API keys are saved and valid (check the Add Exchange flow) 2. Your exchange futures wallet has sufficient balance 3. The symbol exists on the selected exchange **Bot stopped unexpectedly** 1. Check the card's status — an error state shows red 2. Expand diagnostics for details 3. Common causes: insufficient balance for the next order, expired API keys, exchange rate limits *** ## Next Steps * **[Marketplace](/features/marketplace)** — browse all 41 deployable presets * **[Vaults](/features/vaults)** — curated one-click deployments * **[Trading Console](/features/trading-console)** — watch your bots next to the live chart * **[Bot Configuration Guide](/bot-configuration)** — detailed parameter reference # Terminal Overview Source: https://docs.quantumvoid.org/features/dashboard-overview A tour of the VOIDX trading terminal — tabs, the Overview home screen, and how everything connects # Terminal Overview The **VOIDX Terminal** is the single interface for everything on the platform: manual trading, bot deployment, the preset marketplace, vaults, market scanning, and portfolio tracking. It uses the dark VOIDX Dusk theme throughout and is designed so you can find your account value, your bots, and your positions at a glance. You can browse the entire terminal as a guest — every tab is open. Connecting a wallet is only required when you want to *act*: deploy a bot, place an order, or save exchange API keys. The VOIDX terminal Overview tab showing the equity strip, running bots, open positions and open orders columns. *** ## The Tabs The terminal is organized into eight top-level tabs: | Tab | What it does | | --------------- | -------------------------------------------------------------------------------------------------------- | | **Overview** | Home screen — equity strip, running bots, open positions, open orders, recent activity | | **Portfolio** | Equity history chart, per-exchange allocation, bot performance, positions ([guide](/features/portfolio)) | | **Trade** | Manual trading — live chart, order book, order ticket ([guide](/features/trading-console)) | | **Bots** | Manage your deployed bots — start, stop, configure, monitor ([guide](/features/bot-management)) | | **Marketplace** | Browse and deploy ready-made bot presets ([guide](/features/marketplace)) | | **Markets** | Live volume and volatility scanner — find what's moving | | **Vaults** | Curated one-click strategy vaults ([guide](/features/vaults)) | | **Docs** | Opens this documentation site | *** ## The Overview Tab The Overview tab is the terminal's home screen. It is built from three bands. ### Band 1: Equity Strip A single row across the top anchored by **Total Equity** — rendered large so your account value is always the first thing you see. Next to it: * **Available** — balance available for trading * **Total PnL** — cumulative profit and loss * **Today** — last 24-hour performance * **Unrealized** — open position profit and loss * **Win Rate** — percentage of profitable trades * **Active Bots** — running vs. total (e.g. `3 / 5`) * **Trades** — total trade count On the right of the strip, an **equity sparkline** appears once equity history is being recorded, with 1D / 7D / 30D timeframe toggles. **Click the sparkline to open the full Portfolio view.** ### Band 2: Live Columns Three side-by-side columns give you the live state of your account: * **Running Bots** — each running bot with its exchange, primary symbol, and live PnL. Click a row to jump to that symbol's chart in the Trade tab. "View all" jumps to the Bots tab. * **Open Positions** — side (LONG/SHORT), symbol, size @ entry price, and unrealized PnL. Click a row to open it in the Trade tab. * **Open Orders** — side (BUY/SELL), symbol, and amount @ price for every resting order. If you are a brand-new user (wallet connected, but no exchange keys, bots, or positions yet), this band is replaced by a single "Start in 60 seconds" hero with two clear actions: **Connect an Exchange** or **Browse Vaults**. ### Explore Tiles Below the columns, four clickable tiles describe and link to the main product areas: **Trade**, **Bot Marketplace**, **Vaults**, and **Markets**. These appear for guests and logged-in users alike — they are the fastest way to jump around the terminal. ### Band 3: Quick Start and Recent Activity * **Quick Start** — shown until you are fully set up. Guests get a **Connect Wallet** button; connected users without exchange keys get **Add Exchange** and **Deploy Bot** buttons. Once you have saved credentials, the card disappears and hands the space to activity. * **Recent Activity** — a live feed of fills and bot events with color-coded severity dots (green success, amber warning, red error) and timestamps. * **Jump links** — a slim toolbar at the bottom linking to Markets, Bots, Vaults, and Trade. *** ## The Markets Tab The Markets tab is a live **volume and volatility scanner** for Bybit perpetuals, refreshed every 60 seconds. The Markets tab showing the scanner table with volume, ATRP and trend columns. **Summary band** (computed from the live scan): * **Markets** — number of symbols in the scan * **Top 1h Volume** — the highest-volume market right now * **Most Volatile (ATRP)** — the market with the highest Average True Range percentage * **MA Trend Breadth** — how many markets are trending bullish vs. bearish **Scanner table** — sortable by any column: | Column | Meaning | | ---------------- | -------------------------------------------------------------- | | Asset | Trading pair (with token logo) | | Price | Last price | | 1m / 5m / 1h Vol | Trading volume in USDT over each window | | ATRP | Average True Range as a percent of price — the volatility read | | 1m / 5m Spread | Recent bid/ask spread | | MA / EMA | Moving-average trend direction badges | A search box filters by asset name. **Click any row to open that market in the Trade tab** with the symbol and exchange pre-selected. Sort by ATRP descending to find the most volatile markets — useful for picking symbols for grid and market-making bots. *** ## Wallet Connection and Exchange Keys VOIDX is **non-custodial**. Two separate connections power the terminal: 1. **Wallet** — your identity on the platform. Connecting and signing a message authenticates you; no transaction is made and no funds move. 2. **Exchange API keys** — saved encrypted, per exchange, via the Add Exchange flow. Bots and manual orders are placed through these keys. Funds stay on your exchange account. Only enable **Read** and **Trade** permissions on your exchange API keys. Never enable **Withdraw**. *** ## Where to Go Next * **[Marketplace](/features/marketplace)** — deploy your first bot from a preset * **[Vaults](/features/vaults)** — the one-click curated route * **[Trading Console](/features/trading-console)** — manual trading in the Trade tab * **[Portfolio](/features/portfolio)** — track your equity over time * **[Bot Management](/features/bot-management)** — manage running bots # Bot Marketplace Source: https://docs.quantumvoid.org/features/marketplace Browse 80 current strategy cards across nine families and deploy canonical configurations on your own exchange accounts # Bot Marketplace The **Marketplace** is the complete browser for canonical VOIDX bot presets. The current registry contains **126 active underlying presets**, grouped into **80 cards across 9 strategy families**. Exchange variants are grouped where appropriate so one card can represent multiple venues without hiding configuration differences. Every deployment remains non-custodial: the bot trades through your exchange API credentials, and funds stay in your exchange account. The VOIDX Marketplace with the latest release shelf and strategy preset catalog. Guests can browse details and compare presets. Deployment requires wallet authentication and saved read/trade-only credentials for the selected exchange. ## Current Strategy Families | Family | In plain English | | --------------------------- | -------------------------------------------------------------------------------------------------------------- | | **TBLTBS** | Signal-admitted directional campaigns with LINEAR or structural DCA, protective hedging, and durable ownership | | **Vortex DCA** | Widening grids and wave-queue recovery with small take-profit cycles | | **XGrid / Perp MM** | High-frequency multilevel quoting and inventory recovery | | **GLFT MM** | Model-derived bid/ask placement with inventory skew | | **Orderbook Walls** | Maker entry, TP, and recovery around observed liquidity walls | | **EMA Singularity** | Completed-candle EMA-extreme reversion | | **RetShock** | Return-shock admission and bounded recovery | | **Hydra** | Dynamic-universe admission with coordinated account recovery | | **Geometric Long-Only DCA** | Long-only geometric accumulation and fixed-profit exits | Use the strategy filter to narrow the catalog. Current venue variants span **BloFin, Bybit, Aster, TxFlow, and DEFX**, but availability differs by family. ## Latest Shelf The Latest shelf is a manually curated release lineup, not a list generated from stale `NEW` tags. It currently highlights modern profiles such as Tyler's Liquidation Hunter, Cascade Maker exits, Peaks/Troughs Lambo, TBLTBS LINEAR, EMA Singularity, RetShock, Hydra, Vortex Anchored V2, and Orderbook Walls V2. Latest means recently promoted—not validated profitability or reduced risk. ## What's on a Card Each card includes: * preset and strategy name * exchange variant controls when applicable * author-assigned risk tier * canonical technical description * headline settings derived from the configuration * default or dynamic symbol behavior * details and deploy actions The detail view exposes scalar configuration values so you can audit what the deploy wizard will save. Units matter. For example, TBLTBS `wallet_exposure_ratio: 20` is a 20-times-equity planned-notional ratio, not 20%. Gross TP values are before fees, funding, spread, slippage, and trigger gaps. ## Tyler's Liquidation Hunter Tyler's Liquidation Hunter is a dedicated featured BloFin preset for experienced users who want the raw Cascade maker lifecycle in one obvious selection. * 6 directional seats * 20/20 long and short wallet-exposure ratios * 50x requested leverage with 20x minimum * 3 same-side liquidation prints in 10 seconds and \$1,000 combined notional * exact candle priority for a maximum of 6 minutes before seat mutation * one durable post-only maker starter before DCA * 6 long / 5 short Peaks/Troughs levels * 50% fixed tranche at +0.22% gross * native stop-market trailing for the remainder It shares the Cascade `BLC_` owner and durable namespace for controlled replacement. It is marked **unvalidated live-executable opt-in** and has no replay-performance proof. See [TBLTBS and Liquidation Hunter](/strategies/tbltbs). ## Deploying a Preset Your wallet authenticates your VOIDX account. Signing does not move trading funds. Add the intended exchange using credentials with **Read** and **Trade** only. Never enable withdrawal permission. Confirm the venue, exposure unit, leverage, concurrency, symbols, TP mode, stop behavior, and replacement requirements. The standard wizard receives a fresh copy of the canonical configuration. Optional changes become your saved custom policy. Confirm the bot has a current heartbeat and reconcile dashboard state with exchange positions and orders. ## Custom Strategies Marketplace also provides a named JSON custom-strategy editor. It validates configuration through the backend before saving. Credentials pasted into JSON are not accepted as a strategy source; use the encrypted exchange credential flow instead. A custom configuration is not automatically associated with a canonical preset unless it carries exact source identity. ## Preset Source and Updates New canonical deployments store stable preset metadata: ID, name, exchange, and content revision. This lets VOIDX detect when the source preset changes without pretending that local customization is outdated. When **Update from preset** appears, replacement requires explicit confirmation. It overwrites custom values with a new canonical copy. Updating a saved bot does not restart a running process. ## Switching and Existing Positions Stopping or switching a bot does not close positions. Use controlled replacement on accounts with live exposure. Never start two account-owning TBLTBS profiles side by side. Compatible TBLTBS profiles use durable, generation-fenced handoff. Existing exposure is adopted only with exact provenance and authoritative exchange truth; unresolved inherited campaigns remain protected no-growth caretakers. ## Choosing Safely 1. Check **exposure and position ceilings** before TP. 2. Read **leverage and seat count together**. 3. Understand whether the preset averages, hedges, stops, or simply holds. 4. Confirm the exit is fixed, trailing, partial-plus-trailing, or recovery-based. 5. Start smaller than your maximum risk tolerance. 6. Treat descriptions as configuration documentation, not return forecasts. ## Frequently Asked Questions From the canonical frontend preset registry used by the deploy wizard. Values describe the configuration that will be saved. It is a related preset tuned for a different venue. Marketplace may group variants on one card, but selecting another venue changes the actual configuration. Yes. Changes in the deploy wizard become your custom saved configuration. Later canonical updates never overwrite those values without explicit confirmation. No. Runtime policy is loaded at process startup. A running bot must be controlled separately. Compare risk, units, and update behavior Liquidation Hunter and safe campaign switching Browse the one-click vault catalog Control deployed instances # Portfolio Source: https://docs.quantumvoid.org/features/portfolio Track your account equity over time, see per-exchange allocation, bot performance, and open positions # Portfolio The **Portfolio** tab is your account's scoreboard: an equity chart showing how your balance has evolved, headline performance stats, a per-exchange allocation breakdown, a ranked list of your bots, and your open positions — all on one page. You can reach it from the nav bar, or by **clicking the equity sparkline** in the Overview tab's equity strip. The Portfolio tab showing the equity area chart, stat tiles, allocation bars and bot performance list. *** ## Equity Chart The hero of the page: your **total equity** as a large headline, with an area chart of equity history below it. * **Timeframes** — 1D, 7D, 30D, 90D tabs * **Period change** — the gain/loss for the selected window (in dollars and percent), computed strictly from the first and last points of the recorded series * **Hover tooltip** — exact equity and timestamp at any point on the curve ### How Equity History Works Equity snapshots are recorded **server-side every 5 minutes** once you have exchange API keys saved — the terminal does not need to be open for recording to continue. History starts when recording starts. There is **no backfill** — the chart cannot show equity from before your keys were added. Right after setup you will see "Collecting equity snapshots — first curve appears within minutes," and the longer timeframes fill in as days pass. *** ## Stat Tiles A row of tiles under the chart summarizes performance: * **Total PnL** — cumulative profit and loss * **Today** — last 24-hour performance * **Unrealized** — open position profit and loss * **Win Rate** — percentage of profitable trades * **Trades** — total trade count * **Active Bots** — running vs. total (e.g. `3 / 5`) *** ## Allocation The Allocation card breaks your equity down **per exchange**: * Each connected exchange shows its equity in dollars and as a **percentage share of your total**, with a colored share bar (BloFin blue, Bybit gold, and so on) * Exchanges are sorted largest first * A **Total** row sums everything at the bottom * If an exchange's balance fetch fails, the row flags the error instead of silently showing zero Allocation reads live balances from each exchange every 30 seconds — it is the quickest way to sanity-check that your capital is split the way you intend across venues. *** ## Bot Performance A ranked list of all your bots: * **Status dot** — green running, red error, grey stopped * **Bot name** and **strategy** label * **PnL** — signed, color-coded Running bots sort to the top, then by PnL magnitude. Click any row (or **View all**) to jump to the [Bots](/features/bot-management) tab for full controls. *** ## Positions An open-positions table for the currently selected exchange: | Column | Meaning | | ------ | ------------------------------------- | | Symbol | Trading pair, with token logo | | Side | LONG / SHORT badge | | Size | Position size | | Entry | Average entry price | | Mark | Current mark price | | uPnL | Unrealized PnL in dollars and percent | Positions are sorted by PnL magnitude so your biggest winners and losers surface first. *** ## Guests and Fresh Accounts * **Not connected?** The page renders with placeholder dashes and a **Connect Wallet** button inside the chart frame — connect to start tracking. * **Connected, no exchange keys?** Add keys via the Add Exchange flow; snapshot recording begins automatically once they are saved. * **Just added keys?** The chart shows the collecting state until at least two snapshots exist, then the curve appears. *** ## Related Documentation * **[Terminal Overview](/features/dashboard-overview)** — the equity strip and sparkline that link here * **[Bot Management](/features/bot-management)** — act on what the Bot performance list shows you * **[Trading Console](/features/trading-console)** — manage the positions listed here # Scaling Agent Source: https://docs.quantumvoid.org/features/scaling-agent Interactive AI assistant for optimizing your perp market maker settings # Scaling Agent The **Scaling Agent** is an interactive command-line assistant built into the Bot Management tab. It helps you optimize your perp market maker (perp\_mm) bot settings through natural conversation and guided commands. The Scaling Agent only works with **perp\_mm** strategy bots. Vortex DCA and other strategies use different parameters. *** ## 🚀 Getting Started ### Accessing the Agent 1. Navigate to **Bot Management** tab 2. Find the **Scaling Agent Console** at the top of the page 3. Type commands or natural language questions 4. Press Enter or click Send ### First Time? If you don't have a running perp\_mm bot, the agent will guide you to: 1. Select an appropriate preset (like "BloFin v7 Long Short Counterscalp") 2. Configure your exchange credentials 3. Start your first bot *** ## 💬 Commands Reference ### Quick Profiles Apply pre-tuned risk profiles instantly: | Command | Risk Level | equity\_pct | Leverage | Expected Returns | | --------------------- | ---------- | ----------- | -------- | ----------------- | | `/scale conservative` | Low | 3% | 10x | 0.5-1% daily | | `/scale moderate` | Medium | 5% | 50x | 1-3% daily | | `/scale aggressive` | High | 12% | 75x | 3-10% daily | | `/scale degen` | Extreme | 20% | 100x | 10-50%+ (or rekt) | **DEGEN mode** uses 100x leverage. You could lose your entire account. Only use with money you can afford to lose! ### Fine-Tune Settings Adjust individual parameters: ```bash theme={null} /set equity_pct 5 # Set equity percentage to 5% /set leverage 50 # Set leverage to 50x /set base_spread_bps 15 # Set spread to 15 basis points /set target_net_bps 11 # Set take-profit to 11 bps /set num_levels 7 # Set grid levels to 7 /set xgrid_enabled true # Enable XGrid counter scalp ``` **Available Parameters:** | Parameter | Range | Description | | -------------------- | ---------- | --------------------------- | | `equity_pct` | 0-50 | % of equity per grid cycle | | `leverage` | 1-125 | Position leverage | | `base_spread_bps` | 5-100 | Base spread in basis points | | `min_spread_bps` | 3-50 | Minimum spread floor | | `target_net_bps` | 3-50 | Take-profit target | | `num_levels` | 2-20 | Number of grid levels | | `hard_stop_loss_bps` | 50-3000 | Hard stop loss | | `xgrid_enabled` | true/false | Enable XGrid hedging | ### Analysis Commands ```bash theme={null} /status # Show current bot settings /risk check # Analyze your risk level /profit estimate # Estimate daily returns /overview # Show all bots across exchanges /symbols # Top symbols for market making ``` ### Learn ```bash theme={null} /explain equity_pct # How equity scaling works /explain xgrid # Counter-scalp hedging explained /explain leverage # Leverage and liquidation risk /explain spread # Understanding spreads and fees /explain grid # Grid levels explained ``` *** ## 🎯 Natural Language You can also just ask questions naturally: * **"I want more profit"** - Get scaling recommendations * **"Make my bot safer"** - Conservative settings guide * **"What's my risk level?"** - Risk analysis * **"Explain equity\_pct"** - Educational content * **"Need more grid levels"** - Grid configuration help *** ## 📊 /overview Command See all your running bots across exchanges: ``` /overview ``` **Returns:** * Active exchanges (Bybit, BloFin, etc.) * Running bot count * Total effective exposure across all bots * Per-bot breakdown with config, strategy, exposure * Risk warnings if exposure is high **Example output:** ``` **Bot Overview** **Active Exchanges:** blofin, bybit **Running Bots:** 2 **Total Effective Exposure:** 375% of equity --- **🟢 Running Bots:** **BLOFIN** - perp_mm - Config: BloFin v7 Long Short Counterscalp - Settings: 5% equity × 75x = **375%** exposure - Symbols: ASTER, SOL, XRP ⚠️ **Moderate Risk Level** Combined exposure: 375% - This is aggressive but manageable. ``` *** ## 📈 /symbols Command Get real-time symbol recommendations for market making: ``` /symbols # Uses your bot's exchange /symbols bybit # Force Bybit symbols ``` **Returns top 10 symbols ranked by MM Score:** | Symbol | Price | 1h Vol | Spread | ATRP | Trend | Score | | ------ | ------ | ------ | ------ | ---- | ----- | ----- | | ASTER | \$0.08 | \$2.1M | 0.05% | 0.32 | 🟢 | 8.5 | | SOL | \$185 | \$15M | 0.02% | 0.28 | 🟢 | 7.2 | | XRP | \$2.15 | \$8M | 0.03% | 0.25 | 🔴 | 6.8 | **MM Score Formula:** ``` (volume / 100K) × (1 / spread) × min(ATRP × 10, 5) × (leverage / 50) ``` **Best for MM:** High volume, low spread, moderate ATRP (0.1-0.5) *** ## ⚖️ Risk Profiles Explained ### Conservative ```json theme={null} { "equity_pct": 3.0, "leverage": 10, "base_spread_bps": 25, "target_net_bps": 15, "hard_stop_loss_bps": 200 } ``` * **Best for:** Learning, large accounts, uncertain markets * **Effective exposure:** \~30% of equity * **1% adverse move costs:** \~0.3% of account ### Moderate ```json theme={null} { "equity_pct": 5.0, "leverage": 50, "base_spread_bps": 15, "target_net_bps": 11, "hard_stop_loss_bps": 500 } ``` * **Best for:** Balanced risk/reward * **Effective exposure:** \~250% of equity * **1% adverse move costs:** \~2.5% of account ### Aggressive ```json theme={null} { "equity_pct": 12.0, "leverage": 75, "base_spread_bps": 10, "target_net_bps": 8, "hard_stop_loss_bps": 800 } ``` * **Best for:** Experienced traders, smaller accounts * **Effective exposure:** \~900% of equity * **1% adverse move costs:** \~9% of account ### Degen ```json theme={null} { "equity_pct": 20.0, "leverage": 100, "base_spread_bps": 8, "target_net_bps": 6, "hard_stop_loss_bps": 1500 } ``` * **Best for:** Gambling, "fun money" only * **Effective exposure:** \~2000% of equity * **1% adverse move costs:** \~20% of account Degen mode requires explicit confirmation. You will be asked to type `/confirm scale degen` before applying. *** ## 🧮 Key Concepts ### equity\_pct (The Growth Engine) Controls what % of your account equity is used for grid sizing: | equity\_pct | \$1,000 account | \$10,000 account | | ----------- | --------------- | ----------------- | | 3% | \$30 per cycle | \$300 per cycle | | 5% | \$50 per cycle | \$500 per cycle | | 10% | \$100 per cycle | \$1,000 per cycle | **Why it matters:** * As your account grows, positions automatically scale up * Combined with leverage: `equity_pct × leverage = effective exposure` * At 10% with 75x: effective exposure = 750% ### Effective Exposure Formula ``` Effective Exposure = equity_pct × leverage ``` **Example:** * 5% equity\_pct × 50x leverage = 250% exposure * A 1% adverse price move costs: 250% × 1% = **2.5% of your account** ### XGrid Counter Scalp When enabled, automatically opens counter-positions when market moves against you: 1. You're LONG, market dumps 2% 2. XGrid opens a SHORT position (counter-scalp) 3. If market keeps falling, SHORT profits offset LONG losses 4. If market reverses, original LONG profits **Best for:** Volatile, choppy markets where direction is uncertain *** ## ⚙️ How It Works ### Config Synchronization When you modify settings through the Scaling Agent: 1. **JSON file updated** - Bot process reads this on restart 2. **Database updated** - Frontend JSON editor shows new values 3. **Backup created** - Previous config saved with timestamp Changes require a **bot restart** to take effect. The running bot uses the config from when it started. ### Safety Features * **Automatic backups** before any change * **Validation** prevents invalid configurations * **Warnings** for dangerous settings * **Confirmation required** for degen mode *** ## 🛠️ Troubleshooting ### "No perp\_mm configs found" Your bot isn't using the perp\_mm strategy. The Scaling Agent only works with perp\_mm bots. **Solution:** Start a bot with a perp\_mm preset like "BloFin v7 Long Short Counterscalp" ### Changes not appearing in JSON editor SQLAlchemy JSON column detection issue (rare). **Solution:** Refresh the page after making changes ### Bot not using new settings Bots read config at startup only. **Solution:** Restart your bot after making changes *** ## 📚 Next Steps * **[Perp Market Maker Strategy](/strategies/perp-market-maker)** - Deep dive into the strategy * **[Bot Configuration](/bot-configuration)** - All 100+ parameters explained * **[Risk Management](/risk-management/risk-management-best-practices)** - Best practices * **[Trading Console](/features/trading-console)** - Monitor your bot logs **Happy scaling! 🚀** # Trading Console Source: https://docs.quantumvoid.org/features/trading-console The Trade tab — live chart, order book, and a full order ticket for manual perp trading # Trading Console The **Trade** tab is a full manual trading terminal for perpetual futures: a live candlestick chart, a real-time order book, and an order ticket that supports everything from a simple market order to TWAP and scaled-ladder execution. Orders are placed through your own saved exchange API keys. Guests can explore the whole view — the chart and order book are live. Placing orders requires a connected wallet and saved exchange credentials. The Trade tab with live chart, order book, order ticket and bottom drawer. First time here? A **"Take the tour"** pill appears for new visitors — an optional guided walkthrough that points out each part of the Trade view. Dismiss it any time. *** ## Layout ### Top Ribbon * **Symbol selector** — search any market, with a **Favorites** section for quick access to the pairs you trade most. * **Exchange selector** — switch between your connected exchanges; each shows its own equity. * Logged-out users see a prompt to connect an exchange instead of balance figures. ### Chart A native candlestick chart with selectable timeframes (1m, 5m, 15m, and more). It refreshes live without yanking your pan/zoom position back to default. ### Order Book Panel * **Order Book / Trades tabs** — switch between book depth and the live trade tape. * **My Orders toggle** — highlight your own resting orders inside the book. * **Price aggregation control** — group price levels into wider buckets to read depth at a glance. * **Depth toggle** — adjust how much of the book is shown. ### Order Ticket The right-hand panel where orders are built. Core order types are inline tabs, with advanced execution methods under **More**: | Method | What it does | | ----------- | ----------------------------------------------------------------- | | **Limit** | Resting order at your price | | **Market** | Immediate fill at the best available price | | **Stop** | Triggered order once price crosses your level | | **TWAP** | Splits your size into N slices spread evenly across a time window | | **Scale** | Ladders multiple limit orders across a price range | | **Iceberg** | Shows only part of your size at a time | | **Chase** | Re-prices your order to the top of the book every few seconds | | **Sniper** | Waits for a trigger price to cross, then fires a market order | **Ticket controls:** * **Buy / Sell** side selection * **Leverage slider** with quick-set buttons; cost and margin impact are estimated live, along with an approximate liquidation price * **Time in force** — GTC, IOC, or FOK * **Post Only** — ensures your limit order only adds liquidity (maker) * **Reduce Only** — order can only shrink an existing position, never open or grow one * **TP / SL** — attach take-profit and stop-loss brackets to the order * **Hedge / Cross badges** — the account runs in hedge mode (long and short can coexist on a symbol; required by the bot strategies) and cross margin. Switch to isolated margin from your exchange's own web UI if you need per-position risk caps. Large orders get a confirmation gate: live orders at **25x leverage or higher**, or with **notional of \$10,000 or more**, ask you to confirm before submission. ### Bottom Drawer A tabbed drawer along the bottom keeps your account state next to the chart: | Tab | Contents | | ------------- | --------------------------------------------------------- | | **Positions** | Open positions with size, entry, mark, and unrealized PnL | | **Orders** | Resting orders, with cancel controls | | **Bots** | Your bots, viewable without leaving the Trade view | | **Fills** | Recent executions | | **Activity** | Event feed — fills, bot events, errors | *** ## How to Place an Order Use the symbol selector (star your regulars as Favorites) and choose the exchange you want to trade on. Choose an order method, side, price, and size. Use the percentage shortcuts to size relative to your available balance at the current leverage. Toggle Post Only / Reduce Only, set time in force, and attach TP/SL brackets. Review the estimated cost, margin impact, and liquidation price, then submit. The order appears in the Orders tab; fills appear in Fills and Positions. *** ## Tips * **Click into the book** — use the order book to gauge where liquidity sits before placing limit orders; widen the aggregation to see the bigger structure. * **Markets tab first** — the [Markets scanner](/features/dashboard-overview#the-markets-tab) finds high-volume, high-volatility pairs; clicking a row lands here with the symbol preloaded. * **Watch bots from the drawer** — the Bots tab in the bottom drawer lets you watch a bot's orders hit the tape on the chart above it. * **Advanced methods need the engine running** — TWAP, Scale, Iceberg, Chase, and Sniper are executed client-side over time; keep the terminal open while they work. *** ## Related Documentation * **[Terminal Overview](/features/dashboard-overview)** — the full terminal tour * **[Bot Management](/features/bot-management)** — manage bots from the Bots tab * **[Marketplace](/features/marketplace)** — automate instead of trading manually # VOIDX Vaults Source: https://docs.quantumvoid.org/features/vaults Browse 91 one-click strategy vaults backed by canonical VOIDX presets and deploy on your own exchange account # VOIDX Vaults Vaults are one-click presentation cards backed by the same canonical configurations used in Marketplace. Choose a strategy and venue, review its settings, and launch through the standard deploy wizard on your own exchange credentials. Funds never leave your exchange. VOIDX uses read/trade-only API access to place and manage orders; wallet authentication is account identity, not custody. The VOIDX Vaults catalog with strategy cards, venue controls, risk tiers, and deploy actions. ## Current Catalog The current Vault catalog contains **91 vaults**: | Strategy | Vaults | | -------------------------- | -----: | | TBLTBS | 41 | | Orderbook Walls | 12 | | Vortex | 9 | | GLFT | 8 | | RetShock | 7 | | Hydra | 6 | | EMA Singularity | 4 | | Professional Market Making | 4 | A curated **Latest** rail promotes selected modern profiles. Latest is a product shelf, not a profitability ranking. ## What a Vault Card Shows * strategy and preset name * exchange badge and supported venue * risk tier * exposure or position sizing summary * level count or core geometry * feature summary * default/static symbols or dynamic-universe behavior * deploy action linked to the exact canonical preset Some cards offer symbol, exposure, or leverage controls. A control is applied only when the deploy flow includes it; always inspect the resulting configuration before confirmation. ## Tyler's Liquidation Hunter Vault **BloFin Tyler's Liquidation Hunter** is an aggressive TBLTBS vault designed to make the production raw Cascade profile easy to find and switch to. | Setting | Value | | ------------------ | -------------------------------------------------- | | Seats | 6 directional campaigns | | Exposure | 20×/20× wallet-equity ratios | | Requested leverage | 50x, minimum 20x | | Cascade | 3 same-side prints / 10 seconds / \$1,000 combined | | Preflight | Exact priority candle proof, bounded at 6 minutes | | Entry | Durable post-only maker starter before DCA | | Grid | 6 long / 5 short Peaks/Troughs levels | | Exit | 50% at +0.22% gross, then native trailing | | Trail | +0.35% ordinary activation, 0.10% distance | This is an unvalidated, high-exposure live-executable opt-in with no replay-performance proof. `wallet_exposure_ratio: 20` means planned notional can be many times wallet equity; it does not mean 20%. Read [TBLTBS and Liquidation Hunter](/strategies/tbltbs) before deployment. Liquidation Hunter shares the Cascade `BLC_` campaign owner, namespace, and account lock. It is replacement-only and must not run beside another TBLTBS account owner. ## Getting Started Authenticate the VOIDX account that owns the saved exchange connection. Save credentials through the encrypted exchange flow. Enable only Read and Trade. Never enable Withdraw. Match venue, risk tier, exposure unit, leverage, and campaign behavior to your account. Confirm symbols, concurrency, TP mode, stop behavior, and recovery policy. Do not rely on the card title alone. Confirm a healthy runtime heartbeat and reconcile live exchange positions and orders. ## Strategy Highlights ### TBLTBS Directional campaign profiles including LINEAR, Peaks/Troughs Lambo, Cascade Maker, fixed/trailing/partial exits, adaptive terminal policies, protective hedging, Profitable Recycle, Profit Danger, and Professional Auto-Reduce. TBLTBS profiles that share an account use controlled replacement and durable ownership handoff. Existing exposure is never assumed from a prefix alone. ### Orderbook Walls Maker-entry and recovery profiles derived from observed book liquidity. Risk tiers and V1/V2 lifecycle choices vary by venue. ### Vortex Grid and wave-queue DCA profiles. Anchored variants reduce price churn; multi-symbol variants allocate independent campaign budgets. ### GLFT and Professional MM Two-sided market-making vaults with inventory controls, position ceilings, spread logic, and recovery behavior. GLFT derives offsets from model inputs; Professional MM uses configured execution and inventory rules. ### EMA Singularity and RetShock Signal-driven profiles that wait for completed-candle extremes or return-shock events rather than quoting continuously. ### Hydra Dynamic-universe, account-coordinated admission and recovery profiles. Risk tiers change concurrency and daily-loss policy while preserving the core lifecycle. ## Vaults vs Marketplace Both deploy canonical presets through the same wizard. * **Vaults** emphasize one-click discovery, feature summaries, and release curation. * **Marketplace** provides the complete grouped preset browser, exchange variants, technical details, and custom JSON tools. A vault does not create a custodial fund or pooled account. It creates a standard user-owned bot configuration. ## Managing a Deployed Vault After deployment: * the bot appears in Bot Management * live status depends on exact process identity and heartbeat freshness * settings edit the saved configuration * a preset update requires explicit confirmation * updating saved configuration does not automatically restart a running bot * stopping does not close positions If an account has live positions, use the controlled strategy-switch workflow. Manual concurrent owners or guessed order ownership can duplicate growth or remove protection. ## Frequently Asked Questions No. Funds remain on your exchange. Use read/trade-only credentials and disable withdrawals. A vault references a canonical Marketplace preset by stable ID. Its card is a curated presentation of the same deployable configuration. Yes. Changes made in the deploy wizard become a custom saved configuration. Future source updates require explicit replacement confirmation. No. Stopping a bot stops automation; it does not liquidate or close exchange positions. During a proven TBLTBS strategy handoff, an inherited campaign may remain protected while all new growth is blocked. It can be promoted only when ownership, account capacity, and exchange truth are authoritative. Browse all active preset cards Liquidation Hunter and safe switching Monitor and control deployed bots Operational and account safety guidance # Glossary Source: https://docs.quantumvoid.org/glossary Trading terms and platform concepts explained # Glossary A comprehensive glossary of trading terms and VoidX-specific concepts. *** ## A ### ATR (Average True Range) A volatility indicator measuring the average range of price movement over a period. Used to set dynamic stop losses and position sizing. ### Auto-Hedging Automatic opening of an opposing position when your main position exceeds a loss threshold. Protects against further losses while waiting for recovery. ### Ask The lowest price at which someone is willing to sell. Also called the "offer" price. *** ## B ### Basis Points (bps) One basis point = 0.01%. Used to express small percentages. * 100 bps = 1% * 10 bps = 0.1% * 1 bp = 0.01% ### Bid The highest price at which someone is willing to buy. ### Breakeven The price at which your position has zero profit or loss after fees. *** ## C ### Cascade A rapid series of liquidations causing accelerated price movement. Often triggers a "domino effect" of forced selling/buying. ### Cluster (Grid Cluster) A group of orders placed at specific price levels in a DCA strategy. ### Counter Position A position opened opposite to your main position, typically to hedge or scalp during adverse moves. ### Cross Margin A margin mode where all available balance is used as collateral for positions. Higher risk of total liquidation but more efficient capital use. *** ## D ### DCA (Dollar-Cost Averaging) An investment strategy of spreading purchases over time/price levels to reduce the impact of volatility. ### Decay Factor In geometric sizing, the multiplier applied to each subsequent level. `0.92` means each level is 92% the size of the previous. ### Donchian Channel A technical indicator showing the highest high and lowest low over a period. Used for breakout detection. ### Drawdown The decline from a peak to a trough in your portfolio value. Usually expressed as a percentage. *** ## E ### EMA (Exponential Moving Average) A moving average that gives more weight to recent prices. Faster to react than SMA. ### Entry Price The average price at which you opened your position. *** ## F ### Funding Rate A periodic payment between long and short position holders in perpetual futures. Positive rate = longs pay shorts; negative = shorts pay longs. ### Fill When your order executes and becomes a position. A "partial fill" means only some of your order executed. *** ## G ### Geometric Grid A grid where spacing between orders increases geometrically (exponentially) as you move away from current price. ### Grid Refresh The process of canceling existing orders and placing new ones as price moves. ### GTFO (Get The F\*\*\* Out) An exit strategy that aggressively closes positions when conditions turn adverse. *** ## H ### Hedge Mode An exchange feature allowing simultaneous long AND short positions on the same symbol. ### HFT (High-Frequency Trading) Trading strategies that execute many trades per second. In VoidX, refers to fast-cycling market making. *** ## I ### Inventory Your current position size. "High inventory" means you're heavily positioned. ### Inventory Skew Adjusting bid/ask prices based on your current position to encourage rebalancing. ### Isolated Margin A margin mode where only the assigned margin is at risk for each position. Limits loss but may cause earlier liquidation. *** ## L ### Leverage Multiplier for your position size relative to margin. 10x leverage = control $10,000 with $1,000 margin. ### Liquidation Forced closure of your position when margin is insufficient. Results in loss of position and possibly additional fees. ### Liquidation Price The price at which your position will be forcibly closed by the exchange. ### Loss Management Tiers Progressive risk reduction based on loss depth: * Tier 1 (100 bps): Widen spreads * Tier 2 (300 bps): Stop new entries * Tier 3 (600 bps): Exit priority only *** ## M ### Maker An order that adds liquidity to the order book (typically limit orders). Usually has lower fees. ### Market Making A strategy of providing liquidity by placing both buy and sell orders, profiting from the spread. ### Margin The collateral required to open and maintain a leveraged position. ### Microprice A refined mid-price calculation weighted by order book depth on each side. *** ## N ### NATR (Normalized ATR) ATR expressed as a percentage of price. Allows comparison across different price levels. ### Net Delta The combined directional exposure of all your positions. *** ## O ### OBI (Order Book Imbalance) The ratio of bid volume to ask volume in the order book. High OBI suggests buying pressure. ### Order Book The list of all open buy and sell orders for a trading pair, organized by price. ### Outer Distance In Vortex DCA, how far from current price to place the furthest order. *** ## P ### Panic Threshold The inventory level at which the bot becomes more aggressive about exiting positions. ### Perpetual Futures (Perps) Futures contracts with no expiration date. Settled via funding rate mechanism. ### Position Size The total value or quantity of your open position. *** ## Q ### Quote A bid/ask price pair offered by a market maker. ### Quote Size The size of each individual order in your trading grid. *** ## R ### Ratio Power In geometric grids, the exponent controlling how quickly spacing increases. ### Reactive Spacing Dynamic order spacing that adjusts based on market conditions (volatility, depth, flow). ### Refresh Threshold The price movement percentage that triggers grid recalculation. *** ## S ### SLAM A high-velocity market making technique that quickly enters and exits during momentum moves. ### Slippage The difference between expected price and actual execution price. ### Spread The difference between bid and ask prices. Market makers profit from this. ### Stop Loss An order to close a position when price reaches a certain level, limiting losses. *** ## T ### Take Profit (TP) An order to close a position when price reaches a profit target. ### Taker An order that removes liquidity from the order book (typically market orders). Usually has higher fees. ### Time Decay (Position) The principle that positions held longer without profit should be closed more aggressively. ### Trap Detector A system that identifies when your position is being "trapped" by adverse price movement. *** ## U ### Underwater A position that is currently at a loss. "5% underwater" = 5% unrealized loss. *** ## V ### Virtual Chunking A position recovery technique that mentally divides a losing position into chunks and recovers each separately. ### Volatility The degree of price movement. Higher volatility = larger price swings. ### Vortex DCA VoidX's intelligent DCA strategy with geometric spacing and recovery features. *** ## W ### Wallet Exposure The percentage of your total wallet allocated to a symbol or strategy. ### Whale A trader with large capital who can significantly move prices. ### Whale Wall A large order visible in the order book, often providing support or resistance. ### Whiplash Rapid back-and-forth price movement that can trigger multiple entries/exits. *** ## X ### XGrid VoidX's momentum-based strategy using EMA crossovers and Donchian channels. ### XGrid Counter Scalp Opening positions opposite to your main position when XGrid signals a trend reversal. *** ## Numbers ### 11/23 EMA The default EMA periods used by XGrid for crossover detection. ### 100 bps One percent (100 basis points). *** ## Need More Help? Frequently asked questions Get help from the community # Welcome to VOIDX Source: https://docs.quantumvoid.org/index Algorithmic trading terminal — deploy automated strategies on your own exchange API keys, plus an on-chain DEX on Sui ## What is VOIDX? VOIDX is an **algorithmic trading terminal** at [voidx.trade](https://voidx.trade). It does two things: 1. **Automated trading bots** — deploy ready-made strategies that trade on **your own exchange API keys**. VOIDX never holds your funds. 2. **On-chain DEX** — a separate decentralized exchange at [voidx.trade/dex](https://voidx.trade/dex), built on DeepBook on Sui. See the [DEX docs](/dex/overview). VOIDX terminal Overview tab showing the navigation bar, quick start panel, and live market data Click **Launch App** to open the terminal. You can browse everything — the Marketplace, Markets, strategy details — **without connecting a wallet**. Connecting is only needed when you want to act. From zero to your first deployed bot, step by step 80 current preset cards across 9 strategy families — browse, compare, deploy How TBLTBS, Vortex, market making, signal, and recovery families work Trade on-chain on Sui via DeepBook — no API keys needed *** ## The Terminal The app is organized into tabs: | Tab | What it's for | | --------------- | --------------------------------------------------------------------------------- | | **Overview** | Quick start, market snapshot, and your account at a glance | | **Portfolio** | Equity curve (1D/7D/30D/90D), per-exchange allocation, bot performance, positions | | **Trade** | Manual trading on your connected exchanges | | **Bots** | Manage your running bots — status, logs, start/stop | | **Marketplace** | Browse and deploy preset bots | | **Markets** | Market data and discovery | | **Vaults** | Pre-configured one-click strategies | | **Docs** | Opens this documentation | ## Bot Marketplace The Marketplace is where most users start. It currently groups **126 active presets into 80 cards across 9 strategy families**, including TBLTBS, Vortex DCA, XGrid, GLFT MM, Orderbook Walls, EMA Singularity, RetShock, Hydra, and Long-Only DCA. Descriptions and stat tiles come from the canonical configuration registry—never invented performance figures. VOIDX Bot Marketplace showing preset cards with strategy family badges, stat tiles, and deploy buttons Click a card to open its detail view, choose an available venue variant, and hit **Deploy**—the deploy wizard opens prefilled with that preset's settings. Current registry venues include BloFin, Bybit, Aster, TxFlow, and DEFX. ## How It Works Open [voidx.trade](https://voidx.trade) and explore. No wallet, no signup — guests see everything. Connect a Sui, Solana, or EVM wallet. **No PUMPKIN tokens needed for the Free tier.** Add API keys for your exchange (trade permission only — never enable withdrawals). Keys are stored encrypted. Pick a preset, deploy it, and monitor it in the Bots and Portfolio tabs. Each bot runs as its own process and trades through your keys. **Non-custodial by design.** Bots trade through your exchange API keys. Your funds never leave your exchange account, and VOIDX cannot withdraw them. ## Free and Pro Tiers * **Free** — connect a wallet and start: 1 bot, 1 symbol, 1 exchange. No PUMPKIN required. * **Pro** — 5 bots, 10 symbols, 5 exchanges. A 14-day Pro trial is available (no card required). Upgrading via PUMPKIN burn is coming soon. See the [PUMPKIN Token page](/pumpkin-token) for details. ## Supported Exchanges * **BloFin** - Primary CEX with advanced features * **Bybit** - Popular derivatives exchange * **HTX** (Huobi) - Global exchange platform * **WEEX** - Low-fee trading * **DEFX** - Decentralized derivatives ## Affiliates Sign up with our partner exchanges using these referral links for exclusive benefits: 5% cashback on trading fees Leading derivatives platform Low-fee perpetual trading ## Need Help? Common issues and solutions Get support from the community *** **Trading involves risk.** Start with small amounts and conservative settings while learning the system. Never invest more than you can afford to lose. # PUMPKIN Token Source: https://docs.quantumvoid.org/pumpkin-token The PUMPKIN token and the VOIDX Free/Pro tier system # PUMPKIN Token PUMPKIN is the VOIDX platform token. **You no longer need PUMPKIN to access the platform** — the Free tier requires none. PUMPKIN's role is the upgrade path to Pro. ## Free and Pro Tiers **No PUMPKIN needed** Connect a wallet and start: 1 bot, 1 symbol, 1 exchange **5 bots · 10 symbols · 5 exchanges** Plus priority support and advanced strategies. A 14-day Pro trial is available (no card required). Upgrading via PUMPKIN burn is coming soon. **No gate on entry**: connecting your wallet is enough for the Free tier. PUMPKIN is only involved when upgrading to Pro (burn flow coming soon). ## Supported Wallets & Chains PUMPKIN is available on multiple chains. Connect with any of these wallets: Sui Wallet, Suiet, Ethos Phantom, Solflare MetaMask, Coinbase Wallet ## Token Details ### SUI Network `0x09f1c8f05cb47bbcb61133dd2ef00583720694f41d4f8a61c94467d8f5911a14::pumpkin::PUMPKIN` 6 ### Solana Network `3o41UUScNQ9zorbJnJRzirc7utQzhCA8QMvTKWo2wWEw` ## Where to Buy ### On SUI Swap SUI for PUMPKIN Trade on Aftermath Finance ### On Solana Purchase on any Solana DEX supporting the PUMPKIN token. Purchase from a major exchange (Binance, OKX, Coinbase, etc.) Install a compatible wallet for your chosen chain Use a DEX to swap for PUMPKIN tokens Connect your wallet at [voidx.trade](https://voidx.trade) and start deploying bots ## How Tiers Are Resolved Connect your SUI, Solana, or EVM wallet to voidx.trade — no PUMPKIN balance needed You start on the Free tier: 1 bot, 1 symbol, 1 exchange A 14-day Pro trial is available, and whitelisted addresses get Pro automatically Burning PUMPKIN through the upgrade flow will unlock Pro — watch the announcements channel for details ## Whitelist Some wallet addresses are **whitelisted** and receive Pro tier automatically: * Team members * Early supporters * VIP users Whitelist status is managed by Quantum Void Labs. Contact support for inquiries. ## Security No tokens are ever transferred or locked while you hold You maintain full custody of your PUMPKIN Can sell/transfer tokens anytime — the Free tier never depends on your balance ## FAQ **None for the Free tier.** Connect a wallet and you have access. PUMPKIN comes into play for the Pro upgrade (burn flow coming soon — amounts will be announced). No. Platform access does not depend on your PUMPKIN balance. PUMPKIN exists on SUI, Solana, and BASE — buy and hold on whichever chain you prefer. For connecting to VOIDX, Sui, Solana, and EVM wallets are all supported. Pro unlocks 5 bots, 10 symbols, and 5 exchanges (Free is 1/1/1), plus priority support and advanced strategies. A 14-day trial is available, and upgrading via PUMPKIN burn is coming soon. Whitelisted addresses receive the Pro tier automatically. No tokens needed. Ready to deploy bots? Follow the quickstart guide # Quickstart Source: https://docs.quantumvoid.org/quickstart From browsing to your first deployed bot # Your First Bot on VOIDX This guide walks you through the current VOIDX flow: **browse → connect → add API keys → deploy from the Marketplace**. By the end, you'll have a bot running on your own exchange account. **What you'll need:** * A wallet — Sui, Solana, or EVM (MetaMask, Phantom, Sui Wallet, etc.) * An exchange account — BloFin, Bybit, HTX, WEEX, or DEFX * Trading capital in your exchange futures wallet (\$500+ recommended) **You do NOT need PUMPKIN tokens.** The Free tier requires none. **Security first:** Never share your API keys, wallet private keys, or passwords with anyone. VOIDX will NEVER ask for your private keys, and your API keys should never have withdrawal permission. *** ## Step 1: Browse Without Connecting (0 minutes setup) Go to [voidx.trade](https://voidx.trade) and click **Launch App**. You don't need a wallet or an account to look around. As a guest you can: * Open the **Marketplace** tab and browse all preset bots * Click any card to see its full detail view — strategy explanation, stat tiles, exchange variants * Check the **Markets** tab for market data * Read strategy descriptions before risking anything Actions (deploying, trading) are gated — buttons will say **"Connect wallet to deploy"** until you connect. Spend a few minutes in the Marketplace first. Picking a strategy you understand matters more than any setting. *** ## Step 2: Connect Your Wallet (2 minutes) In the top bar, click **Connect Wallet** and choose your chain: Sui, Solana, or EVM (BSC, Base, Ethereum). Your wallet extension will prompt you — click Approve. Sign the message to verify wallet ownership. This is a signature only — no transaction, no gas, nothing leaves your wallet. **No PUMPKIN needed for the Free tier.** Connecting a wallet gives you Free tier access: 1 bot, 1 symbol, 1 exchange. Pro (5 bots, 10 symbols, 5 exchanges) is available via a 14-day trial. See [PUMPKIN Token](/pumpkin-token). **What you'll see:** the top bar now shows your wallet address and a tier badge (FREE or PRO). The Overview tab's Quick Start panel switches to prompt you for exchange API keys. *** ## Step 3: Add Exchange API Keys (5 minutes) ### 3.1 Create API Keys on Your Exchange 1. Log in to BloFin 2. Go to **Account** → **API Management** 3. Create new API key with: * [x] Read * [x] Trade * [ ] Withdraw (NEVER enable!) 4. Set a passphrase 5. Copy: API Key, Secret, Password [Full BloFin Guide →](/exchanges/blofin) 1. Log in to Bybit 2. Go to **Account** → **API** 3. Create new API key with: * [x] Read * [x] Trade (Contract) * [ ] Withdraw (NEVER enable!) 4. Copy: API Key, Secret [Full Bybit Guide →](/exchanges/bybit) 1. Log in to HTX 2. Go to **Account** → **API Management** 3. Create new key with Trade permission 4. Copy: API Key, Secret [Full HTX Guide →](/exchanges/htx) 1. Log in to WEEX 2. Go to **Account** → **API Management** 3. Create new key with passphrase 4. Copy: API Key, Secret, Passphrase [Full WEEX Guide →](/exchanges/weex) For DEFX (decentralized derivatives), see the [DEFX guide](/exchanges/defx). ### 3.2 Add Keys to VOIDX On the **Overview** tab, the Quick Start panel shows an **Add Exchange** button once your wallet is connected. * Select your exchange * Paste API Key and Secret * Enter Password/Passphrase (BloFin and WEEX require it; BloFin's broker ID is filled in automatically) Use **Test** to confirm the keys work before relying on them. **Want to practice first?** When adding credentials you can toggle **Testnet** to connect to your exchange's paper-trading environment instead of live markets. **What you'll see:** your exchange appears in your credentials list, and the Portfolio tab starts recording your equity (a snapshot every 5 minutes) so the equity curve fills in over time. *** ## Step 4: Deploy a Bot from the Marketplace (5 minutes) VOIDX Bot Marketplace showing preset cards grouped by strategy family with stat tiles and deploy buttons You'll see 80 current cards grouped from 126 active presets across 9 families: **TBLTBS**, **Vortex DCA**, **XGrid**, **GLFT MM**, **Orderbook Walls**, **EMA Singularity**, **RetShock**, **Hydra**, and **Long-Only DCA**. Filter by family using the chips at the top. Each card shows a plain-English description, a risk label (Conservative / Moderate / Aggressive), and stat tiles read from the preset's actual configuration. Beginners: start with a **Conservative** preset. Click the card to see the full breakdown of how the strategy behaves and what each stat means. If a preset is available on multiple exchanges, toggle to the venue where you saved credentials. Current registry venues include BloFin, Bybit, Aster, TxFlow, and DEFX. The deploy wizard opens **prefilled** with the preset's settings. Review them, pick your symbol, and confirm. **What you'll see:** your new bot appears in the **Bots** tab with a status indicator. Each bot runs as its own process on VOIDX servers and trades through your API keys. *** ## Step 5: Verify It's Working (5 minutes) ### Check These Indicators **Status is green** — the bot is running without errors (Bots tab) **Orders visible** — open orders appear on your exchange and in the terminal **Logs updating** — the bot's log stream shows activity **Portfolio filling in** — the equity curve on the Portfolio tab starts recording ### What to Expect **First few minutes:** * Bot analyzes market conditions * Places initial orders * You'll see orders in the terminal and on your exchange **First hours:** * Some orders may fill, depending on market movement * A position may open and P\&L starts tracking **First day:** * Multiple fills are likely in normal conditions * Positions grow and shrink as the strategy works *** ## What's Next? Learn how each strategy family works Adjust parameters for your style Protect your capital Trade on-chain on Sui via DeepBook *** ## Common First-Timer Questions It depends on market conditions. In active markets, you might see fills within hours. In quiet markets, it might take longer. **Don't expect:** Instant profits **Do expect:** Activity within 24 hours in normal conditions This is normal! DCA-style strategies are designed to average into positions and recover. * Small unrealized losses are expected * The system has recovery mechanisms * Only worry at large drawdowns **First week:** Check daily to understand behavior **After learning:** Weekly checks are usually fine **Exception:** Highly volatile markets — check more often Consider stopping when: * You want to take profits * Market conditions are extreme * You don't understand what's happening * You're approaching loss limits Don't stop just because of small fluctuations — that's normal! *** ## Need Help? Common questions answered Get help from the community # Auto-Hedging Configuration Source: https://docs.quantumvoid.org/risk-management/auto-hedging-configuration Complete reference for all auto-hedge parameters and settings # Auto-Hedging Configuration Guide This guide covers all configuration parameters for the auto-hedge feature, including recommended values for different trading styles and risk profiles. *** ## 📋 Configuration Parameters ### Core Settings | Parameter | Type | Default | Description | | ---------------------------------------------- | ------- | ------- | ------------------------------------------------------------ | | `vortex_autohedge_enabled` | boolean | `false` | Enable auto-hedge feature (replaces liquidation safeguard) | | `vortex_autohedge_ratio` | float | `0.5` | Percentage of position to hedge (0.5 = 50%) | | `vortex_autohedge_on_drawdown_pct` | float | `0.04` | Trigger hedge when position loses this % (0.04 = 4%) | | `vortex_autohedge_on_liquidation_distance_pct` | float | `0.10` | Trigger hedge when liquidation is within this % (0.10 = 10%) | | `vortex_autohedge_tp_target` | float | `0.002` | Take profit target for hedge orders (0.002 = 0.2%) | ### Trailing Stop Settings | Parameter | Type | Default | Description | | ---------------------------------------- | ------- | ------- | --------------------------------------------- | | `vortex_autohedge_trailing_stop_enabled` | boolean | `true` | Enable trailing stop for hedge positions | | `vortex_autohedge_trailing_distance_pct` | float | `0.002` | Trailing stop distance (0.002 = 0.2% retrace) | *** ## 🎯 Parameter Deep-Dive ### 1. Enable Auto-Hedge ```json theme={null} { "vortex_autohedge_enabled": true } ``` **Effect:** * Replaces liquidation safeguard with auto-hedging * Enables continuous monitoring of position drawdown * Allows hedge order placement **When to Enable:** * ✅ Aggressive HFT grids with high wallet exposure * ✅ Volatile markets where liquidation risk is higher * ✅ When you want maximum grid uptime * ❌ Conservative low-leverage trading * ❌ Spot trading (no short positions available) When enabled, the traditional liquidation safeguard is automatically disabled! *** ### 2. Hedge Ratio ```json theme={null} { "vortex_autohedge_ratio": 0.5 } ``` **What It Does:** Controls what percentage of your NET position gets hedged when triggered. **Examples:** | Ratio | NET Position | Hedge Size | Result | | ----- | ------------ | ------------ | -------------------- | | 0.3 | 10,000 LONG | 3,000 SHORT | 7,000 NET LONG | | 0.5 | 10,000 LONG | 5,000 SHORT | 5,000 NET LONG | | 0.7 | 10,000 LONG | 7,000 SHORT | 3,000 NET LONG | | 1.0 | 10,000 LONG | 10,000 SHORT | 0 NET (fully hedged) | **Recommendations:** **Conservative (0.7-1.0):** ```json theme={null} { "vortex_autohedge_ratio": 0.7 } ``` * Higher hedge ratio = more protection * Suitable for low-risk tolerance * Better for smaller accounts **Balanced (0.5-0.6):** ```json theme={null} { "vortex_autohedge_ratio": 0.5 } ``` * Standard 50% hedge * Good balance of protection and exposure * **Recommended for most users** **Aggressive (0.3-0.4):** ```json theme={null} { "vortex_autohedge_ratio": 0.3 } ``` * Lower hedge ratio = more exposure remains * For experienced traders * Maximizes profit potential but higher risk *** ### 3. Drawdown Trigger ```json theme={null} { "vortex_autohedge_on_drawdown_pct": 0.04 } ``` **What It Does:** Triggers hedge when your position loses this percentage from entry price. **Calculation:** ``` LONG Position: Drawdown = (Entry Price - Current Price) / Entry Price SHORT Position: Drawdown = (Current Price - Entry Price) / Entry Price ``` **Example:** ``` Entry: $0.17000 (LONG) Current: $0.16320 Drawdown: (0.17000 - 0.16320) / 0.17000 = 4.0% <- TRIGGER! ``` **Recommendations:** | Risk Profile | Drawdown % | When to Use | | ----------------- | ---------- | ------------------------------------- | | Very Conservative | 2-3% | Low volatility assets, small accounts | | Conservative | 3-4% | **Default recommendation** | | Balanced | 4-5% | Moderate volatility, medium accounts | | Aggressive | 5-8% | High volatility, experienced traders | | Ultra Aggressive | 8-10% | Maximum grid operation, experts only | **Configuration Examples:** **Conservative:** ```json theme={null} { "vortex_autohedge_on_drawdown_pct": 0.03 } ``` Triggers hedge earlier, provides more protection. **Aggressive:** ```json theme={null} { "vortex_autohedge_on_drawdown_pct": 0.08 } ``` Allows deeper drawdowns before hedging, maximizes grid fills. For volatile assets like DOGE or meme coins, use 4-5%. For stable assets like BTC, use 3-4%. *** ### 4. Liquidation Distance Trigger ```json theme={null} { "vortex_autohedge_on_liquidation_distance_pct": 0.10 } ``` **What It Does:** Triggers hedge when liquidation price is within this percentage of current price. **Calculation:** ``` LONG Position: Liq Distance = (Current Price - Liquidation Price) / Current Price SHORT Position: Liq Distance = (Liquidation Price - Current Price) / Current Price ``` **Example:** ``` Current Price: $0.17200 Liquidation Price: $0.15500 Liq Distance: (0.17200 - 0.15500) / 0.17200 = 9.9% <- TRIGGER! ``` **Recommendations:** | Leverage | Liq Distance % | Explanation | | -------- | -------------- | ------------------------------ | | 5x | 15-20% | More buffer before liquidation | | 10x | 12-15% | Moderate buffer | | 20x | **10-12%** | **Standard for high leverage** | | 50x | 5-8% | Very tight buffer, aggressive | **Configuration Examples:** **Low Leverage (5x-10x):** ```json theme={null} { "vortex_autohedge_on_liquidation_distance_pct": 0.15 } ``` **Medium Leverage (10x-20x):** ```json theme={null} { "vortex_autohedge_on_liquidation_distance_pct": 0.10 } ``` **High Leverage (20x-50x):** ```json theme={null} { "vortex_autohedge_on_liquidation_distance_pct": 0.08 } ``` Critical override: If liquidation distance drops below 3%, hedge triggers immediately regardless of anti-cascade logic! *** ### 5. Hedge Take Profit Target ```json theme={null} { "vortex_autohedge_tp_target": 0.002 } ``` **What It Does:** Sets the profit target for closing hedge positions. **How It Works:** 1. Hedge placed at \$0.16800 2. TP target: 0.2% 3. TP price: $0.16800 * (1 - 0.002) = $0.16764 (for short hedge) 4. When price recovers to \$0.16764, hedge closes with profit **Recommendations:** | Target % | Use Case | | ---------------- | ----------------------------------- | | 0.1% (0.001) | Tight profit taking, high frequency | | **0.2% (0.002)** | **Default, balanced approach** | | 0.3% (0.003) | Allow more room for recovery | | 0.5% (0.005) | Wider targets, trending markets | **Configuration Examples:** **Tight (High Frequency):** ```json theme={null} { "vortex_autohedge_tp_target": 0.001 } ``` * Closes hedges quickly * More frequent hedge cycles * Good for choppy markets **Wide (Trending Markets):** ```json theme={null} { "vortex_autohedge_tp_target": 0.005 } ``` * Allows larger profits from trends * Fewer hedge cycles * Better for directional moves *** ### 6. Trailing Stop (Advanced) ```json theme={null} { "vortex_autohedge_trailing_stop_enabled": true, "vortex_autohedge_trailing_distance_pct": 0.002 } ``` **What It Does:** Once hedge reaches profit target, activates trailing stop to lock in profits. **How It Works:** ``` 1. Hedge placed: SELL 5,000 @ $0.16800 2. Initial TP: $0.16764 (0.2% profit) 3. Price drops to $0.16500 -> Profit: 1.8% 4. Trailing activates, tracks best price 5. Price retraces to $0.16534 -> Retrace: 0.2% <- CLOSE! 6. Hedge closes @ $0.16534 -> Profit: 1.6% ``` **Without Trailing:** ``` Hedge closes at $0.16764 -> Profit: 0.2% Missed extra 1.4% profit! ``` **Recommendations:** **Enable Trailing:** * ✅ Trending markets * ✅ High volatility * ✅ Want to maximize hedge profits **Disable Trailing:** * ❌ Choppy/ranging markets * ❌ Want quick hedge exits * ❌ Prefer simple TP management **Configuration:** ```json theme={null} { "vortex_autohedge_trailing_stop_enabled": true, "vortex_autohedge_trailing_distance_pct": 0.002 } ``` Trailing stop distance should typically match your TP target (both 0.2% is standard). *** ## 🎨 Complete Configuration Templates ### Template 1: Conservative (Low Risk) **Best For:** Beginners, small accounts, low leverage (5x-10x) ```json theme={null} { "vortex_dca": { "vortex_autohedge_enabled": true, "vortex_autohedge_ratio": 0.7, "vortex_autohedge_on_drawdown_pct": 0.03, "vortex_autohedge_on_liquidation_distance_pct": 0.15, "vortex_autohedge_tp_target": 0.002, "vortex_autohedge_trailing_stop_enabled": true, "vortex_autohedge_trailing_distance_pct": 0.002 }, "wallet_exposure": 0.2, "leverage": 10 } ``` **Characteristics:** * 70% hedge ratio (strong protection) * Triggers early (3% drawdown) * Wide liquidation buffer (15%) * Lower wallet exposure (20%) *** ### Template 2: Balanced (Medium Risk) **Best For:** Intermediate traders, medium accounts, medium leverage (10x-20x) ```json theme={null} { "vortex_dca": { "vortex_autohedge_enabled": true, "vortex_autohedge_ratio": 0.5, "vortex_autohedge_on_drawdown_pct": 0.04, "vortex_autohedge_on_liquidation_distance_pct": 0.10, "vortex_autohedge_tp_target": 0.002, "vortex_autohedge_trailing_stop_enabled": true, "vortex_autohedge_trailing_distance_pct": 0.002 }, "wallet_exposure": 0.5, "leverage": 20 } ``` **Characteristics:** * 50% hedge ratio (balanced) * Standard triggers (4% drawdown, 10% liq distance) * Moderate wallet exposure (50%) * **Recommended starting point for most users** *** ### Template 3: Aggressive (High Risk) **Best For:** Experienced traders, larger accounts, high leverage (20x-50x) ```json theme={null} { "vortex_dca": { "vortex_autohedge_enabled": true, "vortex_autohedge_ratio": 0.5, "vortex_autohedge_on_drawdown_pct": 0.06, "vortex_autohedge_on_liquidation_distance_pct": 0.08, "vortex_autohedge_tp_target": 0.003, "vortex_autohedge_trailing_stop_enabled": true, "vortex_autohedge_trailing_distance_pct": 0.003 }, "wallet_exposure": 0.8, "leverage": 30 } ``` **Characteristics:** * Allows deeper drawdowns (6%) * Tighter liquidation trigger (8%) * Higher wallet exposure (80%) * Wider TP targets (0.3%) *** ### Template 4: Godmode (Maximum Grid Uptime) **Best For:** Expert traders, high-frequency grids, ultra-aggressive ```json theme={null} { "vortex_dca": { "vortex_autohedge_enabled": true, "vortex_autohedge_ratio": 0.3, "vortex_autohedge_on_drawdown_pct": 0.08, "vortex_autohedge_on_liquidation_distance_pct": 0.05, "vortex_autohedge_tp_target": 0.002, "vortex_autohedge_trailing_stop_enabled": true, "vortex_autohedge_trailing_distance_pct": 0.002 }, "wallet_exposure": 1.0, "leverage": 50 } ``` **Characteristics:** * Low hedge ratio (30% - maintains exposure) * Very deep drawdown tolerance (8%) * Tight liquidation trigger (5%) * Maximum wallet exposure (100%) * **⚠️ Experts only!** Godmode configuration requires constant monitoring and significant trading experience. Start with conservative settings! *** ## 🔧 Fine-Tuning Tips ### Adjusting for Volatility **High Volatility Assets (DOGE, Meme Coins):** ```json theme={null} { "vortex_autohedge_on_drawdown_pct": 0.05, "vortex_autohedge_tp_target": 0.003 } ``` **Low Volatility Assets (BTC, ETH):** ```json theme={null} { "vortex_autohedge_on_drawdown_pct": 0.03, "vortex_autohedge_tp_target": 0.002 } ``` ### Adjusting for Account Size **Small Account (less than \$1,000):** ```json theme={null} { "vortex_autohedge_ratio": 0.7, "wallet_exposure": 0.15 } ``` **Large Account (greater than \$10,000):** ```json theme={null} { "vortex_autohedge_ratio": 0.5, "wallet_exposure": 0.6 } ``` ### Adjusting for Market Conditions **Trending Market:** ```json theme={null} { "vortex_autohedge_on_drawdown_pct": 0.05, "vortex_autohedge_trailing_stop_enabled": true } ``` **Choppy/Ranging Market:** ```json theme={null} { "vortex_autohedge_on_drawdown_pct": 0.03, "vortex_autohedge_trailing_stop_enabled": false } ``` *** ## 📊 Testing Your Configuration ### 1. Start Small ```json theme={null} { "symbols": ["DOGEUSDT"], "wallet_exposure": 0.1 } ``` ### 2. Monitor Logs Watch for hedge trigger messages: ``` 🛡️ AUTO-HEDGE TRIGGER: DRAWDOWN 🛡️ PLACING HEDGE: sell 5000.0000 @ $0.16118 ✅ HEDGE PLACED: Order #1234567890 ``` ### 3. Evaluate Performance After 24-48 hours: * Did hedges trigger appropriately? * Were there too many or too few hedges? * Did trailing stops work well? ### 4. Adjust Parameters Based on results: * Too many hedges -> Increase drawdown % * Too few hedges -> Decrease drawdown % * Missed profits -> Enable trailing stop * Early exits -> Increase TP target *** ## ⚠️ Common Mistakes ### ❌ Setting hedge ratio too high (greater than 0.8) **Problem:** Over-hedging reduces position exposure too much **Solution:** Use 0.5-0.7 for most cases ### ❌ Drawdown trigger too tight (less than 0.02) **Problem:** Excessive hedge cycles, high trading fees **Solution:** Use 0.03-0.05 based on volatility ### ❌ Liquidation trigger too wide (greater than 0.20) **Problem:** Hedge triggers too late, liquidation risk **Solution:** Use 0.08-0.15 based on leverage ### ❌ Disabling trailing stop in trending markets **Problem:** Misses extra profits from favorable moves **Solution:** Enable trailing for trending assets ### ❌ Using godmode settings without experience **Problem:** Excessive risk, potential liquidation **Solution:** Start conservative, gradually increase aggression *** ## 🔗 Related Documentation * **[Auto-Hedging Overview](/risk-management/auto-hedging-overview)** - Feature introduction * **[How It Works](/risk-management/auto-hedging-how-it-works)** - Technical deep-dive * **[Risk Management Best Practices](/risk-management/risk-management-best-practices)** - Safety guidelines * **[Bot Configuration Guide](/bot-configuration)** - Full bot setup *** ## 📞 Need Help? If you're unsure about your configuration: 1. **Start with the Balanced template** (Template 2) 2. **Test with small exposure** (10-20% wallet) 3. **Monitor for 24-48 hours** 4. **Adjust based on results** 5. **Join our Telegram** for community support: [t.me/pumpkinsui](https://t.me/pumpkinsui) **Happy auto-hedging! 🛡️** # How Auto-Hedging Works Source: https://docs.quantumvoid.org/risk-management/auto-hedging-how-it-works Technical deep-dive into the auto-hedge algorithm, trigger logic, and anti-cascade mechanisms # How Auto-Hedging Works: Technical Deep-Dive This page provides a comprehensive technical explanation of the auto-hedge system, including NET position monitoring, trigger logic, cascade prevention, and hedge management. *** ## 🧮 NET Position Monitoring ### Why NET Position? Vortex DCA runs **independent long and short grids simultaneously**. Auto-hedge monitors the **NET position** (long qty - short qty) to determine which side needs protection. ``` Long Position: 12,000 DOGE @ $0.16800 avg Short Position: 5,000 DOGE @ $0.17200 avg NET Position: 7,000 LONG (12,000 - 5,000) ``` ### Separate Long/Short Monitoring Auto-hedge monitors **each side independently**: **LONG Side:** ```python theme={null} long_qty = 12,000 short_qty = 5,000 net_qty = long_qty - short_qty = 7,000 LONG if net_qty > 0: # Net LONG position exists # Monitor LONG side for drawdown and liquidation drawdown_pct = (entry_price - current_price) / entry_price liq_distance_pct = (current_price - long_liq_price) / current_price ``` **SHORT Side:** ```python theme={null} long_qty = 5,000 short_qty = 12,000 net_qty = long_qty - short_qty = -7,000 SHORT if net_qty < 0: # Net SHORT position exists # Monitor SHORT side for drawdown and liquidation drawdown_pct = (current_price - entry_price) / entry_price liq_distance_pct = (short_liq_price - current_price) / current_price ``` This approach ensures hedges are only placed on the side that needs protection, avoiding unnecessary trades. *** ## 🎯 Trigger Conditions Auto-hedge triggers when **EITHER** condition is met: ### Condition A: Drawdown Threshold **Formula:** ``` LONG: drawdown = (entry_price - current_price) / entry_price SHORT: drawdown = (current_price - entry_price) / entry_price Trigger when: drawdown >= autohedge_on_drawdown_pct ``` **Example (LONG):** ``` Entry Price: $0.17000 Current Price: $0.16320 Drawdown: (0.17000 - 0.16320) / 0.17000 = 0.04 (4.0%) Config threshold: 0.04 (4%) Result: 4.0% >= 4.0% ✅ TRIGGER! ``` **Example (SHORT):** ``` Entry Price: $0.16500 Current Price: $0.17160 Drawdown: (0.17160 - 0.16500) / 0.16500 = 0.04 (4.0%) Config threshold: 0.04 (4%) Result: 4.0% >= 4.0% ✅ TRIGGER! ``` *** ### Condition B: Liquidation Distance **Formula:** ``` LONG: liq_distance = (current_price - liq_price) / current_price SHORT: liq_distance = (liq_price - current_price) / current_price Trigger when: liq_distance <= autohedge_on_liquidation_distance_pct ``` **Example (LONG):** ``` Current Price: $0.17200 Liquidation Price: $0.15500 Liq Distance: (0.17200 - 0.15500) / 0.17200 = 0.0988 (9.88%) Config threshold: 0.10 (10%) Result: 9.88% <= 10% ✅ TRIGGER! ``` **Example (SHORT):** ``` Current Price: $0.16500 Liquidation Price: $0.18400 Liq Distance: (0.18400 - 0.16500) / 0.16500 = 0.1151 (11.51%) Config threshold: 0.10 (10%) Result: 11.51% <= 10% ❌ No trigger ``` *** ### Critical Override **Special Case:** When liquidation distance drops below **3%**, hedge triggers **immediately** regardless of anti-cascade logic: ```python theme={null} is_critical = liq_distance_pct < 0.03 if is_critical: # Force hedge NOW - ignore anti-cascade checks place_hedge_immediately() ``` **Example:** ``` Liquidation Distance: 2.5% Anti-cascade: Last hedge was 10 seconds ago Result: 🔴 CRITICAL! Place hedge anyway (override anti-cascade) ``` Critical override ensures emergency protection when liquidation is imminent! *** ## 🛡️ Anti-Cascade Protection The implementation includes **comprehensive cascade prevention** to avoid repeated hedging of the same drawdown event. ### The Cascade Problem **Without Anti-Cascade:** ``` 10,000 LONG -> Trigger -> Hedge 5,000 SHORT 5,000 NET -> Trigger again -> Hedge 2,500 SHORT 2,500 NET -> Trigger again -> Hedge 1,250 SHORT ... Result: ❌ Cascades to 99%+ hedged! ``` **With Anti-Cascade:** ``` 10,000 LONG -> Trigger -> Hedge 5,000 SHORT 5,000 NET -> Check anti-cascade -> ⏸️ SKIP (already hedged) Result: ✅ Stays at 50% hedge ratio as configured ``` *** ### Safety Mechanism 1: Original Position Tracking The bot tracks the **original position size** when a hedge sequence starts: ```python theme={null} # First hedge trigger original_qty = 10,000 # Store original position hedge_qty = 10,000 * 0.5 = 5,000 # Second trigger (before position changes significantly) current_net_qty = 5,000 # After first hedge opposite_qty = 5,000 # Current hedge size # Calculate hedge ratio against ORIGINAL, not current hedge_ratio = opposite_qty / original_qty = 5,000 / 10,000 = 0.5 (50%) target_ratio = 0.5 (from config) if hedge_ratio >= target_ratio: # Already at target - SKIP return ``` **Key Point:** All hedge ratio calculations use the **original position size**, not the current NET position. *** ### Safety Mechanism 2: Hedge Ratio Enforcement Before placing a new hedge, the system checks if the target ratio is already achieved: ```python theme={null} def check_hedge_ratio(original_qty, opposite_qty, target_ratio): current_ratio = opposite_qty / original_qty tolerance = 0.05 # 5% tolerance if current_ratio >= target_ratio * (1 - tolerance): # Already hedged enough return "SKIP" else: # More hedging needed remaining = (original_qty * target_ratio) - opposite_qty return remaining ``` **Example:** ``` Original position: 10,000 LONG Target hedge ratio: 0.5 (50%) Current opposite: 4,800 SHORT Current ratio: 4,800 / 10,000 = 0.48 (48%) Target with tolerance: 0.5 * 0.95 = 0.475 (47.5%) Result: 48% >= 47.5% ✅ SKIP (close enough to target) ``` *** ### Safety Mechanism 3: Price/Quantity Movement Checks Won't re-hedge unless price moved **2%+** OR position changed **20%+** since last hedge: ```python theme={null} last_hedge = { 'price': 0.17000, 'qty': 10000, 'timestamp': } current_price = 0.17034 current_qty = 10000 # Calculate changes price_move_pct = abs(current_price - last_hedge['price']) / last_hedge['price'] # = abs(0.17034 - 0.17000) / 0.17000 = 0.002 (0.2%) qty_change_pct = abs(current_qty - last_hedge['qty']) / last_hedge['qty'] # = abs(10000 - 10000) / 10000 = 0.0 (0%) if price_move_pct < 0.02 and qty_change_pct < 0.20: # Not enough change - SKIP return ``` **Example Scenarios:** **Scenario 1: Price hasn't moved much** ``` Last hedge: $0.17000 Current: $0.17034 (0.2% move) Result: ⏸️ SKIP (< 2% threshold) ``` **Scenario 2: Price moved significantly** ``` Last hedge: $0.17000 Current: $0.16660 (2.0% move) Result: ✅ ALLOW new hedge ``` **Scenario 3: Position grew significantly** ``` Last hedge: 10,000 qty Current: 12,500 qty (25% increase) Result: ✅ ALLOW new hedge ``` *** ### Safety Mechanism 4: Original Quantity Reset The original quantity resets when position changes by **50%+**: ```python theme={null} if qty_change_pct >= 0.50: # Position changed significantly - start new hedge sequence original_qty = current_qty last_hedge_info = None ``` **Example:** ``` Original tracked: 10,000 LONG Grid fills more: 16,000 LONG (60% increase) Result: Reset original to 16,000, start fresh hedge sequence ``` *** ## 🎬 Complete Hedge Cycle Example Let's walk through a complete auto-hedge cycle: ### Initial State ``` Price: $0.17000 Long: 0 Short: 0 Grid: Active ``` ### Step 1: Grid Fills (Long Side) ``` Price drops to $0.16500 Long fills accumulate: - 2,000 @ $0.16900 - 3,000 @ $0.16700 - 5,000 @ $0.16500 Total: 10,000 LONG @ $0.16700 avg NET: 10,000 LONG ``` ### Step 2: Further Price Drop - Drawdown Trigger ``` Price: $0.16032 Drawdown: (0.16700 - 0.16032) / 0.16700 = 4.0% Config threshold: 4.0% Result: TRIGGER! 🛡️ Log: [DOGEUSDT] LONG 🛡️ AUTO-HEDGE TRIGGER: DRAWDOWN Position: 10000.0000 @ $0.16700 Current: $0.16032 | Drawdown: 4.00% ``` ### Step 3: Calculate Hedge Size ```python theme={null} original_qty = 10,000 target_ratio = 0.5 current_opposite_qty = 0 hedge_needed = original_qty * target_ratio - current_opposite_qty = 10,000 * 0.5 - 0 = 5,000 Log: [DOGEUSDT] LONG 🆕 Starting new hedge sequence - original qty: 10000.0000 [DOGEUSDT] LONG 📊 Hedge ratio: 0.0% (target: 50%) ``` ### Step 4: Place Hedge Order ```python theme={null} place_order( symbol='DOGEUSDT', side='sell', amount=5000, price=None, # MARKET order order_type='market', reduce_only=False ) Log: [DOGEUSDT] LONG 🛡️ PLACING HEDGE: sell 5000.0000 @ $0.16028 [DOGEUSDT] LONG ✅ HEDGE PLACED: Order #1234567890 ``` ### Step 5: Hedge Fills ``` Hedge execution: SELL 5,000 @ $0.16025 Position state: Long: 10,000 @ $0.16700 Short: 5,000 @ $0.16025 NET: 5,000 LONG ``` ### Step 6: Place Hedge Take Profit ```python theme={null} hedge_entry = 0.16025 tp_target = 0.002 # 0.2% tp_price = hedge_entry * (1 - tp_target) = 0.16025 * 0.998 = 0.15993 place_order( symbol='DOGEUSDT', side='buy', amount=5000, price=0.15993, order_type='limit', reduce_only=True, position_side='short' ) Log: [DOGEUSDT] SHORT HEDGE TP: Placing buy 5000.0000 @ $0.15993 [DOGEUSDT] SHORT HEDGE ✅ TP PLACED: Order #1234567891 ``` ### Step 7: Trailing Stop Activates ``` Price drops to $0.15800 -> Hedge profit: 1.4% Since 1.4% greater than 0.2% TP target: Trailing stop activates Best price tracked: $0.15800 Trailing distance: 0.2% Trigger price: $0.15800 * 1.002 = $0.15832 Log: [DOGEUSDT] SHORT 🎯 TRAILING ACTIVATED Best price: $0.15800 | Trail trigger: $0.15832 ``` ### Step 8: Trailing Stop Triggers ``` Price retraces to $0.15835 (0.22% from best) Cancel limit TP order Place market order to close hedge: place_order( symbol='DOGEUSDT', side='buy', amount=5000, price=None, order_type='market', reduce_only=True, position_side='short' ) Hedge closes @ $0.15835 Profit: ($0.16025 - $0.15835) * 5,000 = $95.00 Log: [DOGEUSDT] SHORT 🎯 TRAILING STOP HIT Entry: $0.16025 | Exit: $0.15835 | Profit: $95.00 ``` ### Step 9: Position After Hedge Close ``` Long: 10,000 @ $0.16700 Short: 0 NET: 10,000 LONG Grid: Still active on both sides Hedge sequence: Completed Original qty tracking: Reset (ready for next cycle) ``` ### Step 10: Grid Continues Operating ``` Price recovers to $0.17000 Long TPs start executing: - 5,000 @ $0.16867 (1% TP) - 3,000 @ $0.16867 - 2,000 @ $0.16867 Total grid profit: $267.00 Total hedge profit: $95.00 Combined profit: $362.00 ``` *** ## ⚙️ Order Types Used ### Hedge Placement: MARKET Order ```python theme={null} { "symbol": "DOGEUSDT", "side": "sell", # Opposite of NET position "order_type": "market", # <- Ensures immediate fill "amount": 5000, "price": None, "reduce_only": False, # Opens new position "position_side": "short" # Explicit side for hedge mode } ``` **Why MARKET:** * Guarantees immediate execution * Protects against further drawdown * No risk of order not filling *** ### Hedge Take Profit: LIMIT Order (Initial) ```python theme={null} { "symbol": "DOGEUSDT", "side": "buy", # Closes hedge "order_type": "limit", "amount": 5000, "price": 0.15993, # 0.2% profit target "reduce_only": True, # <- Only closes existing hedge "position_side": "short" } ``` **Why LIMIT:** * Sets specific profit target * Remains active until hit or replaced by trailing stop *** ### Trailing Stop: MARKET Order (When Triggered) ```python theme={null} { "symbol": "DOGEUSDT", "side": "buy", "order_type": "market", # <- Immediate close "amount": 5000, "price": None, "reduce_only": True, "position_side": "short" } ``` **Why MARKET:** * Locks in profit immediately * Prevents profit giveback from slippage *** ## 🔧 Exchange-Specific Implementation ### BloFin Parameter Conversion The strategy uses standardized parameters, but BloFin requires specific formatting: ```python theme={null} # Strategy calls: place_order( reduce_only=True, position_side='short' ) # BloFin exchange converts to: params = { 'reduceOnly': 'true', # <- String, not boolean! 'positionSide': 'short', 'leverage': '20' } exchange.create_order( symbol='DOGEUSDT', type='market', side='buy', amount=5000, price=None, params=params ) ``` **Key Differences:** * `reduce_only (bool)` -> `reduceOnly (string "true"/"false")` * Position side explicitly specified in params * Leverage set per order The exchange adapter handles all parameter conversions automatically - you don't need to worry about exchange-specific formatting! *** ## 📊 State Tracking Auto-hedge maintains several state variables: ```python theme={null} # Original position tracking (per symbol, per side) self.last_hedge_info = { 'DOGEUSDT_long': { 'original_qty': 10000, 'price': 0.17000, 'qty': 10000, 'timestamp': }, 'DOGEUSDT_short': None } # Hedge TP order IDs (for cancellation) self.hedge_tp_orders = { 'DOGEUSDT_short': '1234567891' } # Best prices for trailing (per symbol, per side) self.hedge_best_prices = { 'DOGEUSDT_short': 0.15800 } # Trailing activation status self.hedge_trailing_active = { 'DOGEUSDT_short': True } ``` *** ## 🔁 Main Loop Integration Auto-hedge runs in the main strategy loop: ```python theme={null} def run(self): while True: # ... (refresh grids, manage TPs, etc.) # AUTO-HEDGE OR LIQUIDATION SAFEGUARD if self.autohedge_enabled: # Check if hedge should trigger self._check_auto_hedge(symbol, positions, current_price) # Monitor hedge trailing stops self._monitor_hedge_trailing_stop(symbol, positions, current_price) else: # Traditional liquidation safeguard self._liquidation_safeguard_check(symbol, positions, current_price) # ... (continue grid operations) time.sleep(3) # Check every 3 seconds ``` **Timing:** * Hedge checks run every **3 seconds** (same as TP refresh) * Ensures quick response to drawdowns * Low overhead (simple calculations) *** ## 📈 Performance Characteristics ### Computational Overhead **Per Check (every 3 seconds):** * Calculate NET position: O(1) * Calculate drawdown: O(1) * Calculate liq distance: O(1) * Anti-cascade checks: O(1) **Total:** Minimal CPU impact (less than 0.01% per symbol) ### Memory Usage **Per Symbol:** * Hedge state: \~500 bytes * Tracking info: \~300 bytes **Total:** less than 1 KB per symbol (negligible) ### Network Calls **Normal Operation:** 0 API calls (monitoring only) **When Hedge Triggers:** * 1 call: Place hedge market order * 1 call: Place hedge TP limit order **When Trailing Triggers:** * 1 call: Cancel TP order * 1 call: Place market close order **Total:** 2-4 API calls per hedge cycle (infrequent) *** ## 🧪 Testing & Validation ### What to Monitor **In Logs:** ``` ✅ Hedge triggers at correct thresholds ✅ Anti-cascade logic prevents repeated hedges ✅ Hedge ratios match configuration ✅ Trailing stops activate and trigger correctly ✅ Orders execute without errors ``` **In Exchange:** ``` ✅ Hedge positions open on correct side ✅ Position sizes match expected amounts ✅ TP orders placed at correct prices ✅ Reduce-only flag working properly ``` ### Validation Checklist * [ ] Drawdown trigger tested at configured % * [ ] Liquidation distance trigger tested * [ ] Critical override tested (liq \< 3%) * [ ] Anti-cascade prevents repeated hedges * [ ] Hedge ratio enforcement working * [ ] Original qty tracking correct * [ ] Trailing stop activates at TP target * [ ] Trailing stop triggers on retrace * [ ] Market orders execute immediately * [ ] Positions balance correctly after hedge *** ## 🔗 Related Documentation * **[Auto-Hedging Overview](/risk-management/auto-hedging-overview)** - Feature introduction * **[Configuration Guide](/risk-management/auto-hedging-configuration)** - Parameter reference * **[Risk Management Best Practices](/risk-management/risk-management-best-practices)** - Safety guidelines *** **Now you understand exactly how auto-hedging works under the hood!** 🔧 # Auto-Hedging Overview Source: https://docs.quantumvoid.org/risk-management/auto-hedging-overview Intelligent position hedging that replaces liquidation safeguards with active risk management # Auto-Hedging: Godmode HFT Grid The **Auto-Hedge** feature transforms the Vortex DCA strategy into a "godmode" high-frequency trading grid by **replacing the liquidation safeguard with intelligent auto-hedging**. Instead of stopping grid placement when approaching liquidation, it automatically hedges positions to protect against liquidation while keeping the grid active. *** ## 🎯 What is Auto-Hedging? Auto-hedging is an advanced risk management system that: * **Monitors** your NET position continuously (long qty - short qty) * **Triggers** automatic hedge orders when drawdown or liquidation thresholds are hit * **Places** opposite-side market orders to protect your position * **Keeps** your grid trading active during volatile moves * **Recovers** with trailing profit targets on hedge positions Auto-hedging works on BloFin, Bybit, and other exchanges that support hedge mode (simultaneous long/short positions). *** ## 🔄 Traditional vs Auto-Hedge ### Traditional Liquidation Safeguard ``` Price drops -> Approaching liquidation -> STOP grid orders ❌ No new positions ❌ Exposure remains ❌ Manual intervention required ❌ Grid disabled until recovery ``` ### Auto-Hedge Approach ``` Price drops -> Approaching liquidation -> HEDGE position automatically ✅ Grid continues operating ✅ Risk neutralized ✅ Automatic recovery ✅ Profit from hedge closure ``` *** ## ⚡ Key Benefits ### 1. **Uninterrupted Grid Operation** Your grid keeps placing orders even during extreme volatility, maximizing profit potential. ### 2. **Active Risk Protection** Instead of passive monitoring, auto-hedge actively protects your position by opening opposite trades. ### 3. **Automatic Recovery** Hedge positions close automatically with small profits (0.2% default) as price recovers. ### 4. **Anti-Cascade Protection** Advanced safety mechanisms prevent repeated hedging of the same drawdown event. ### 5. **Trailing Stop Profit Lock** Hedge positions use trailing stops to lock in profits during favorable moves. *** ## 📊 How It Works (Simple Version) **Step 1: Monitor NET Position** ``` Long: 10,000 DOGE @ $0.17000 Short: 0 DOGE NET: 10,000 LONG ``` **Step 2: Trigger Detection** ``` Price drops to $0.16320 Drawdown: 4.0% <- TRIGGER! ``` **Step 3: Hedge Placement** ``` Place MARKET SELL 5,000 DOGE (50% hedge) Result: Long 10,000 | Short 5,000 | NET 5,000 LONG Grid continues placing orders! ``` **Step 4: Hedge Take Profit** ``` Hedge filled @ $0.16320 TP placed @ $0.16287 (0.2% profit) ``` **Step 5: Recovery** ``` Price recovers to $0.16287 Hedge closes with $16.50 profit Position returns to: Long 10,000 | Short 0 ``` *** ## 🎛️ Quick Configuration ### Minimum Required Settings ```json theme={null} { "vortex_dca": { "vortex_autohedge_enabled": true, "vortex_autohedge_ratio": 0.5, "vortex_autohedge_on_drawdown_pct": 0.04, "vortex_autohedge_on_liquidation_distance_pct": 0.10 } } ``` **What this does:** * Enables auto-hedge (replaces liquidation safeguard) * Hedges 50% of position when triggered * Triggers at 4% drawdown OR when liquidation is within 10% Start with these conservative defaults and adjust based on your risk tolerance! *** ## 🔥 Use Cases ### High-Frequency Grid Trading Perfect for aggressive HFT grids with high wallet exposure (greater than 50%) on volatile assets. ```json theme={null} { "wallet_exposure": 0.8, "vortex_autohedge_ratio": 0.5, "vortex_autohedge_on_drawdown_pct": 0.05 } ``` ### Volatile Market Protection Protect positions during high volatility while maintaining grid operation. ```json theme={null} { "vortex_autohedge_ratio": 0.7, "vortex_autohedge_on_drawdown_pct": 0.03, "vortex_autohedge_on_liquidation_distance_pct": 0.15 } ``` ### Maximum Grid Uptime (Godmode) Ultimate configuration for maximum grid operation with minimal downtime. ```json theme={null} { "wallet_exposure": 1.0, "vortex_autohedge_ratio": 0.5, "vortex_autohedge_on_drawdown_pct": 0.08, "vortex_autohedge_on_liquidation_distance_pct": 0.05 } ``` *** ## ⚠️ Important Notes ### Auto-Hedge Replaces Liquidation Safeguard When `vortex_autohedge_enabled: true`, the liquidation safeguard is **automatically disabled**. You're choosing active risk management over passive monitoring. Auto-hedging requires sufficient margin to place hedge orders. Ensure you have adequate balance! ### Exchange Requirements * **Hedge Mode**: Must be enabled on the exchange * **Cross Margin**: Recommended for better capital efficiency * **Leverage**: 5x-20x recommended for beginners, up to 50x for advanced users ### Not Suitable For * ❌ Spot trading (no short positions available) * ❌ Very low volatility assets (hedge triggers may be too frequent) * ❌ Extremely small accounts (less than \$500) *** ## 🚀 Getting Started ### 1. Enable Hedge Mode on Exchange **BloFin:** 1. Go to Trading Settings 2. Select "Hedge Mode" (allows simultaneous long/short) 3. Set margin mode to "Cross" **Bybit:** 1. Go to Derivatives -> USDT Perpetual 2. Position Mode -> Hedge Mode 3. Margin Mode -> Cross Margin ### 2. Configure Auto-Hedge Add to your bot configuration: ```json theme={null} { "exchange": "blofin", "strategy": "vortex_dca", "vortex_dca": { "vortex_autohedge_enabled": true, "vortex_autohedge_ratio": 0.5, "vortex_autohedge_on_drawdown_pct": 0.04, "vortex_autohedge_on_liquidation_distance_pct": 0.10, "vortex_autohedge_tp_target": 0.002, "vortex_autohedge_trailing_stop_enabled": true, "vortex_autohedge_trailing_distance_pct": 0.002 } } ``` ### 3. Start with Small Exposure Begin with 10-20% wallet exposure to test the system: ```json theme={null} { "wallet_exposure": 0.15, "symbols": ["DOGEUSDT"] } ``` ### 4. Monitor Logs Watch for auto-hedge trigger messages: ``` [DOGEUSDT] LONG 🛡️ AUTO-HEDGE TRIGGER: DRAWDOWN Position: 12000.0000 @ $0.16800 Current: $0.16128 | Drawdown: 4.00% [DOGEUSDT] LONG 🛡️ PLACING HEDGE: sell 6000.0000 @ $0.16118 [DOGEUSDT] LONG ✅ HEDGE PLACED: Order #1234567890 ``` *** ## 📈 Performance Expectations ### Typical Results **Without Auto-Hedge:** * Grid stops during volatile moves * Requires manual monitoring * Potential liquidation risk * Limited profit during recovery **With Auto-Hedge:** * Grid operates 24/7 during volatility * Automatic risk management * Protected from liquidation * Extra profit from hedge closures ### Example Session **Scenario:** DOGE volatile move from $0.17000 -> $0.16000 -> \$0.17500 ``` Grid fills: $450 profit Hedge closures: $85 profit Total: $535 profit Without auto-hedge: Grid profit: $180 (stopped early) Manual stress: High ``` *** ## 🔗 Learn More * **[Configuration Guide](/risk-management/auto-hedging-configuration)** - Detailed parameter reference * **[How It Works](/risk-management/auto-hedging-how-it-works)** - Technical deep-dive * **[Best Practices](/risk-management/risk-management-best-practices)** - Risk management strategies * **[Bot Configuration](/bot-configuration)** - Full bot setup guide *** ## ❓ FAQ ### Does auto-hedge work on all exchanges? Auto-hedging works on exchanges that support **hedge mode** (simultaneous long/short positions). Currently supported: BloFin, Bybit. ### Will I get liquidated with auto-hedge enabled? Auto-hedging significantly reduces liquidation risk by automatically hedging your position. However, extreme price moves can still trigger liquidation if hedges can't be placed fast enough. ### How much margin do I need? Ensure you have at least **30% of your position size** available as margin for hedge orders. For aggressive setups, 50%+ is recommended. ### Can I use auto-hedge with virtual chunking? Yes! Auto-hedge and virtual chunking work together. Auto-hedge protects from liquidation, while chunking helps recover from underwater positions. ### What happens to hedge orders when bot stops? Hedge positions remain open on the exchange. You'll need to manually close them or restart the bot to resume management. *** **Ready to enable godmode trading? Start with conservative settings and gradually increase exposure!** 🚀 # GLFT Optimal Market Maker Source: https://docs.quantumvoid.org/strategies/glft-market-maker Academic optimal quoting strategy based on Gueant-Lehalle-Fernandez-Tapia equations # GLFT Optimal Market Maker ## What It Does **GLFT quotes both sides of the order book around fair value, earning the spread while keeping inventory in check.** Where the [Perp Market Maker](/strategies/perp-market-maker) uses hand-tuned rules, GLFT computes its bid and ask placement from the **Gueant–Lehalle–Fernandez–Tapia** model — a closed-form solution from academic market-making research. Quotes automatically widen when volatility rises and skew to shed inventory when a position builds up, with far fewer knobs to turn. In plain terms: the bot continuously asks "given how jumpy this market is, how often orders are arriving, and how much inventory I'm already holding, what is the mathematically best price to bid and ask right now?" — and re-answers that question twice per second. GLFT is in **ALPHA**. It is fully functional, but parameter defaults may evolve as production data accumulates. Start with a conservative preset and small sizes. *** ## How It Works ### The GLFT engine The engine derives optimal bid/ask offsets from mid-price using three live inputs: ``` ┌─────────┐ ┌───────────┐ ┌─────────┐ │ Gamma │ │ Sigma │ │ Kappa │ │ (risk │ │ (realized │ │ (order │ │aversion)│ │volatility)│ │ arrival)│ └────┬────┘ └─────┬─────┘ └────┬────┘ └─────────────────┼─────────────────┘ ▼ Optimal spread calculation │ ┌──────────────┴──────────────┐ BID: mid − δb ASK: mid + δa (both skewed by current inventory) ``` * **Gamma** (risk aversion, default 0.01) — how strongly the engine penalizes holding inventory. Higher gamma → wider spreads, smaller positions. * **Sigma** (realized volatility) — measured from recent prices. More volatility → wider optimal spreads. * **Kappa** (order arrival rate) — estimated from order-book liquidity and refined by the Cartea–Jaimungal trade-intensity estimator. Busier books → tighter spreads, because fills come faster. ### Inventory skew The model's key property: **quotes become asymmetric as inventory builds.** ``` NEUTRAL (q = 0): LONG inventory (q > 0): ASK: $100.08 ASK: $100.05 ← tighter (eager to sell) MID: $100.00 MID: $100.00 BID: $99.92 BID: $99.90 ← wider (reluctant to buy more) ``` The strategy works its own inventory back toward zero without manual rules. *** ## Key Features * **Regime detection** — ADX-based classification (ranging / trending / volatile) scales gamma: tighter quoting in ranges (0.7x), defensive against-trend quoting (1.5x), wider in volatile regimes (1.3x) * **Grid breathing** — spacing widens with drawdown (base 150 bps) and each side (long/short) breathes independently on its own P\&L, with smoothing so transitions don't whipsaw * **Mantis spread** — composite microstructure signal (book imbalance + aggressor trade flow + Cartea–Jaimungal arrival estimate) that shades the quotes * **Squeeze detection** — monitors funding extremes and open-interest shifts for squeeze conditions * **Inventory TP** — take-profit targets tighten exponentially as inventory grows: small positions wait for full profit, large ones exit faster * **Time decay** — TP targets decay on positions older than 15 minutes; maximum-hold times depend on regime (320 min ranging / 240 volatile / 120 trending) * **Dynamic sizing** — quote size scales between a base and max ($10→$15 conservative, $25→$50 BloFin aggressive) with conditions * **S/R snapping** — quotes snap up to 5 bps to nearby order-book walls (≥ \$500) so they rest behind real liquidity * **Multi-symbol** — one bot instance runs up to 5 symbols (multi presets ship with BTC, ETH, SOL, SUI, XRP), each with independent state and recovery *** ## Supported Exchanges * Requires API key, secret, and **passphrase** * Configured fees: maker 2 bps, taker 6 bps * WebSocket orders and data streams * Requires API key and secret only * **Auto fee detection** — fees read from your account, no manual config * WebSocket order management All current GLFT presets on both exchanges run **20x leverage**. *** ## Available Presets GLFT ships with 8 presets — conservative and aggressive, single- and multi-symbol, on both exchanges. In the Marketplace they appear as 4 cards with a Bybit/BloFin toggle. All values below are read from the actual preset configs. | Preset | Min Profit | Quote Size | Max Position | Drawdown Stop | Leverage | | ---------------------- | ---------- | ---------- | -------------- | ------------- | -------- | | **Conservative** | 16 bps | $10 (→$15) | \$500 | \$100 | 20x | | **Aggressive** | 12 bps | $25 (→$50) | \$2,000 | \$500 | 20x | | **Multi Conservative** | 16 bps | $10 (→$15) | \$500/symbol | \$100 | 20x | | **Multi Aggressive** | 12 bps | $10 (→$20) | \$1,000/symbol | \$500 | 20x | | Preset | Min Profit | Quote Size | Max Position | Drawdown Stop | Leverage | | ---------------------- | ---------- | ---------- | -------------- | ------------- | -------- | | **Conservative** | 14 bps | $10 (→$20) | \$500 | \$200 | 20x | | **Aggressive** | 14 bps | $10 (→$20) | \$1,000 | \$200 | 20x | | **Multi Conservative** | 14 bps | $10 (→$20) | \$500/symbol | \$200 | 20x | | **Multi Aggressive** | 14 bps | $10 (→$20) | \$1,000/symbol | \$200 | 20x | Single-symbol presets default to BTCUSDT; multi presets run BTC, ETH, SOL, SUI, XRP. After the drawdown stop fires, the symbol pauses for 300 seconds before resuming. GLFT presets appear in the Marketplace under the **GLFT MM** family filter, tagged ALPHA. See the [Preset Selection Guide](/strategies/preset-guide). *** ## Key Parameters | Parameter | Description | Conservative | Aggressive | | ----------------------------------- | --------------------------------------- | ------------ | ------------- | | `min_profit_bps` | Minimum profit target per round trip | 14–16 | 12–14 | | `quote_size_usdt` | Base quote size per order | \$10 | $10–$25 | | `max_position_usdt` | Maximum position per symbol | \$500 | $1,000–$2,000 | | `leverage` | Leverage multiplier | 20x | 20x | | `glft_gamma` | Risk aversion (higher = wider, smaller) | 0.01 | 0.01 | | `grid.levels` | Quote levels per side | 2 | 2 | | `risk_management.max_drawdown_usdt` | Hard stop per symbol | $100–$200 | $200–$500 | | `loop_interval_seconds` | Quote refresh interval | 0.5s | 0.5s | ### Grid configuration Quote levels per side. Level 1 sits at the GLFT-optimal price, Level 2 a further offset out. Offset per level from the GLFT-optimal price: Level 1 at the optimum, Level 2 20 bps wider. Size split per level: 60% at Level 1, 40% at Level 2. Scale grid behavior by detected regime (ranging / trending / volatile). Inventory-based quote skewing — quotes less on the side that would grow inventory, blocks adds entirely past 75% of the position cap. Long and short sides widen independently based on their own drawdown and age. *** ## Recovery Grid When a position goes underwater, normal quoting on the losing side is suppressed and a recovery system takes over. Underwater position detected; grid adds on the losing side stop (`suppress_grid_adds: true`). `orderbook_dca` mode scans for the **strongest** support (longs) or resistance (shorts) walls within a recovery range computed from the last 8 hours of 15-minute price action. Up to 2 recovery orders are placed at those walls — at least 1% from the last fill, at least 1% apart, and at least 3% from the current price. Recovery order size scales with drawdown depth: +50% of the position at 5% unrealized loss, +100% at 10%, +150% at 20%. Safety rails: DCA pauses during sharp price spikes (15m candle check), orders are only reposted when price moves more than 0.1%, and the recovery range re-anchors if the entry drifts more than 10%. The recovery grid is **not** a loss guarantee. In a strong trend it adds to a losing position; the `max_drawdown_usdt` hard stop is the final safety net. *** ## Risk Warning **Market making involves significant risk.** GLFT-specific risks: * **Inventory risk** — despite optimal skewing, strong trends can build a full-size position before the stop fires * **Recovery risk** — the scaled recovery sizing adds to losers; in severe moves this deepens the final loss at the stop * **Leverage** — at 20x, a 5% adverse move equals 100% of position margin * **Liquidity** — on thin tokens the optimal spread may not cover adverse selection * **Alpha status** — defaults may change between updates Only trade funds you can afford to lose. Start conservative and monitor closely. *** ## GLFT vs Perp Market Maker | Aspect | GLFT | Perp MM (XGrid family) | | ------------------------ | --------------------------------- | ------------------------------------ | | **Quoting method** | Closed-form academic equations | Heuristic rules | | **Parameters** | \~20 key settings | 100+ | | **Spread derivation** | Automatic from volatility/flow | Manual `base_spread_bps` + modifiers | | **Inventory management** | Built-in penalty function | Configurable skew factor | | **Recovery system** | Order-book DCA with scaled sizing | XGrid counter-scalp + loss tiers | | **Leverage (presets)** | 20x | 75x | | **Best for** | Fewer knobs, model-driven quoting | Full customization | *** ## Next Steps Deploy GLFT through managed vaults All presets across strategies and exchanges The heuristic-rules alternative Deploy, monitor, and manage bots # Strategy Overview Source: https://docs.quantumvoid.org/strategies/overview The nine VOIDX strategy families explained in plain English, including TBLTBS, Vortex, market making, signal trading, and recovery systems # Trading Strategy Overview The current VOIDX Marketplace contains **nine strategy families**. Some average into price movement, some quote both sides of the book, and others wait for completed-candle or liquidation signals before opening a campaign. You deploy strategies from the **Marketplace** tab: open a preset to inspect its canonical configuration, then use the standard deploy wizard. Marketplace values are configuration facts, not performance projections. See the [Preset Selection Guide](/strategies/preset-guide) for selection and update behavior. ## The Nine Families ### TBLTBS **What it does:** Runs durable directional campaigns admitted by liquidation Cascade signals, volatility ranking, or a combination of both. Depending on the profile, it builds LINEAR or Peaks/Troughs DCA geometry, manages staged protective hedges, and exits through fixed, trailing, or partial-plus-trailing policies. TBLTBS is the most lifecycle-heavy family. Exact exchange order ownership, restart-safe journals, campaign handoff, no-growth caretaker recovery, capacity gating, Profit Danger, Profitable Recycle, and Professional Auto-Reduce are integrated into the strategy. Cascade admission, maker-first campaigns, structural DCA, protection, and safe switching ### Vortex DCA **What it does:** Buys dips on a widening grid and takes quick small profits. Wave-queue variants extend the grid with larger rescue orders when price keeps moving against the position. You're not trying to predict the next candle. Each fill changes average entry, and a recovery through the take-profit threshold closes the campaign. The trade-off is increasing exposure during sustained trends. Grids, take-profits, wave queue, and anchor-stable pricing ### XGrid / Perpetual Market Maker **What it does:** Quotes around current price with high-frequency grids, momentum-aware placement, tight take-profits, and layered inventory recovery. This is a highly configurable family with multilevel quoting, loss tiers, time-based exits, wall detection, and counter-scalp variants. Spreads, multilevel quoting, loss tiers, and counter-scalp ### GLFT Optimal Market Maker **What it does:** Computes bid and ask offsets from the Gueant–Lehalle–Fernandez–Tapia model. Quotes widen with volatility and skew to reduce accumulated inventory. GLFT has fewer discretionary knobs than XGrid, while retaining position ceilings, regime handling, and recovery controls. Optimal quoting, inventory skew, and recovery grids ### Orderbook Walls **What it does:** Uses observed bid/ask liquidity walls to select maker entries, take-profits, and recovery levels. Profiles vary by venue, risk tier, and V1/V2 lifecycle. Orderbook liquidity can disappear. A visible wall is evidence at one moment, not guaranteed support or resistance. ### EMA Singularity **What it does:** Waits for completed-candle EMA-extreme conditions and seeks reversion from statistically stretched prices. BloFin profiles range from Low through High risk. This is signal-driven rather than continuously quoting: no qualifying completed-candle condition means no new entry. ### RetShock **What it does:** Detects return shocks and manages bounded recovery through the current Bedrock lifecycle. Presets vary by risk and venue while retaining explicit notional controls. ### Hydra **What it does:** Watches a dynamic symbol universe and coordinates fresh admission, strongest-wall or Click-Clack recovery, fee-aware exits, and terminal collar handoff under one account-wide strategy. ### Geometric Long-Only DCA **What it does:** Builds a long-only ladder that accumulates as price falls and exits recovery rungs at fixed profit targets. Deeper orders grow geometrically. This is easy to understand but can become heavily exposed during a sustained downtrend. Current presets have no directional short campaign to offset that risk. ## Quick Comparison | Family | Primary behavior | Usually prefers | Main risk | | --------------- | --------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------ | | TBLTBS | Signal-admitted directional campaign with DCA and hedging | Liquid markets with valid signal and structure | Very high configured exposure, leverage, campaign complexity | | Vortex DCA | Average into movement and exit recovery | Choppy or mean-reverting markets | Exposure grows during sustained trends | | XGrid | High-frequency two-sided grid quoting | Liquid, active books | Leveraged inventory and execution churn | | GLFT MM | Model-derived two-sided quoting | Stable flow and measurable volatility | Inventory accumulation in trends | | Orderbook Walls | Liquidity-wall maker entries and recovery | Deep books with persistent liquidity | Walls can move or disappear | | EMA Singularity | Completed-candle extreme reversion | Markets that revert after extension | Trend continuation after an extreme | | RetShock | Shock admission with bounded recovery | Discrete volatility events | Follow-through after the initial shock | | Hydra | Dynamic-universe admission and coordinated recovery | Broad liquid symbol sets | Correlated account-wide exposure | | Long-Only DCA | Geometric buy-the-dip ladder | Assets you expect to recover | Unbounded holding time and deep drawdown | ## How to Choose * **New to bots:** begin with a lower-exposure Vortex or conservative market-making preset and one symbol. * **Want model-driven market making:** compare GLFT Conservative profiles. * **Want configurable high-frequency quoting:** study XGrid loss tiers and position limits first. * **Want signal-driven reversion:** compare EMA Singularity and RetShock. * **Want dynamic multi-symbol recovery:** review Hydra and its account-wide limits. * **Want directional liquidation campaigns:** read the [TBLTBS guide](/strategies/tbltbs). Do not begin with Tyler's Liquidation Hunter unless you understand that `wallet_exposure_ratio: 20` is an exceptionally aggressive leveraged-notional setting. * **Want a simple bullish ladder:** Long-Only DCA is conceptually simple but can hold large losing exposure for a long time. ## Risk Disclosure Every family can lose money. DCA converts price drawdown into position drawdown. Market makers accumulate inventory. Signal strategies can enter just before continuation. Protective hedges, stops, and recovery systems reduce specific failure modes but cannot remove liquidation, gap, fee, slippage, funding, exchange, API, or operational risk. * Trade only funds you can afford to lose. * Read the canonical preset values before deployment. * Understand exit and stop behavior before increasing exposure. * Use read/trade-only API keys with withdrawals disabled. * Monitor live bots and exchange positions. Compare presets, risk labels, and source updates Liquidation Hunter and durable campaign ownership Grids, wave queue, and anchor-stable pricing Model-derived market making # Perp Market Maker Strategy Source: https://docs.quantumvoid.org/strategies/perp-market-maker The XGrid family: high-frequency two-sided grid scalping with layered risk controls # Perp Market Maker Strategy ## What It Does **The Perp Market Maker is a high-frequency grid scalper that quotes both buy and sell orders around the current price, earns the spread between them, and follows momentum with tight take-profits.** In the **Marketplace tab** these presets appear under the **XGrid** family label. In plain terms: the bot keeps limit buy orders just below the market and limit sell orders just above it, on multiple levels. When price wiggles inside that band, both sides fill and the difference — minus fees — is profit. It repeats this many times per day. The hard part is not the spread capture; it's surviving the moments when price *doesn't* wiggle but trends, leaving you holding inventory at a loss. Most of this strategy's machinery exists to detect, limit, and exit those moments. ``` ASK $100.10 ← bot sells here │ spread ───┼─── your gross profit per round trip │ BID $100.00 ← bot buys here Good case: price oscillates → both sides fill repeatedly. Bad case: price trends down → bids fill, asks don't → you accumulate a losing long. The loss tiers / time decay / counter-scalp below handle this case. ``` This is the most configurable family (100+ parameters) and the current presets run **75x leverage**. Start from a Marketplace preset with small sizes; do not hand-roll a config until you can read this strategy's logs fluently. *** ## Core Concepts ### Equity-based sizing (`equity_pct`) Modern presets size the quoting grid as a **percentage of account equity** rather than a fixed dollar amount: ``` Account: $1,000, equity_pct: 5 → grid budget $50 per cycle Account grows to $1,200 → grid budget $60 per cycle ``` Positions scale with profits automatically — and shrink after losses. Current presets range from `equity_pct: 1.5` (MM Professional 2-Level on BloFin, the most conservative) to `10` (Minimalist Alpha on BloFin). Combined with leverage this compounds fast: 5% equity at 75x leverage means a fully-deployed grid can represent several times your account in notional. Understand the math before raising it. The [Scaling Agent](/features/scaling-agent) can adjust it for you (`/set equity_pct 5`). ### Multilevel quoting Instead of a single bid and ask, the bot quotes 2–6 levels per side (preset-dependent), sized and spaced so closer levels are filled first and deeper levels catch larger moves. Spacing is dynamic: presets widen quotes when volatility rises, when the order book thins, or as drawdown grows. ### Position limits Every preset carries a hard ceiling (`max_position_usdt`, $500–$2,800 in current presets) that quoting will not exceed regardless of equity sizing. *** ## Risk Systems ### Tiered loss management As an underwater position deepens, the bot steps through defensive tiers — widening spreads, cutting size, halting new entries, and finally force-closing. Tier thresholds are preset-specific. Two examples from current presets (values in basis points of loss): | | Tier 1 | Tier 2 | Tier 3 | Hard stop | | ---------------------- | ------ | ------ | ------ | ---------- | | **v7/v8 Counterscalp** | 100 | 500 | 800 | 1000 (10%) | | **HFT v6** | 100 | 300 | 600 | 1000 (10%) | The hard stop is an emergency market exit with no exceptions. ### Time decay Positions that age without reaching profit are progressively pushed toward the exit: take-profit targets shrink with age, then the bot accepts a small loss, then force-exits at market. Current preset values (v7 Counterscalp): accept a bounded loss exit after **8 hours**, breakeven push after **96 hours**, unconditional force exit after **48 hours**. The MM Professional presets allow up to 96 hours before force exit; HFT v6 forces out at 24 hours. `force_exit_enabled: false` disables the unconditional exit if you'd rather positions ride. An **attack-to-exit** module can also actively work a stuck position out: after 30 minutes stuck, it adds small mean-reversion entries (capped at 1.25x the position) specifically to lower the breakeven and exit faster. ### XGrid counter scalp When the main position is underwater and the [XGrid trend signal](/strategies/xgrid) confirms the move against you, the bot opens a counter-position (capped at 50% of the main) and scalps the adverse trend, offsetting part of the loss while the main position waits. Enabled in the v7/v8 Counterscalp and HFT v6 presets. ### Microstructure defenses * **Whale detection** — finds large resting orders ("walls") and places quotes near them, so your orders sit behind real support/resistance * **Trap detection** — exits fills whose immediate aftermath is toxic (price instantly moving against the fill) * **Cascade detection** — recognizes liquidation cascades and stands aside instead of quoting into them * **Reactive spacing** — widens quotes up to 10x when the order book thins or volatility spikes *** ## Current Marketplace Presets All values below are read from the actual preset configs. Bybit/BloFin variants of the same preset are merged into one Marketplace card with an exchange toggle. | Preset | Levels | Sizing | Max position | Leverage | Counter-scalp | Force exit | | --------------------------------------- | ------ | --------------------------------- | --------------- | -------- | ------------- | ---------- | | **MM Professional 2-Level** | 2 | 1.5% equity (BloFin) / 3% (Bybit) | $2,000 / $2,800 | 75x | off | 96h | | **MM Professional** (5-level) | 5 | 2% equity | \$2,000 | 75x | off | 96h | | **MM Minimalist Alpha** | 5 | 10% equity (BloFin) / 3% (Bybit) | $2,000 / $2,800 | 75x | Bybit only | 48h | | **v7 Long Short Counterscalp** | 4 | 5% equity | \$2,000 | 75x | on | 48h | | **v8 Long Short Counterscalp** (BloFin) | 4 | 5% equity | \$2,000 | 75x | on | 48h | | **HFT v6 Long Short MM** | 6 | fixed $7–$10 quotes | \$2,000 | 75x | on | 24h | | **ASTER Scalper MM** (BloFin) | 5 | fixed \~\$11 quotes | \$500 | 75x | — | 24h | Notes: * **MM Professional 2-Level** is the suggested starting point for this family: only 2 quote levels, the lowest equity percentage, and professional sizing with inventory skew. Single- and multi-symbol variants exist on both exchanges. * **v7 vs v8**: v8 raises take-profit targets to 9 bps (vs 6 bps on v7) for more profit per trade at the cost of fewer fills. * **v7 spread settings** (both exchanges): 15 bps base spread, 8 bps floor, 50 bps ceiling, with reactive spacing widening up to 10x. * **HFT v6** uses fixed quote sizes rather than equity scaling, with the tightest loss tiers and the fastest forced exit. *** ## Key Parameters Grid budget as a percentage of account equity. `0` falls back to legacy fixed sizing. Presets: 1.5–10. Quote levels per side. Presets: 2–6. Hard position ceiling in USDT. Presets: $500–$2,800. Leverage multiplier. All current presets: 75. Base half-spread from mid in basis points (code default 5; counterscalp presets use 15, the professional/scalper presets 5). Emergency exit threshold. All current presets: 1000 (10% of position). Unconditional market exit for aged positions. Presets: 24–96 hours. Gate with `force_exit_enabled`. Counter-trend scalping against a stuck main position. See the [XGrid guide](/strategies/xgrid). *** ## Risk Notes * **Leverage**: at 75x, a 1.33% adverse move equals 100% of position margin. The position ceiling and loss tiers bound this, but only if you don't override them. * **Trend risk**: market making profits in chop and bleeds in trends. The defensive stack reduces — not removes — trend losses. * **Counter-scalp risk**: counter positions lose money on sharp reversals while the main position recovers. The 50% cap bounds the damage. * **No performance promises**: spreads, tiers, and exits are configuration facts, not return estimates. *** ## Troubleshooting ### "Spread too tight, not quoting" The market spread is below `min_profitable_spread_bps` (presets require \~11 bps over round-trip fees). Either the symbol is too tight to make markets on profitably, or wait for higher volatility. ### "Position stuck at a loss" Check which loss tier you're in (the logs state it) — the bot may be intentionally in defend-only mode. Verify time decay is enabled; check whether counter-scalp is active and offsetting. ### "Orders keep getting cancelled and re-placed" Reactive spacing repositions quotes as conditions change — normal. If you hit exchange rate limits, reduce quote levels. *** ## Next Steps Choose between the XGrid-family presets The trend signal behind counter-scalp Adjust equity\_pct and other settings conversationally Sizing rules that keep you alive # Preset Selection Guide Source: https://docs.quantumvoid.org/strategies/preset-guide How to compare the current VOIDX Marketplace, understand canonical preset values, and safely switch or update a bot # Preset Selection Guide A VOIDX preset is a complete configuration used to create a saved bot. Browse presets in the **Marketplace** tab, inspect the technical details, and deploy through the standard wizard. Marketplace numbers come from the canonical configuration registry. They describe settings—not backtest results, expected returns, or guarantees. ## Current Catalog The current release contains **126 active underlying presets**, grouped into **80 Marketplace cards** across **9 strategy families**. Exchange variants that share a strategy and profile are grouped onto one card. | Family | Marketplace cards | Core behavior | | ----------------------- | ----------------: | ------------------------------------------------------------------------------------------ | | Vortex DCA | 26 | Widening DCA grids, take-profit cycles, and wave recovery | | TBLTBS | 19 | Liquidation/volatility admission, directional DCA, hedging, and durable campaign ownership | | XGrid / Perp MM | 10 | High-frequency multilevel quoting and inventory recovery | | Orderbook Walls | 6 | Liquidity-wall maker entry, TP, and recovery | | RetShock | 5 | Return-shock admission with bounded recovery | | EMA Singularity | 4 | Completed-candle EMA-extreme reversion | | GLFT MM | 4 | Model-derived two-sided quoting and inventory skew | | Hydra | 3 | Dynamic-universe admission and coordinated recovery | | Geometric Long-Only DCA | 3 | Long-only geometric accumulation and fixed-profit exits | The registry currently supports Marketplace variants on **BloFin, Bybit, Aster, TxFlow, and DEFX**. Not every family is available on every venue. ## Exchange Variants When the same profile exists on multiple exchanges, Marketplace combines it into one card with venue controls. Switching the venue changes the canonical configuration you will deploy, including exchange-specific execution, sizing, fee, and leverage behavior. A differently named policy remains a separate card even if it shares campaign identity with a related profile. For example, TBLTBS fixed, trailing, and partial-plus-trailing selections can share durable ownership while presenting separate exit choices. ## Latest Release Shelf The **Latest** shelf is curated explicitly; it is not generated from old `NEW` tags. Current highlights include: * Tyler's Liquidation Hunter * Cascade Maker Fixed TP * Cascade Maker Partial + Trailing TP * Peaks/Troughs Lambo Trailing TP * TBLTBS LINEAR * EMA Singularity Low * RetShock Safe * Hydra Low * Vortex Anchored V2 * Orderbook Walls V2 Low A Latest label means recently promoted in the product catalog. It does not mean safest or most profitable. ## Reading Risk and Configuration ### Risk pills **Conservative**, **Moderate**, and **Aggressive** are author classifications based on settings such as exposure, leverage, stop behavior, concurrency, and recovery geometry. They are not predictions. ### Exposure Exposure fields do not all use the same unit: * Percent-style Vortex settings are shown as wallet percentages. * Market makers often use fixed USDT position ceilings or equity percentages. * TBLTBS `wallet_exposure_ratio` is a raw notional-to-equity ratio. A value of `20` means up to 20 times wallet-equity planned notional for that side—not 20%. ### Leverage Leverage changes margin usage and liquidation distance; it does not by itself cap order notional. Always evaluate leverage together with wallet exposure, seat count, grid allocation, and existing account positions. ### Take-profit Displayed TP distances are normally **gross**. Fees, funding, spread, slippage, trigger gaps, and market execution can reduce net profit or produce a loss. ### Stops and recovery A strategy with hedging, DCA, auto-reduce, or a wave queue is not equivalent to one with a guaranteed stop. Open the full configuration and understand exactly what happens during a persistent adverse move. ## Tyler's Liquidation Hunter Tyler's Liquidation Hunter is an intentionally aggressive BloFin TBLTBS preset: * 6 directional seats * 20/20 long and short wallet-exposure ratios * 50x requested exchange leverage, with 20x minimum * raw Cascade admission from 3 same-side prints within 10 seconds and \$1,000 combined notional * durable six-minute priority candle preflight * one post-only maker starter before DCA * 6 long / 5 short structural levels * 50% fixed tranche at +0.22% gross * native market trailing for the remainder, with +0.35% ordinary activation and 0.10% distance It is marked **unvalidated live-executable opt-in** and has no replay-performance proof. Read the [TBLTBS guide](/strategies/tbltbs) before using it. ## Choosing a Starting Point * **New to automation:** start with a lower-exposure single-symbol profile and watch a complete entry-to-exit cycle. * **Want model-driven quoting:** compare GLFT Conservative variants. * **Want configurable high-frequency market making:** begin with a smaller XGrid profile and review hard position limits. * **Want signal-driven reversion:** compare EMA Singularity and RetShock risk tiers. * **Want broad dynamic admission:** review Hydra's account-wide limits. * **Want liquidation-driven campaigns:** compare Cascade profiles, but treat Liquidation Hunter as expert-only due to its exposure and leverage. * **Want DCA recovery:** compare Vortex exposure, wave hard cap, and stop policy—not only minimum TP. ## Deploying and Customizing Read the technical description and key parameters. Confirm venue, exposure unit, leverage, concurrency, exit mode, and stop behavior. Use read/trade-only API credentials. Disable withdrawals and use IP restrictions when supported. Changes made in the deploy wizard become your saved configuration. Reducing a value can alter order geometry or minimum-order viability; increasing it can materially increase liquidation risk. Confirm the bot reaches a healthy runtime state and compare dashboard state with authoritative exchange positions and orders. ## Switching Presets Stopping or switching a bot does not close exchange positions. Strategies that share an account must use the dashboard's controlled replacement flow. Never run two TBLTBS Union/Cascade owners concurrently on one account. Compatible TBLTBS profiles use durable handoff. Existing campaigns may be imported as no-growth caretakers until exact ownership, capacity, and exchange truth permit normal management. ## Updating a Saved Preset Saved configurations do **not** silently inherit future Marketplace revisions. When **Update from preset** appears: 1. Review the latest canonical policy. 2. Explicitly confirm replacement. 3. Understand that custom values are overwritten. 4. Restart the bot separately if you want a running process to load the saved change. Updating a saved configuration does not automatically restart a running bot. ## Risk Reminder No preset is set-and-forget. Configuration labels and descriptions cannot predict fills, slippage, funding, outages, trends, liquidation, or realized returns. Start smaller than your maximum tolerance, monitor the exchange directly, and trade only funds you can afford to lose. Compare all nine current families Cascade campaigns and Liquidation Hunter Browse and deploy canonical presets Monitor and control exact bot instances # TBLTBS and Liquidation Hunter Source: https://docs.quantumvoid.org/strategies/tbltbs How VOIDX TBLTBS profiles combine liquidation signals, structural grids, protective hedging, and restart-safe campaign ownership # TBLTBS and Liquidation Hunter TBLTBS is VOIDX's multi-symbol directional campaign engine. Depending on the preset, it can admit symbols from liquidation cascades, volatility ranking, or both; build a directional DCA campaign; protect adverse exposure with staged hedges; and manage exits through fixed or trailing take-profit policies. Unlike a continuously quoting market maker, TBLTBS opens a **campaign** only after the selected admission policy has passed. That campaign remains durably owned until exchange position and order truth prove it complete. TBLTBS presets are advanced, leveraged strategies. Several profiles deliberately use very large wallet-exposure ratios, including Tyler's Liquidation Hunter at `20` per side. A ratio of `20` means planned notional can be many times wallet equity; it does **not** mean 20%. Liquidation, gaps, fees, slippage, API failures, and exchange restrictions can cause substantial or total loss. ## Campaign Lifecycle A modern Cascade campaign follows this sequence: 1. **Detect** — the embedded Union engine receives liquidation events. 2. **Preflight** — the bot proves current candle structure, account capacity, symbol availability, leverage, balance, and a complete directional plan before consuming a seat. 3. **Maker starter** — one durable post-only starter order is submitted and safely repriced. 4. **Authoritative fill** — no DCA is exposed until the starter fill is confirmed from exchange truth. 5. **Structural DCA** — remaining Peaks/Troughs levels are rebuilt from the authoritative average entry. 6. **Protect and exit** — take-profit, trailing, hedge, recycle, and auto-reduce lifecycles manage the campaign. 7. **Complete** — the seat is released only after the position is flat and exact-owned growth orders are terminally canceled. Unknown submission, cancellation, trigger, or fill truth fails closed. The bot waits rather than guessing. ## Tyler's Liquidation Hunter **Tyler's Liquidation Hunter (BloFin)** is an aggressive, live-executable opt-in profile built on the production-hardened raw Cascade maker lifecycle. | Setting | Policy | | ---------------------------- | ---------------------------------------------------------------------- | | Exchange | BloFin perpetuals | | Direction | Long and short | | Seats | **6 directional symbols** | | Requested leverage | 50x, with 20x minimum | | Wallet-exposure ratio | **20 long / 20 short** | | Cascade threshold | 3 same-side prints within 10 seconds | | Minimum combined notional | \$1,000 | | Candle preflight | Durable, bounded at 6 minutes | | Starter | One post-only maker order, repriced every 1 second at a 1 bp threshold | | DCA | 6 long / 5 short Peaks/Troughs levels | | Exit | 50% fixed tranche, then native stop-market trailing | | Fixed tranche target | +0.22% gross | | Ordinary trailing activation | +0.35% gross | | Trailing distance | 0.10% | ### Signal and candle preflight Three same-side liquidation prints for one symbol inside ten seconds, totaling at least \$1,000, create a raw Cascade ignition. Opposite-side prints do not reset the same-side sequence. A fresh ignition receives exact priority candle warming outside the speculative shortlist. Before any seat is mutated, the bot requires complete current structure for: * `12M` over `15m` candles for the directional campaign * `24M` over `4h` candles for the outer structural boundary Pending intent is durable and cannot remain valid for more than six minutes. Repeated same-direction events do not extend that immutable deadline, and an opposite-direction event cannot flip unresolved intent. ### Maker-first entry The first order is a durably journaled post-only maker starter. Repricing does not reset the campaign's overall timer. Cancellation must be authoritative before replacement, and an unresolved submission or fill keeps the seat pinned. The bot exposes **no DCA growth** until the starter position fill is authoritative. It then rebuilds structural levels from the confirmed average entry. ### Structural geometry * Long campaigns use 6 clusters with ratio power `0.70`. * Short campaigns use 5 clusters with ratio power `0.65`. * Outer structure uses 3 Peaks/Troughs clusters over the completed 4-hour horizon. * Smaller replacement DCA levels may be added when required by the structural planner. The long and short layouts are intentionally asymmetric. Do not assume the six-seat count means six levels per symbol; seats are concurrent directional campaigns, while levels belong to each campaign's DCA plan. ### Partial plus trailing exit Each open side first places a reduce-only fixed tranche for 50% of authoritative quantity at +0.22% gross. Once that partial fill is confirmed, the remainder enters native BloFin stop-market trailing immediately. If no partial fill occurs first, ordinary trailing activation is +0.35% gross. The trail follows at 0.10% and preserves the configured +0.22% gross floor. Gross targets are before fees, funding, spread, slippage, and market gaps. Realized net profit can be lower and may be negative. ## Protection and Recovery The profile retains the production TBLTBS protection stack: * staged protective hedging * maker hedge scalping * Profitable Recycle * Profit Danger exits * completed-candle coreward trend release * equal-loss hedge/base wind-down * portfolio Professional Auto-Reduce using proven income * position-tier and capacity gating Protection does not make the strategy low risk. It adds controlled recovery paths while preserving exact order ownership and restart safety. ## Safe Profile Switching Liquidation Hunter deliberately shares the Cascade campaign identity: * variant: `peaks_troughs_cascade_maker_trailing_partial_tp` * state namespace: `peaks_troughs_cascade_maker_trailing_partial_tp` * ownership prefix: `BLC_` * shared account owner lock with other TBLTBS Union profiles That shared identity enables controlled replacement while preventing two owners from trading the same account concurrently. Treat every TBLTBS selection as **replacement-only** on a dedicated account. Stop or switch through the dashboard; never launch two Union/Cascade owners side by side. Switching presets does not close positions. Existing campaigns are imported only when durable provenance and authoritative exchange truth agree. An inherited campaign may enter **caretaker mode**. Caretaker means the bot continues exit and protection management but blocks new growth until ownership, capacity, and campaign proof permit promotion. It is not an abandoned position. ## Preset Updates Saved bot configurations do not silently inherit later Marketplace changes. When VOIDX shows **Update from preset**, review and explicitly confirm it: updating replaces custom values with the current canonical preset. A running bot is not automatically restarted by a saved-config update. ## Validation Status Tyler's Liquidation Hunter is marked **unvalidated live-executable opt-in** and has no replay-performance proof. Its Marketplace descriptions document configuration and lifecycle behavior, not expected returns. Compare Marketplace presets and understand risk labels Start, stop, switch, and monitor exact bot instances # Vortex DCA Strategy Source: https://docs.quantumvoid.org/strategies/vortex-dca Complete guide to the Vortex Dollar-Cost Averaging strategy: grids, take-profits, wave queue, and anchor-stable pricing # Vortex DCA Strategy ## What It Does **Vortex DCA buys dips on a widening grid and takes quick small profits — typically around 0.2% per cycle. If price keeps falling past the grid, a wave queue extends it with fresh, larger orders to rescue the position.** In plain terms: instead of guessing where price will go, the bot places a ladder of buy orders below the current price. Small dips fill the closest orders; bigger dips fill bigger orders deeper down, pulling your average entry lower each time. As soon as price recovers a small distance above that average, the entire position exits at a profit and the cycle restarts. Most current presets run the same logic on the short side at the same time (selling rips, buying back lower). ``` Price now: $100 ← TP: whole position exits ~0.2% above avg entry $99.3 ── buy (small) $98.4 ── buy (bigger) $97.3 ── buy (bigger still) $95.8 ── buy (biggest) ← deepest order ≈ outer_distance below price Each fill lowers your average entry → a smaller bounce is enough to exit green. ``` The flip side: a market that keeps falling keeps filling your buy orders. Vortex DCA converts price drawdowns into position drawdowns by design. The wave queue, drawdown stop, and hedging features below exist to manage that risk — not eliminate it. *** ## The Core Cycle The bot opens a small initial position (current presets use a **staged entry** that waits for an order-book wall or a wick into the entry band rather than market-buying immediately). A ladder of `nr_clusters` buy orders (4 in most presets) is placed between the current price and `outer_distance` below it (about 3–5% in presets, adjusted live by volatility). Dips fill grid levels. Order **value grows geometrically with depth** — with preset settings each deeper level is roughly 2x the previous — so deep fills move your average entry meaningfully. A post-only reduce-only limit order sits at `average entry × (1 + minimum_tp)`. It is refreshed every 60 seconds, and if price has already moved past the target the TP "chases" at the current price so the exit isn't left behind. After the TP fills, the position is flat and a fresh grid is built around the new price. *** ## Grid Mechanics ### Geometric sizing Order quantities follow a geometric progression controlled by `ratio_power`. Presets use `ratio_power: 0.75`, which makes each deeper level worth about **2.2x the previous one** in dollar terms. Small frequent dips cost you little; rare deep dips deploy the most capital where it improves your average entry the most. ### Volatility-aware spacing (dynamic spacing) The grid span is not fixed. With `dynamic_spacing` enabled (it is in current presets), the bot measures recent volatility (1-minute price movement plus tick-level data) and widens or tightens `outer_distance` between configured bounds — presets use **1.5% in calm markets up to 6% in violent ones**. Reactive spacing additionally widens the grid when the order book thins out, spreads blow out, or book imbalance spikes. ### Gridspan-normalized sizing When volatility shrinks the grid span, order sizes shrink proportionally (`gridspan_normalized_sizing`). A grid compressed to 1.5% span deploys a fraction of the budget that a full 5% grid would, so a calm-market grid that fills completely doesn't create the same exposure as a full-width one. The risk ceiling (see hard cap below) stays pinned to the wallet-derived value regardless of volatility. ### Order-book aware levels In `grid_mode: "orderbook"` (used by current presets), grid prices snap to detected liquidity rather than purely mathematical spacing, placing levels where real support exists. *** ## The Wave Queue (Position Rescue) The wave queue is the system that keeps Vortex from getting stranded when price falls through the entire grid. The featured "Vortex Waves" presets are built around it. ### Soft cap vs. hard cap Two budget lines matter: * **Soft cap** — `wallet_balance × wallet_exposure`. This is the normal per-side budget; the initial grid (wave 0) deploys a share of it. * **Hard cap** — `soft cap × max_total_exposure_pct` (presets use **1.5**). This is the absolute risk ceiling across **all** waves. No wave activation, and no individual order, may push cumulative deployed cost past it. Example: $1,000 wallet, `wallet_exposure: 60`, `max_total_exposure_pct: 1.5` → soft cap $600, hard cap \$900. ### How waves progress When the active wave's grid is fully consumed (price fell through every level) and the position is still open, the bot **activates the next wave**: a fresh grid of `nr_clusters` levels anchored at the *then-current* price, sized from that wave's share of the budget and clipped to whatever room remains under the hard cap. The previous wave is marked exhausted. With `wave_share: [0.6, 0.4]` and two waves, wave 0 gets 60% of the budget and the rescue wave 40%. A wave activation is refused — and logged — when the hard cap is reached, the remaining budget is below `min_wave_notional_usd`, or `max_waves` is exhausted. The wave queue also **supersedes** the older `extend_grid_when_exhausted` and `deep_rescue_extension` paths; when it's enabled those are suppressed. ### auto\_max\_waves Instead of hand-picking `max_waves` and `wave_share`, presets enable `auto_max_waves`: at startup the bot reads your **live wallet balance** and computes the largest number of waves such that every wave still gets a meaningful budget (at least `min_wave_pct_of_budget` of the total, default 2% in presets) and at least 2 levels that survive the exchange's minimum order size. Shares follow a `geometric_back` distribution (factor 1.3): **later waves get progressively bigger budgets**, so the deepest rescue waves hit hardest — this is the "never stuck" design. ### Escape valves (why grids don't get stranded) Three independent mechanisms advance a stuck wave: 1. **Fill-driven progression** — the normal path: all levels fill, next wave activates. 2. **Force-advance gate** — if a wave is mostly consumed (more than \~50% of its quantity filled) but its last 1–2 levels have been left stranded more than \~2% from the live price by re-pricing, the wave is declared done and the next wave builds a fresh grid near the current price. 3. **Wave-anchor drift advance** (anchor-stable mode) — if price drifts more than `wave_anchor_drift_advance_pct` (4% in presets) in the adverse direction from the wave's anchor, the next wave activates at the current price to restore coverage. This replaces the force-advance gate when anchor-stable grids are on. *** ## Anchor-Stable Grids (Why Orders "Don't Run Away") Without anchoring, grid prices are re-derived from the *current* price on every refresh. In a slow bleed this makes buy orders drift down with the market — they chase price, never fill, and the position never averages down. Users see this as "my orders keep running away." With `anchor_stable_grid: true` (the "Vortex Waves Anchored" presets): * Each wave records its **activation anchor price**, and every level stores its fixed percentage offset from that anchor. On refresh, prices are recomputed from the *anchor*, not from wherever price happens to be — the grid stays put and lets price come to it. * The grid still **breathes with volatility**: if dynamic spacing has changed the span materially (beyond a ±3% tolerance), level offsets are scaled by the ratio of the current span to the span at activation. Small wiggles inside the tolerance change nothing. * **Per-order tolerance**: an existing order within 5 bps (`price_tolerance_bps`) of its target is left alone instead of being cancelled and re-placed. This eliminates most order churn — fewer cancels, less rate-limit pressure, no flickering grid. * The drift-advance valve above guarantees an anchored grid can never lock itself permanently far from the market. *** ## Take-Profit Behavior * TP target: `average_entry × (1 ± minimum_tp)` — presets use **0.0018–0.0024** (0.18–0.24%). * Placed as a **post-only, reduce-only limit** so it earns maker fees and can never increase the position. * Refreshed every **60 seconds** as the average entry changes with each fill. * If price has already moved past the target, the TP is re-placed at the current price ("chasing") so a fast move doesn't leave the exit behind. *** ## Risk & Safety Systems ### Max-drawdown stop `max_drawdown_usdt` (presets use \$150 per symbol) closes the position at market if unrealized loss exceeds the threshold, then pauses the symbol for `stop_cooldown_seconds` (300s) before re-entering. `0` disables it. ### Liquidation safeguard With `liquidation_safeguard` on, the bot reduces risk when price approaches the liquidation level (presets trigger at 5% distance). ### Entry filters Presets gate new entries through a candle-trend filter and a **spike block** (no fresh entries while a 5-minute candle exceeds \~1.2% range), so grids aren't opened into a knife. ### Auto-hedging (optional) When enabled, the bot opens an opposing position when the main position is in trouble. Current code defaults: Enable auto-hedging. Off in the wave-queue presets (the wave queue is the primary rescue path); on in the dedicated "Auto-Hedge" presets. Hedge size as a fraction of the main position. Trigger hedge when drawdown exceeds this fraction (4%). Also trigger when within this distance of liquidation. Hedge take-profit target (0.2%), with a trailing stop (0.2% trail distance) enabled by default. See [Auto-Hedging](/risk-management/auto-hedging-overview) for the full system. ### Virtual chunking (optional, legacy recovery) An older recovery system, still available and used by some DEFX presets: when a position is underwater past a threshold it is virtually split into chunks, large "attack" orders average it down, and each chunk exits at a small profit. Current code defaults: **3% threshold, 5 chunks, 0.1% profit target per chunk, 15x attack multiplier** (capped). The wave queue is the recommended rescue path for new deployments. *** ## Key Parameters Number of grid levels per side. All current presets use 4. Distance from current price to the deepest order, as a decimal (`0.042` = 4.2%). With dynamic spacing on, this is the baseline — the live value moves between `min_outer_distance` and `max_outer_distance` (1.5%–6% in presets). Controls how steeply order value grows with depth (geometric progression). Presets use `0.75` ≈ 2.2x value per level. Higher values concentrate more budget in the deepest orders. Per-symbol budget as a **percent of wallet balance** (`60` = 60%). Featured single-symbol presets use 60–70; multi-symbol presets use 30 per symbol. This is the soft cap; the wave-queue hard cap is `wallet_exposure × max_total_exposure_pct`. Take-profit distance from average entry as a decimal (`0.002` = 0.2%). Presets: 0.0018–0.0024. Seconds between grid recalculations. Presets use 90. With anchor-stable grids, refreshes mostly verify orders instead of moving them. Hard cap multiplier over the soft cap. Total deployed cost across all waves can never exceed `soft cap × this value`. Budget share per wave, e.g. `[0.6, 0.4]`. Overridden at boot when `auto_max_waves` is enabled. Pin wave grid prices to the wave's activation anchor instead of re-deriving from the current price every refresh. The "Anchored" presets enable this. Per-symbol USD stop loss. `0` = disabled; presets use 150. *** ## Recommended Presets | Preset | Span | Exposure | Min TP | Wave queue | Notes | | ------------------------------------------- | ---- | ---------- | --------- | ---------------------------------------- | -------------------------------------------- | | **Vortex Waves Never Stuck** | 4.2% | 70% | 0.18–0.2% | 2 waves, hard cap 1.5x, auto\_max\_waves | Featured; geometric-back rescue waves | | **Vortex Waves Anchored** | 5.2% | 60% | 0.18–0.2% | Same + anchor-stable grid | Minimal order churn; grids hold their ground | | **Vortex Waves Never Stuck (Multi-Symbol)** | 4.2% | 30%/symbol | 0.18–0.2% | Same as single | Spreads the budget across symbols | All three are available on both Bybit and BloFin via the exchange toggle on the Marketplace card. *** ## Troubleshooting ### "Bot not placing orders" 1. Staged entry may be waiting for an order-book wall or wick — check the logs for entry-filter messages 2. Spike block active (recent 5m candle range above threshold) 3. Insufficient free balance for the configured `wallet_exposure` ### "Orders sit far from price and never move" With anchor-stable presets this is intentional — the grid is anchored and waits for price to come to it. If price drifts more than 4% adversely from the wave anchor, the drift-advance valve activates a fresh wave near the current price automatically. ### "Position keeps growing without a TP fill" The market is trending against the grid. Check: how many waves are used (`wave-queue` log lines show `deployed/hard_cap`), whether `max_drawdown_usdt` is set, and whether you're comfortable with the hard-cap exposure. In a sustained trend the strategy will sit at its cap and wait — that is the designed behavior, and it can take a long time or end at the drawdown stop. *** ## Next Steps Pick the right preset in the Marketplace The optional hedging layer Sizing and survival rules Deploy, monitor, stop # XGrid Strategy Source: https://docs.quantumvoid.org/strategies/xgrid High-frequency momentum grid scalping and the XGrid trend signal engine # XGrid Strategy ## What It Does **XGrid is a high-frequency momentum grid scalper: it detects short-term trend direction with technical signals, places a tight grid of orders in that direction, and takes profits within seconds-to-minutes rather than hours.** **Naming, to avoid confusion:** in the **Marketplace tab**, the "XGrid" family label covers the high-frequency **Perp Market Maker** presets (MM Professional, v7/v8 Counterscalp, HFT v6, …) — the two-sided grid scalper documented in the [Perp Market Maker guide](/strategies/perp-market-maker). This page covers the **XGrid trend signal engine** that powers those presets' counter-scalp features, plus the standalone XGrid strategy. If you came here from a Marketplace card, start with the [Perp MM guide](/strategies/perp-market-maker) and come back here for the signal details. *** ## The XGrid Trend Signal The signal engine answers one question every 30 seconds: **is short-term momentum long, short, or unclear?** It returns `LONG`, `SHORT`, or neutral, and is consumed by the Perp MM's counter-scalp and entry logic. ### How a signal is built ``` 1-minute candles │ ▼ EMA 11 vs EMA 23 ──────────► EMA11 > EMA23 → bullish bias EMA11 < EMA23 → bearish bias │ roughly equal → no signal ▼ Donchian breakout check ────► price near the 15-candle high/low (within 0.30% tolerance) confirms direction │ ▼ NATR volatility filter ─────► volatility must exceed its own recent baseline (1.1x the 60-candle NATR) and an absolute floor — no signals in dead markets │ ▼ Peak/trough confirmation ───► recent swing structure must agree │ ▼ SIGNAL: LONG / SHORT (cached for 30 seconds) ``` ### Signal parameters (actual engine defaults) Candle timeframe the signal runs on. The engine is designed for 1-minute momentum. Donchian channel lookback (candles) for the breakout confirmation. How close to the channel boundary (in %) price must be to count as a breakout. Lookback for the Normalized ATR volatility baseline. Current volatility must exceed `natr_mult ×` its baseline for a signal to fire. Absolute NATR floor (%). Below this the market is too quiet to scalp regardless of relative volatility. Signals are cached for 30 seconds to limit API load; the engine re-evaluates when the cache expires. The EMA pair (11/23) is fixed in the engine — the fast EMA reacts to the last \~10 minutes, the slow one filters noise, and their cross defines the bias. *** ## Standalone XGrid Strategy The standalone XGrid strategy (selectable as `strategy: "xgrid"`) is a faster, tighter sibling of Vortex DCA: * **2-second take-profit refresh** (vs 60s for Vortex) — exits are managed near-continuously * **2-minute default grid refresh** (vs 3 minutes for Vortex) * **Exponential level spacing**: levels start at a configurable `first_level_distance` from price and spread out with a power curve toward `outer_distance`, packing more orders close to the action * **Startup cleanup**: cancels existing orders on boot so stale orders from a previous run can't interfere * Shares Vortex's virtual-chunking position recovery (3% threshold, 5 chunks, 0.1% per-chunk target by default) It uses the same core parameters as Vortex (`nr_clusters`, `outer_distance`, `wallet_exposure`, `minimum_tp`) with tighter values. Current Marketplace presets deploy the perp\_mm implementation instead, which layers full two-sided quoting and risk tiers on top of the same high-frequency idea. *** ## How the Signal Drives Perp MM ### XGrid Counter Scalp When the Perp MM's main position is underwater and the XGrid signal points the *other* way, the bot opens a counter-position to scalp the move against you: ``` Main position: LONG, underwater XGrid signal: SHORT (downtrend confirmed) │ ▼ Open SHORT counter-position (capped at max_counter_pct of main, default 50%) Quick take-profit on the counter → losses on the main position are partially offset while it waits to recover ``` Key behavioral guards: Enable counter-trend scalping. On in the v7/v8 Counterscalp and HFT v6 presets. Counter position cap as % of the main position. The signal must cycle through neutral before re-entry (prevents whipsaw churn on a noisy signal). The main position must be at least this old before counter-scalping starts. ### Godmode Scalp A stricter variant that only fires when multiple confirmations align: main position underwater past a threshold, XGrid confirming the opposite trend, and a whale wall present on the counter side. Fewer entries, higher conviction. *** ## When the Signal Works Well (and When It Doesn't) | Market | Signal quality | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | Quiet, low volatility | No signals by design — the NATR filter blocks them | | Steady directional moves | Good — EMA cross + Donchian breakout align | | High volatility with follow-through | Good — strong, early signals | | Violent chop / whipsaw | Weakest case — crosses flip; the signal-cycle guard and peak confirmation reduce but don't eliminate false entries | Prefer liquid symbols (majors, high-volume alts). On illiquid pairs, the 1-minute candles are too noisy for the breakout logic. Counter-scalping trades **against** your own underwater position. It can offset losses in a continued trend, but if the market V-reverses, the counter position loses while the main recovers. The caps above (`max_counter_pct`, signal-cycle requirement) bound that risk — they don't remove it. *** ## Troubleshooting ### "No signals generated" 1. Volatility below `min_natr_abs` or below `natr_mult ×` baseline — the market is too quiet, which is intended behavior 2. EMA11 ≈ EMA23 (no clear bias) — check the log's rejection reason 3. Signal cached — changes only propagate after the 30s cache expires ### "Too many false signals" Whipsaw conditions. The signal-cycle requirement (`require_signal_cycle`) is the main defense; verify it's enabled before tuning anything else. *** ## Next Steps The strategy these signals power (Marketplace "XGrid" family) Which counterscalp preset to pick # Troubleshooting Source: https://docs.quantumvoid.org/troubleshooting Solutions to common issues with VoidX # Troubleshooting Guide Solutions to common problems and how to diagnose issues. *** ## Quick Diagnostics Before diving into specific issues, check these basics: Dashboard → Your Bot → Status indicator * Green = Running * Red = Error * Yellow = Warning Settings → Exchanges → Test Connection Trading Console → View recent log entries Ensure funds are in Futures wallet, not Spot *** ## Connection Issues ### "API Key Invalid" or "Authentication Failed" **Causes:** * Incorrect API key or secret * Extra spaces in copied credentials * API key expired or deleted * Wrong account (main vs sub-account) **Solutions:** 1. Re-copy credentials from exchange (no extra spaces) 2. Verify key exists and is active on exchange 3. Check you're using the correct account 4. For WEEX: Verify passphrase is exactly correct (case-sensitive) 5. Create new API key if issues persist ### "Connection Timeout" or "Network Error" **Causes:** * Exchange API temporarily down * Internet connectivity issues * IP restriction on API key **Solutions:** 1. Check exchange status page 2. Wait a few minutes and retry 3. Verify IP whitelist includes your server 4. Try from a different network ### "Rate Limit Exceeded" **Causes:** * Too many API requests per second * Running too many bots simultaneously * Grid refresh too frequent **Solutions:** 1. Reduce number of active bots 2. Increase `grid_refresh_interval` (e.g., 120 → 180 seconds) 3. Reduce `geometric_max_levels` (fewer orders) 4. Stagger bot start times *** ## Bot Won't Start ### "Insufficient Balance" **Causes:** * Funds in Spot wallet instead of Futures * Existing positions using all margin * Wallet exposure exceeds available balance **Solutions:** 1. Transfer funds: Spot → Futures wallet 2. Check available balance (not total balance) 3. Reduce `wallet_exposure` setting 4. Close some existing positions ### "Symbol Not Found" **Causes:** * Typo in symbol name * Symbol not available on selected exchange * Symbol delisted or trading paused **Solutions:** 1. Verify exact symbol format (e.g., `BTCUSDT` not `BTC/USDT`) 2. Check symbol exists on your exchange 3. Try a different, known-good symbol ### "Position Mode Mismatch" **Causes:** * Exchange in Hedge Mode but bot expects One-Way * Vice versa **Solutions:** 1. Check exchange position mode setting 2. BloFin/Bybit: Can change in exchange settings 3. Match bot configuration to exchange mode *** ## Orders Not Placing ### "Order Size Too Small" **Causes:** * `quote_size_usdt` below exchange minimum * Calculated order size rounds to zero **Solutions:** 1. Increase `quote_size_usdt` (minimum \$5-10 for most exchanges) 2. Check exchange minimum order size for symbol 3. Increase `wallet_exposure` for larger orders ### "Orders Immediately Cancelled" **Causes:** * Grid refresh repositioning orders * Orders placed outside valid price range * Post-only orders crossing spread **Solutions:** 1. Increase `refresh_threshold` (less frequent updates) 2. Check `outer_distance` isn't too extreme 3. Verify spread is wide enough for maker orders ### "No Orders Placed" **Causes:** * Spread too tight for profitable trading * Loss management tier blocking new entries * Price outside `no_entry_above`/`no_entry_below` limits **Solutions:** 1. Check `min_profitable_spread_bps` vs actual spread 2. Check loss management state in logs 3. Verify price limits aren't blocking entry 4. Wait for better market conditions *** ## Position Issues ### "Position Keeps Growing Without TP" **Causes:** * Strong trend against your position * TP target too aggressive * Fees eating into profit **Solutions:** 1. Enable auto-hedging for protection 2. Lower `minimum_tp` target 3. Reduce `qty_multiplier` for slower averaging 4. Enable virtual chunking for recovery 5. Consider manual intervention in strong trends ### "Position Stuck Underwater" **Causes:** * Market moved strongly against position * Recovery mechanisms not enabled **Solutions:** 1. Enable `virtual_chunking_enabled` 2. Enable `vortex_autohedge_enabled` 3. Check loss management tier (may be in defend mode) 4. Wait for market to recover 5. Consider partial manual close to reduce exposure ### "Unexpected Liquidation" **Causes:** * Leverage too high * Wallet exposure too high * Auto-hedge didn't trigger in time * Flash crash / extreme volatility **Prevention:** 1. Use lower leverage (10-20x for beginners) 2. Keep wallet exposure under 30% 3. Enable liquidation safeguard 4. Set `emergency_liq_close_bps` to close before liq 5. Enable auto-hedging with early trigger *** ## Performance Issues ### "Profits Lower Than Expected" **Possible reasons:** * Fees higher than accounted for * Spread too tight * Market conditions unfavorable * Too conservative settings **Solutions:** 1. Verify fee settings match exchange rates 2. Increase `base_spread_bps` 3. Try different symbols with more volatility 4. Adjust to more aggressive preset (cautiously) 5. Review during favorable market conditions ### "High Number of Losses" **Possible reasons:** * Strategy mismatched with market conditions * Settings too aggressive * Trending market (bad for MM) **Solutions:** 1. Switch strategy (MM → DCA in trends) 2. Use more conservative preset 3. Reduce position sizes 4. Enable defensive features (loss tiers, auto-hedge) 5. Pause during unfavorable conditions *** ## Log Messages ### Common Log Messages Explained ``` "Spread too tight" → Market spread is below minimum profitable. Wait or reduce min_spread. "Position limit reached" → At max_position_usdt. Won't add more until position reduces. "Loss tier 2 active" → In defensive mode due to losses. Fewer new entries. "Grid refresh triggered" → Normal - price moved enough to reposition orders. "Fill detected" → Order was executed. Good - trading is happening! "TP placed" → Take-profit order placed for position. "Whale wall detected at X" → Large order found in orderbook. May place orders nearby. ``` *** ## Exchange-Specific Issues ### BloFin **"Password required"** * BloFin needs API password (created when making key) * Re-enter password exactly as created **"Broker ID error"** * Usually handled automatically * Contact support if persists ### Bybit **"Reduce only order rejected"** * Position mode mismatch * Check hedge mode setting **"Leverage error"** * Bybit has different max leverage per symbol * Reduce leverage and retry ### HTX **"Contract not found"** * Symbol format might be wrong * Use `BTCUSDT` not `BTC-USDT` ### WEEX **"Invalid passphrase"** * Passphrase is case-sensitive * Must be exactly as created * If forgotten, create new API key *** ## When to Contact Support Contact support if: * Issues persist after trying all solutions * You see unexpected behavior not listed here * You suspect a bug in the platform * Exchange connectivity issues last > 1 hour **Before contacting:** 1. Check this troubleshooting guide 2. Note exact error messages 3. Check logs for relevant entries 4. Try basic fixes (restart, reconnect) **Support channels:** * [Telegram Group](https://t.me/pumpkinsui) * [GitHub Issues](https://github.com/donewiththedollar) *** ## Preventive Measures Test with minimum capital until you understand behavior Start with conservative presets, adjust gradually Check positions at least once per day initially Use auto-hedge and loss management features