Skip to content

Quick Start

This guide helps you get the QuantFin Bot up and running using the web interface at https://quantfin.dexalgo.org. Follow these steps to connect your wallet, set up the bot, and start trading.

Step 1: Connect Your Wallet

The bot requires a SUI wallet to interact with the Bluefin exchange. You need to connect your wallet to the frontend.

  1. Visit the Frontend: Open your browser and navigate to https://quantfin.dexalgo.org.
  2. Connect Wallet: In the top-right corner (or bottom of the sidebar on mobile), click the Connect Wallet button. This uses the @mysten/dapp-kit to connect your SUI wallet (e.g., Sui Wallet, Martian Wallet).
  3. You may need at least 1,700,000 PUMPKIN tokens to access the app, unless you're on the whitelist. The app will notify you if you don't have enough tokens.
  4. Authorize the Connection: Follow your wallet's prompts to authorize the connection. Once connected, your wallet address will be used as your user_id.

Note

Your wallet must have sufficient PUMPKIN tokens (1,700,000) or be whitelisted to proceed. If access is denied, check your token balance or contact support.

Step 2: Set Your Private Key

The bot needs your SUI private key to sign transactions on the Bluefin exchange. Your private key is protected with end-to-end encryption.

  1. Locate the Key Management Section: On the main dashboard, scroll to the SUI Key Management panel.
  2. Add Your Private Key:
  3. Click on the Private Key Required box (if no key is set) or Key Secured (to update an existing key).
  4. In the expanded panel, paste your SUI private key (starting with suiprivkey...) into the Private Key text field.
  5. Click the eye icon to toggle visibility if needed.
  6. Encrypt and Save:
  7. Click the Encrypt & Save Key button.
  8. The frontend will decode your key (from Bech32 format to hex), encrypt it end-to-end, and securely store it.
  9. You’ll see a confirmation message like "Key saved successfully," and the panel will update to Key Secured.

Warning

Your private key is end-to-end encrypted and never accessible to system administrators in plaintext. The platform cannot view or decrypt your private key. Keep your private key secure and never share it publicly. See Security for more details.

Step 3: Add a Trading Symbol

Choose a trading symbol (e.g., SUI-PERP) to configure the bot for trading on that market.

  1. Locate the Trading Symbols Section: On the dashboard, find the Trading Symbols panel.
  2. Add a New Symbol:
  3. Click the Add New Symbol tile (with a plus icon).
  4. In the dialog, select a symbol from the dropdown (e.g., SUI-PERP). Available symbols include SUI-PERP, DEEP-PERP, WAL-PERP, and more.
  5. Click Add Symbol.
  6. Apply the Symbol:
  7. The symbol will appear as a card in the Trading Symbols section.
  8. In the sidebar, under Trading Symbol, ensure the dropdown shows your selected symbol (e.g., SUI-PERP).
  9. Click the Apply button next to the dropdown to set the symbol. This calls the /set_symbol endpoint, configuring price decimals and minimum order quantities for the symbol.

Note

If the symbol card shows "No status data," applying the symbol will initialize it. You can also click the symbol card to select it as the active symbol for configuration.

Step 4: Apply a Preset Configuration

Presets provide predefined settings to quickly configure the bot. The frontend allows you to apply a preset like Moderate.

  1. Locate the Preset Configuration:
  2. In the sidebar, under Preset Configuration, find the preset dropdown.
  3. Alternatively, scroll to the Update Config panel on the dashboard and find the Preset Config dropdown at the bottom.
  4. Select a Preset:
  5. Choose a preset from the dropdown: Safu, Moderate, Aggressive, or YachtToday.
  6. For beginners, Moderate is recommended as it balances risk and activity.
  7. Apply the Preset:
  8. Click the Apply Preset button next to the dropdown.
  9. This calls the /set_preset endpoint, applying the preset's settings (e.g., grid levels, exposure limits, take-profit distance).
  10. You’ll see a confirmation message like "Preset applied successfully."

Tip

See Presets for details on each preset. For example, Safu is conservative, while YachtToday is highly aggressive.

Step 5: Start the Bot

Now that the symbol and preset are set, you can start the bot to begin trading.

  1. Start the Bot:
  2. In the sidebar, click the Start Bot button (with a play icon).
  3. Alternatively, in the Trading Symbols section, click the three-dot menu on your symbol’s card and select Start Bot.
  4. Confirm Start:
  5. The bot will start, calling the /start endpoint for your selected symbol.
  6. You’ll see a confirmation message like "Bot started."
  7. Check the Status:
  8. In the Bot Status panel, verify that the Running badge shows "Active."
  9. The bot is now placing grid orders and managing take-profit orders based on your configuration.

Step 6: Monitor the Bot

Keep an eye on the bot’s activity and status using the dashboard.

  1. Check Bot Status:
  2. In the Bot Status panel, monitor badges like Running, HF Mode, Dynamic Dist, and Graceful Stop.
  3. For example, if Dynamic Dist is "Enabled," the bot is using dynamic distribution for order sizing.
  4. View Logs:
  5. Scroll to the Console Logs panel to see real-time logs.
  6. Logs include INFO, WARNING, and ERROR messages about the bot’s activity (e.g., order placements, errors).
  7. Check the Auto-scroll box to keep the logs updated as new entries arrive.
  8. Refresh Data:
  9. The dashboard auto-refreshes every minute by default (adjustable in the top-right corner).
  10. To manually refresh, click the refresh icon in the top-right corner.
  11. The last refresh time is displayed next to the refresh icon.

Next Steps

  • Bot Configuration: Customize advanced settings in the Update Config panel, such as grid levels, take-profit distance, and dynamic distribution.
  • API Endpoints: Learn about the backend API endpoints called by the frontend (for advanced users).
  • Features: Explore the bot’s features like market making, chase entry, and dynamic distribution.
  • Troubleshooting: Resolve common issues, such as the bot not starting or unexpected behavior.
  • Strategy Simulator: In the sidebar, click Strategy Simulator to visualize your grid configuration and simulate trades.