Skip to main content

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.

​
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+USDTinyourBloFinUSDT−Mfutureswallet</Check><Check>Suiwalletwith500+ USDT in your BloFin USDT-M futures wallet</Check> <Check>Sui wallet with 100+ PUMPKIN tokens
API keys created (see BloFin Setup Guide if needed)

​
Step 1: Connect to Dashboard (2 min)

1

Visit Dashboard

Go to trade.quantumvoid.org
2

Connect Wallet

Click Connect Sui Wallet and sign the authentication message
3

Select BloFin Mode

Click BloFin Perps on the main screen

​
Step 2: Add BloFin Credentials (3 min)

If you haven’t added credentials yet:
1

Open Exchange Settings

Click the gear icon or go to Settings > Exchanges
2

Add BloFin

Click Add Exchange and select BloFin
3

Enter Credentials

  • API Key: Paste from BloFin
  • Secret Key: Paste from BloFin
  • Password: The passphrase you set when creating the key
4

Test & Save

Click Test Connection - should show green success. Then Save.

​
Step 3: Create Your Bot (5 min)

1

Go to Bot Management

Click Bot Management in the sidebar
2

Create New Bot

Click New Bot or Create Bot
3

Select Exchange

Choose BloFin from the dropdown
4

Enter Symbol

Type your trading pair. Recommended starters:
  • ASTER/USDT:USDT - Moderate volatility, good for learning
  • DOGE/USDT:USDT - High volume, tight spreads
5

Choose Preset

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:
SettingValueWhat It Means
equity_pct5%Uses 5% of your account per grid cycle
leverage75xHigh leverage for capital efficiency
quote_size$7Each order is $7
max_position$2000Won’t exceed $2000 per side
time_decay48h/48hExits stale positions automatically
xgrid_counterEnabledScalps 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)

1

Review Configuration

Check the settings look correct
2

Click Start

Hit the Start Bot button
3

Confirm

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…ChangeFrom → To
Reduce riskequity_pct5% → 3%
More aggressiveequity_pct5% → 8%
Wider spreadsbase_spread_bps15 → 25
Tighter spreadsbase_spread_bps15 → 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

Preset Guide

Compare all available presets

Perp MM Deep Dive

Full strategy documentation

Scaling Agent

AI assistant for live adjustments

Risk Management

Protect your capital