trading_bot_v4/docs/markets/FARTCOIN-PERP.md

FARTCOIN-PERP Market Configuration

Market Details

• Market Index: 22
• Symbol: FARTCOIN-PERP
• Oracle: 2sZomfWMDuQLcFak3nuharXorHrZ3hK8iaML6ZGSHtso
• Min Order Size: 1 FARTCOIN
• Tick Size: $0.0001 (price precision)
• Initial Margin Ratio: 10% (max 10x leverage)
• Maintenance Margin Ratio: 5%

Configuration Mode

• Mode: PROFIT GENERATION 💰
• Position Sizing: Percentage-based (20% of portfolio default)
• Default Leverage: 10x
• Status: Disabled by default

Environment Variables

FARTCOIN_ENABLED=false          # Enable/disable FARTCOIN trading
FARTCOIN_POSITION_SIZE=20       # 20% of portfolio (not fixed USD)
FARTCOIN_LEVERAGE=10            # Max 10x leverage
FARTCOIN_USE_PERCENTAGE_SIZE=true  # Always true for FARTCOIN

Enabling FARTCOIN Trading

Via Settings UI (Recommended)

1. Navigate to Settings page: http://localhost:3001/settings
2. Scroll to "🎈 Fartcoin (FARTCOIN-PERP)" section
3. Toggle "Enable Fartcoin Trading" to ON
4. Adjust position size percentage (recommended: 10-20%)
5. Set leverage (recommended: 10x for max profit potential)
6. Click "Save Settings"

Via Environment Variables

1. Edit .env file
2. Set FARTCOIN_ENABLED=true
3. Adjust FARTCOIN_POSITION_SIZE (1-100%)
4. Adjust FARTCOIN_LEVERAGE (1-10x)
5. Restart container: docker restart trading-bot-v4

Via TradingView Alert

Ensure your TradingView alert includes FARTCOIN symbol:

{
  "symbol": "FARTCOINUSDT",  // or "FARTCOIN"
  "direction": "long",
  // ... other fields
}

The bot will automatically normalize FARTCOINUSDT to FARTCOIN-PERP.

Position Size Calculation

Percentage-based sizing formula:

Base Capital = Portfolio × Position Size %
Notional Position = Base Capital × Leverage

Example with $1000 portfolio:
- Position Size: 20% → Base = $200
- Leverage: 10x → Notional = $2000
- Risk Exposure: $200 (max loss is your base capital)

Risk/Reward Example:

• Portfolio: $1000
• Position: 20% ($200) × 10x = $2000 notional
• Max Loss (1.5% SL): $30 (1.5% of $2000)
• Target Win (1.8% TP): $36 (1.8% of $2000)
• R:R Ratio: 1:1.2

Key Differences from SOL/ETH

Feature	FARTCOIN	SOL	ETH
Position Sizing	Percentage-based	Fixed USD	Fixed USD
Default Enabled	❌ Disabled	✅ Enabled	✅ Enabled
Purpose	Profit generation	Profit generation	Data collection
Default Size	20% portfolio	$210 fixed	$4 fixed
Default Leverage	10x	10x	1x
Max Leverage	10x	20x	20x

Risk Management

Important Notes:

1. Disabled by default - Safe to deploy, enable when ready
2. Max 10x leverage - Based on Drift Protocol margin requirements
3. Percentage sizing - Automatically scales with portfolio size
4. Quality thresholds - Uses same signal quality filters as SOL/ETH
5. Adaptive leverage - Quality score determines actual leverage used

TradingView Setup

Your indicator should include FARTCOIN detection logic. The bot will:

1. Receive webhook with "symbol": "FARTCOINUSDT"
2. Normalize to FARTCOIN-PERP via normalizeTradingViewSymbol()
3. Check if FARTCOIN_ENABLED=true
4. Calculate position size as percentage of free collateral
5. Apply max 10x leverage
6. Execute trade on Drift Protocol market index 22

Testing Checklist

Before enabling FARTCOIN trading in production:

• Settings UI shows FARTCOIN section correctly
• Toggle switch works (enabled/disabled state)
• Position size slider adjusts (1-100%)
• Leverage slider adjusts (1-10x)
• Risk calculator shows correct values
• Percentage calculation: 20% of $1000 = $200 base
• Notional calculation: $200 × 10x = $2000
• Settings save successfully to .env
• Container restart applies new settings
• Symbol detection works: "FARTCOINUSDT" → "FARTCOIN-PERP"
• Test trade executes with correct position size

Monitoring

Watch for these log messages when FARTCOIN trading is active:

📊 Percentage sizing: 20% of $1000.00 = $200.00
📊 Adaptive leverage: Quality 92 → 10x leverage
🎯 Opening position: FARTCOIN-PERP LONG $2000.00 (10x leverage)
✅ Position opened successfully

Troubleshooting

FARTCOIN trades not executing:

1. Check FARTCOIN_ENABLED=true in settings
2. Verify symbol normalization in logs
3. Check quality score meets threshold (90+ for LONG, 95+ for SHORT)
4. Ensure TradingView alert includes correct symbol
5. Verify free collateral > required amount

Position size incorrect:

1. Check FARTCOIN_USE_PERCENTAGE_SIZE=true (should always be true)
2. Verify percentage calculation in logs
3. Check free collateral value
4. Ensure leverage is between 1-10x

Settings not saving:

1. Check .env file permissions (should be writable)
2. Verify container has access to .env file
3. Check logs for "Settings updated" message
4. Restart container after manual .env changes