← Back to Documentation

Bot Configuration Guide

Exchange Overview

BRIX supports three exchanges. All have free testnets for risk-free testing.

ExchangeBest ForTestnetMin Deposit
HyperliquidLow fees, fast executionFree0 (wallet-based)
BinanceMost liquid marketsFreeAny amount
BybitUser friendly interfaceFree0

Testnet vs Mainnet

Always start with Testnet:

TESTNET

  • Fake money, real behavior
  • Free funds from exchange faucet
  • Identical to live trading
  • Zero risk — use to validate

MAINNET

  • Real money
  • Only enable after testing
  • Requires Pro or Elite plan

Binance Futures API Setup

Step 1 — Create Account

TESTNET (recommended first)

  1. Go to testnet.binancefutures.com
  2. Click “Login with GitHub”
  3. Authorize GitHub access
  4. You're automatically logged in — no KYC required

MAINNET (real money)

  1. Go to binance.com and register
  2. Verify your email
  3. Complete KYC identity verification
  4. Enable 2FA (Google Authenticator recommended)
  5. Make any deposit to Spot Wallet
  6. Enable Futures trading: Derivatives → Futures → Open Account

Step 2 — Create API Key

TESTNET API Key

  1. In testnet.binancefutures.com, click API Management
  2. Click “Create API”
  3. Name: “BRIX Bot Testnet”
  4. Copy API Key + Secret Key immediately (Secret shown only once!)
  5. Go to Assets → Get USDT (receive 10,000 USDT free)

MAINNET API Key

  1. Login to binance.com
  2. Profile icon → Account → API Management
  3. Click “Create API” → select “System-generated”
  4. Name: “BRIX Bot”
  5. Complete 2FA verification
  6. Enable IP restriction — add your server IP
  7. Enable permissions: Reading, Futures, Spot & Margin Trading
  8. NEVER enable Withdrawals
  9. Copy API Key + Secret Key (Secret shown only once)

Step 3 — Enter in BRIX

Dashboard → Bot Config → Binance tab

Network: Testnet OR Mainnet (must match your keys)

API Key: paste your API key

Secret Key: paste your secret key

Click: Test Connection

Should show: Connected — $X USDT

Hyperliquid API Setup

Hyperliquid uses wallet-based authentication. Your private key IS your API access — no separate API key creation needed.

Step 1 — Create Wallet

Option A — MetaMask (easiest):

  1. Install MetaMask browser extension
  2. Create new wallet
  3. Save seed phrase securely (offline, never digital)
  4. Copy your wallet address (0x...)

Step 2 — Testnet Setup

  1. Go to app.hyperliquid-testnet.xyz
  2. Connect your wallet (MetaMask)
  3. Get test funds: go to faucet.hyperliquid-testnet.xyz, paste your address, receive 1,000 USDT
  4. Export private key: MetaMask → Account → Export Private Key → enter password → copy key (0x...)

Step 3 — Mainnet Setup

  1. Go to app.hyperliquid.xyz
  2. Connect your wallet
  3. Deposit USDC/USDT from your wallet
  4. Export private key same as above

For bot trading, create a SEPARATE wallet dedicated to the bot. Never use your main wallet's private key.

Step 4 — Enter in BRIX

Dashboard → Bot Config → Hyperliquid tab

Network: Testnet OR Mainnet

Wallet Address: your 0x address

Private Key: your 0x private key

Click: Test Connection

Should show: Connected — $X USDT

Bybit API Setup

Step 1 — Create Account

TESTNET

  1. Go to testnet.bybit.com
  2. Register with email
  3. No KYC required
  4. Receive free test funds automatically

MAINNET

  1. Go to bybit.com and register
  2. Verify email + complete KYC
  3. Enable 2FA
  4. Enable Derivatives trading

Step 2 — Create API Key

  1. Profile → API Management
  2. Click “Create New Key”
  3. Key Type: System-Generated
  4. Name: “BRIX Bot”
  5. Permissions: Read + Trade (Unified Trading)
  6. Never enable Withdrawals
  7. For mainnet: add IP restriction
  8. Copy API Key + Secret Key

Step 3 — Enter in BRIX

Dashboard → Bot Config → Bybit tab

Network: Testnet OR Mainnet

API Key: paste your API key

API Secret: paste your secret key

Click: Test Connection

Should show: Connected — $X USDT

Security Best Practices

Your credentials are:

  • AES-256 encrypted before storage
  • Never stored in plain text
  • Never transmitted to third parties
  • Only used to execute your trades

Security warnings:

  • NEVER enable withdrawal permission on API keys
  • Always use IP restrictions on mainnet
  • Save secret key immediately — shown only once
  • Never share keys with anyone
  • BRIX staff will never ask for your keys

When to Switch to Mainnet

Stay on testnet until all of these are true:

7+ days of testing completed

Win rate above 55%

Profit factor above 1.3

Max drawdown below 5%

You understand every Discord alert

You've seen both SL and TP hit

When switching:

  1. Create NEW mainnet API keys (don't reuse testnet keys)
  2. Bot Config → Change to Mainnet
  3. Enter mainnet credentials
  4. Start with minimum capital ($100–$500)
  5. Scale up slowly after 30 days of live results

Never rush to mainnet. The testnet exists to protect you.

How BRIX Connects to Exchanges

BRIX uses two connection types (configured automatically):

REST API (for orders)

  • Request → Response model
  • Used for: Buy, Sell, Cancel, Balance
  • Reliable and straightforward

WebSocket (for live data)

  • Persistent real-time connection
  • Used for: Live prices, candle updates
  • Exchange pushes data instantly

You don't need to configure this — BRIX handles both automatically.

Troubleshooting Connection Issues

Invalid API Key

Double-check you copied the full key with no spaces. Make sure testnet keys are used with testnet, not mainnet.

Signature mismatch

Usually a time sync issue. Ensure your device time is correct and try again in 1 minute.

IP not whitelisted

On Binance/Bybit mainnet, add the BRIX server IP to your API key's IP restriction list.

Insufficient permissions

Enable Futures trading permission on your API key. On Binance, you may also need to activate Futures on your account first.

Balance 0 on Hyperliquid testnet

Use the faucet to get test funds: faucet.hyperliquid-testnet.xyz

Connection timeout

The exchange may be experiencing downtime. Check status.binance.com or status.bybit.com.

Risk Configuration

Base Risk Per Trade (0.1% – 3%)

The percentage of your account risked on each individual trade.

Conservative0.5%
Moderate (recommended)1.0%
Aggressive2.0%

Confluence Scaling

When multiple engines confirm a signal, position size automatically increases:

1 engine confirms1.0x base risk
2 engines confirm1.25x base risk
3 engines confirm1.5x base risk
4 engines confirm2.0x base risk (max)

Stop Loss & Take Profit

Default SL: 0.21% | Default TP: 0.42% = 2:1 R:R ratio

With 2:1 R:R, you can be profitable even with a 40% win rate.