Kryphos City GOV Trading Bot System

Customer Guide

Overview

The Kryphos City Trading Bot is an automated cryptocurrency trading system that trades SOL (Solana) tokens on your behalf using intelligent market analysis and sentiment-based strategies. This guide explains how the bot works, its features, potential profit opportunities, and associated risks.


How It Works

The Trading Flow

  1. You Configure Your Strategy: Choose your risk tolerance, position sizes, and profit targets
  2. The Bot Monitors Markets 24/7: Continuously tracks SOL price every 15 seconds when active
  3. Intelligent Entry/Exit Decisions: Uses Fear & Greed Index and market sentiment to determine optimal trade timing
  4. Automatic Execution: Trades are executed on Jupiter DEX (the leading Solana decentralized exchange)
  5. Real-Time Position Management: Automatic take-profit and stop-loss triggers protect your positions
  6. Performance Tracking: Complete history of all trades with detailed statistics

Architecture Overview

Your Strategy Settings
        |
        v
[Kryphos Trading Bot] <---> [Market Intelligence (FGI)]
        |
        v
[Jupiter DEX on Solana]
        |
        v
  Your Wallet (USDC <-> SOL)


Trading Strategies

1. DCA (Dollar Cost Averaging) [Planned]

The bot can systematically invest at regular intervals, regardless of price fluctuations. This smooths out entry prices over time and reduces the impact of volatility.

How it works:

  • Set a trading interval (30 seconds to 1 hour)
  • Specify what percentage of your wallet to use per trade (1-50%)
  • The bot enters positions at each interval based on market conditions

Best for: Reducing timing risk and building positions over time

2. Sentiment-Based Trading

The bot uses our proprietary Fear & Greed Index (FGI) to identify market opportunities:

Market Sentiment FGI Range Bot Behavior
Extreme Fear 0-20 Strong buy signals - market is oversold
Fear 21-40 Moderate buy signals
Neutral 41-55 Hold - balanced market
Greed 56-75 Moderate sell signals
Extreme Greed 76-100 Strong sell signals - market is overbought

The principle: "Buy when others are fearful, sell when others are greedy"

3. Grid Trading (Flip Direction Mode)

For range-bound markets, the bot can automatically flip between buy and sell positions:

How it works:

  1. Buy SOL at $200
  2. Set take-profit at $220
  3. When TP hits, bot automatically creates a sell order at $220
  4. Sets new TP back at $200
  5. Cycle repeats, capturing profits in both directions

Best for: Markets trading in predictable ranges

4. Take-Profit / Stop-Loss Management

Every position can be protected with:

  • Take Profit (TP): Automatically close when target profit is reached
  • Stop Loss (SL): Automatically close to limit losses if price moves against you

Example:

  • Buy SOL at $200
  • Set TP at $220 (+10%)
  • Set SL at $190 (-5%)
  • Position automatically closes at either level

Market Intelligence - Fear & Greed Index

Our Custom FGI Calculation

We calculate our own Fear & Greed Index using 5 weighted components:

Component Weight What It Measures
Price Volatility 40% Multi-timeframe price movements (1H, 4H, 24H)
Volume Momentum 25% Current volume vs 7-day average
Social Sentiment 20% Market sentiment from social data
Whale Activity 10% Large transaction patterns (10K+ SOL)
Market Dominance 5% SOL's share of total crypto market cap

Data Sources

  • Helius: Primary price source
  • Birdeye: Secondary source for social sentiment and volume
  • CoinGecko: Fallback price source

Update Frequency

  • FGI recalculates every 5 minutes
  • Price monitoring every 15 seconds (when you have active orders/positions)
  • Ensures real-time market awareness

7-Day Trend Chart

The dashboard displays a visual 7-day FGI trend chart with:

  • Desktop View: 12 data points per day (every 2 hours) for detailed analysis
  • Mobile View: 4 data points per day (every 6 hours) for cleaner visualization
  • Statistics: Accurate min/max/average calculated from all raw data points
  • Day Labels: Clear markers at day boundaries for easy navigation

This helps you identify sentiment patterns and make informed trading decisions.


Order Types & Features

Market Orders

Execute immediately at current market price:

  • Market Buy: Instantly purchase SOL with USDC
  • Market Sell: Instantly sell SOL for USDC

Limit Orders

Wait for price to reach your target:

  • Limit Buy: Buy when price drops to your target (buy the dip)
  • Limit Sell: Sell when price rises to your target (sell the pump)

Example: Current price is $200

  • Set limit buy at $190 - order triggers when price falls to $190
  • Set limit sell at $210 - order triggers when price rises to $210

Recurring Orders

Automatically recreate orders after they close:

Mode Behavior
Same Direction Recreate the same order at original entry price
Flip Direction Create opposite order at the take-profit price (grid trading)

Risk Management

Built-In Protections

Protection Description
Position Size Limits Each trade uses 1-50% of your wallet (your choice)
Maximum Positions Run 1-10 simultaneous positions maximum
Exposure Cap Total exposure cannot exceed 100% of wallet
Manual Order Limit Maximum 4 pending orders at once
Minimum Profit Target Trades target 0.1% to 10% profit
Slippage Protection 2% buffer on sell orders for price movement
Fee Buffer $0.50 reserved per order for transaction costs

Automatic Safeguards

  1. Balance Validation: Bot checks you have sufficient funds before every trade
  2. Price Validation: Limit orders validate trigger prices make sense
  3. Reservation System: Funds are reserved for pending orders, preventing double-spending
  4. Separate SOL/USDC Tracking: Buy orders reserve USDC, sell orders reserve SOL

Stop-Loss & Take-Profit

Position Type Take Profit Stop Loss
Buy (Long) Triggers when price rises to TP Triggers when price falls to SL
Sell (Short) Triggers when price falls to TP Triggers when price rises to SL

Signal Protection System

Overview

Signal Protection is an automated position management feature that monitors open positions against combined market signals. When enabled, the system continuously evaluates positions using the Fear & Greed Index (FGI) and Two-Pole Oscillator to detect potentially unfavorable market conditions and take protective action.

How It Works

The Signal Protection system runs every 5 minutes and:

  1. Fetches Combined Signal - Combines FGI (macro sentiment) with the Two-Pole Oscillator (technical momentum) to generate a unified market signal
  2. Evaluates Positions - Checks each protected position to determine if the market signal opposes the position direction
  3. Takes Tiered Action - Responds based on signal confidence level

Signal Combination Logic

FGI Range Oscillator Combined Signal Confidence
< 25 (Extreme Fear) < -0.5 Strong Buy High
25-40 (Fear) < -0.5 Buy Medium
40-60 (Neutral) Any Hold Low
60-75 (Greed) > 0.5 Sell Medium
> 75 (Extreme Greed) > 0.5 Strong Sell High

Tiered Response System

High Confidence Opposing Signal

  • Action: Automatically close the position
  • Example: Long position during Extreme Greed + Oscillator > 0.5
  • Result: Position closed via market swap to protect gains/limit losses

Medium Confidence Opposing Signal

  • Action: Tighten stop-loss by 50% toward entry price
  • Example: Long position during Greed + Oscillator > 0.5
  • Formula: New SL = Current SL + (Entry Price - Current SL) × 0.5
  • Result: Reduced risk while allowing position to continue

Low Confidence Opposing Signal

  • Action: Log warning only
  • Example: Position during neutral market conditions
  • Result: No automatic action, position monitored

Configuration

Setting Default Description
Signal Protection Enabled Can be toggled per trade
Check Interval 5 minutes Monitoring frequency
SL Tightening 50% Percentage toward entry on medium signals

User Controls

  • New Trades: Toggle Signal Protection on/off in the order form
  • Existing Positions: Enable/disable via position edit interface
  • Visual Indicator: Shield icon shows protection status on each position

Benefits

  1. Automated Risk Reduction - No manual monitoring required
  2. Sentiment-Aware - Uses both macro (FGI) and technical (Oscillator) data
  3. Graduated Response - Actions proportional to signal strength
  4. Capital Preservation - Protects gains during market reversals
  5. Configurable - Users retain control over which positions are protected

Example Scenario

A user opens a long position at $120 with Signal Protection enabled:

  1. Market enters Extreme Greed (FGI = 82) with Oscillator at +0.7
  2. Combined signal: Strong Sell with High Confidence
  3. Signal Protection detects opposing signal for long position
  4. Action: Position automatically closed at current market price
  5. Result: User protected from potential reversal during extreme conditions

Win Opportunities

How the Bot Can Generate Profits

1. Sentiment-Driven Entry Timing

When the market is in "Extreme Fear" (FGI 0-20):

  • Prices are typically oversold
  • Bot identifies buying opportunities
  • Historical data shows these often precede recoveries

When the market is in "Extreme Greed" (FGI 76-100):

  • Prices are typically overbought
  • Bot identifies selling opportunities
  • Historical data shows these often precede corrections

2. Automated Discipline

The bot removes emotional decision-making:

  • No panic selling during dips
  • No FOMO buying during pumps
  • Consistent execution of your strategy

3. 24/7 Operation

  • Crypto markets never sleep
  • Bot monitors and trades around the clock
  • Never misses opportunities while you're away

4. Speed Advantage

  • Price monitoring every 15 seconds
  • Immediate execution when triggers hit
  • Faster than manual trading

5. DCA Benefits

  • Regular investments smooth entry prices
  • Reduces impact of buying at peaks
  • Builds positions systematically

Profit Potential Examples

Example 1: Sentiment Swing Trade

  • FGI drops to 15 (Extreme Fear) after market crash
  • Bot buys SOL at $180
  • Market recovers, FGI rises to 65
  • Bot sells at $220
  • Profit: ~22% (minus fees)

Example 2: Grid Trading in Range

  • SOL trading between $190-$210
  • Buy at $195, sell at $205 (5 cycles)
  • Each cycle captures ~5% (minus fees)
  • Monthly potential: 25%+ in ranging market

Example 3: Automated Stop-Loss Protection

  • Buy SOL at $200 with 5% stop-loss at $190
  • Market crashes to $150
  • Position automatically closes at $190
  • Saved 25% of potential loss

Risks & Considerations

Market Risks

Risk Description Mitigation
Price Volatility Crypto can move 10%+ in hours Use stop-losses, smaller position sizes
Flash Crashes Sudden price spikes/drops Stop-losses may not execute at exact price
Trend Reversals Markets can stay irrational DCA to average entry prices
Low Liquidity Large trades may impact price Jupiter finds best routing

Strategy Risks

Risk Description Mitigation
Sentiment Lag FGI may lag market turns Use as one indicator, not sole signal
Whipsaw Quick reversals trigger SL then recover Wider stop-loss, smaller positions
Grid Breakout Price breaks out of expected range Set maximum grid cycles
Over-Trading Too frequent trades eat into profits Minimum 30-second intervals

Technical Risks

Risk Description Mitigation
API Downtime Price sources may be temporarily unavailable 3-source fallback (Helius > Birdeye > CoinGecko)
Network Congestion Solana transactions may delay Automatic retry logic
Smart Contract Risk Jupiter DEX could have bugs Jupiter is battle-tested (billions in volume)

Financial Risks

Risk Description
Loss of Capital You can lose money - only trade what you can afford to lose
Fee Erosion Frequent small trades may have fees exceed profits
Opportunity Cost Funds in trading cannot be used elsewhere

Important Disclaimers

  • Past performance does not guarantee future results
  • Cryptocurrency trading involves substantial risk of loss
  • The bot executes your strategy - results depend on market conditions
  • Never trade with funds you cannot afford to lose
  • This is not financial advice

Fee Structure

Transaction Fees

Fee Type Amount Description
Solana Network ~0.00025 SOL Blockchain transaction fee
Jupiter DEX 0.00-0.3% Swap fee (varies by route)
Platform Fee - Circuite Sky Club 25% of profits Only charged on winning trades
Platform Fee - Citizens 10% of profits Only charged on winning trades

Platform Fee Details

  • Only on profits: No fee if your trade loses money
  • 10% performance fee: Example: $100 profit = $10 fee
  • Batch processing: Fees accumulated and sent when reaching $1.00 threshold
  • Fee wallet: Transparent on-chain transfers

Fee Example

Buy 1 SOL at $200:

  • Network fee: $0.05
  • Jupiter fee: $0.40 (0.2%)
  • Total entry cost: $0.45

Sell 1 SOL at $220:

  • Network fee: $0.05
  • Jupiter fee: $0.44 (0.2%)
  • Platform fee - CSC: $2.00 (10% of $20 profit)
  • Total exit cost: $2.49

Net Profit: $20 - $0.45 - $2.49 = $17.06 (8.5% return)


Requirements to Start Trading

Prerequisites

Requirement Details
Discord Account Must be authenticated via Discord OAuth
Trading Access Role Must have "Trading Access" role in Discord
Hot Wallet Create a trading wallet with password
Minimum Balance 0.5 SOL + $75.00 USDC portfolio value

Wallet Setup

  1. Create Hot Wallet: Generate a new wallet or import existing
  2. Set Password: Minimum 12 characters (encrypted with AES-256)
  3. Fund Wallet: Transfer SOL and/or USDC to your hot wallet address
  4. Unlock Wallet: Enter password to enable trading

Getting Started Steps

  1. Connect Discord account
  2. Verify you have "Trading Access" role
  3. Create your hot wallet
  4. Fund your wallet with SOL + USDC
  5. Configure your strategy
  6. Start the bot

Settings & Customization

Strategy Parameters

Setting Range Default Recommendation
Token SOL, USDC SOL SOL (Maybe other pairs are added in the future.)
Timeframe 1m to 4h 15m 15m-1h for beginners
Interval 30s - 1h 1 min 5-15 min for moderate trading
Profit Target 0.1% - 10% 0.5% 0.5-2% for frequent trading
Position Size 1% - 50% 10% 5-15% for balanced risk
Max Positions 1 - 10 5 3-5 for controlled exposure

Position Settings

Setting Purpose When to Use
Take Profit Lock in gains at target Always recommended
Stop Loss Limit downside Always recommended
Recurring Auto-recreate orders Grid trading strategies

Conservative vs Aggressive Profiles

Conservative Profile:

  • Position size: 5%
  • Max positions: 3
  • Total exposure: 15%
  • Profit target: 1-2%
  • Stop loss: 3-5%

Moderate Profile:

  • Position size: 10%
  • Max positions: 5
  • Total exposure: 50%
  • Profit target: 0.5-1%
  • Stop loss: 5-7%

Aggressive Profile:

  • Position size: 20%
  • Max positions: 5
  • Total exposure: 100%
  • Profit target: 0.3-0.5%
  • Stop loss: 3-5%

Performance Metrics

The bot tracks these metrics for your session:

Metric Description
Total Trades Number of completed trades
Win Rate Percentage of profitable trades
Total Profit Cumulative realized P&L in USD
Total Volume Total USD value traded
Max Drawdown Largest peak-to-trough decline
Sharpe Ratio Risk-adjusted return metric

Understanding Your Performance

  • Win Rate > 50% with positive risk-reward: Profitable strategy
  • High win rate + small wins: May underperform with few large losses
  • Lower win rate + big wins: Can be profitable with good risk management
  • Monitor drawdown: If exceeds 20%, consider adjusting strategy

Support & Resources

Getting Help

  • Contact support through Discord

Best Practices

  1. Start small: Test with minimum amounts first
  2. Use stop-losses: Always protect your downside
  3. Don't over-leverage: Keep total exposure reasonable
  4. Monitor regularly: Check bot performance daily
  5. Adjust to market: Reduce trading in uncertain conditions

Glossary

Term Definition
DCA Dollar Cost Averaging - buying at regular intervals
FGI Fear & Greed Index - market sentiment indicator
TP Take Profit - automatic profit-taking level
SL Stop Loss - automatic loss-limiting level
DEX Decentralized Exchange (Jupiter)
Slippage Price movement between order and execution
Drawdown Decline from peak portfolio value
Win Rate Percentage of trades that are profitable

Last Updated: December 2025

This document is for informational purposes only and does not constitute financial advice. Trading cryptocurrencies involves substantial risk. Please trade responsibly.