> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quantumvoid.org/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Frequently asked questions about VOIDX

# Frequently Asked Questions

Quick answers to common questions about VOIDX.

***

## Getting Started

<Accordion title="Can I look around without connecting a wallet?">
  **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.
</Accordion>

<Accordion title="Do I need PUMPKIN tokens to use VOIDX?">
  **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).
</Accordion>

<Accordion title="What are the Free and Pro tiers?">
  * **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.
</Accordion>

<Accordion title="How much capital do I need to start?">
  **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.
</Accordion>

<Accordion title="What exchanges are supported?">
  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.
</Accordion>

<Accordion title="Do I need coding skills?">
  **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
</Accordion>

***

## Funds & Custody

<Accordion title="Do you custody my funds?">
  **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
</Accordion>

<Accordion title="What API key permissions should I use?">
  **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.
</Accordion>

<Accordion title="How do bots actually run?">
  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
</Accordion>

***

## Marketplace & Bots

<Accordion title="What is the Bot Marketplace?">
  The **Marketplace** tab shows 41 preset bots across 4 strategy families:

  * **Vortex DCA** — dollar-cost-averaging grid strategy
  * **XGrid** — high-frequency grid / momentum scalping
  * **GLFT MM** — quantitative market making
  * **Long-Only DCA** — long-only geometric DCA

  Each card has a plain-English description, a risk label, and stat tiles read directly from the preset's real configuration — no invented performance numbers. Click a card for details, pick your exchange variant (Bybit, BloFin, or DEFX), and Deploy opens a prefilled wizard.
</Accordion>

<Accordion title="Which strategy should I use?">
  **Quick guide:**

  | Your Situation     | Recommended Strategy                       |
  | ------------------ | ------------------------------------------ |
  | Beginner           | A Conservative preset from the Marketplace |
  | Want to accumulate | Vortex DCA or Long-Only DCA                |
  | Range-bound market | GLFT MM                                    |
  | High volatility    | 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.
</Accordion>

<Accordion title="What returns can I expect?">
  **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
</Accordion>

<Accordion title="Can I run multiple bots?">
  **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.
</Accordion>

<Accordion title="How do I know if my bot is working?">
  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.
</Accordion>

<Accordion title="Can I test without real money?">
  **Yes.** When adding exchange credentials, toggle the **Testnet** flag to connect to your exchange's paper-trading environment instead of live markets.
</Accordion>

***

## Portfolio & Tracking

<Accordion title="How does the Portfolio tab work?">
  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.
</Accordion>

***

## Risk & Safety

<Accordion title="Can I lose money?">
  **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
</Accordion>

<Accordion title="What happens if my bot goes offline?">
  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
</Accordion>

<Accordion title="What is liquidation and how do I avoid it?">
  **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.
</Accordion>

***

## Technical Issues

<Accordion title="Bot won't start - what do I check?">
  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.
</Accordion>

<Accordion title="Why are my orders being cancelled?">
  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).
</Accordion>

<Accordion title="What are the system requirements?">
  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.
</Accordion>

***

## Account & Billing

<Accordion title="Is there a monthly fee?">
  **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
</Accordion>

<Accordion title="What is the on-chain DEX?">
  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).
</Accordion>

<Accordion title="How do I contact support?">
  **Community Support:**

  * [Telegram Group](https://t.me/pumpkinsui)

  **GitHub:**

  * [Issues & Feature Requests](https://github.com/donewiththedollar)

  Response time: Usually within 24 hours.
</Accordion>

***

## Advanced

<Accordion title="Can I create custom strategies?">
  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).
</Accordion>

<Accordion title="Is there an API?">
  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.
</Accordion>

<Accordion title="Can I run my own instance?">
  The platform is currently hosted - self-hosting is not supported.

  Benefits of hosted:

  * No server management
  * Automatic updates
  * 24/7 uptime
  * No technical setup
</Accordion>

***

## Still Have Questions?

<CardGroup cols={2}>
  <Card title="Telegram Community" icon="telegram" href="https://t.me/pumpkinsui">
    Get help from other users
  </Card>

  <Card title="Glossary" icon="book" href="/glossary">
    Learn trading terms
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/troubleshooting">
    Fix common issues
  </Card>

  <Card title="Documentation" icon="file-lines" href="/">
    Browse all docs
  </Card>
</CardGroup>
