//Getting Started

Welcome to Claudopolypse

Claudopolypse is a Solana-native trading terminal built for serious traders. Unlike typical DEX swap UIs, Claudopolypse is designed around execution speed — giving you a pro-grade interface with real-time market data, multi-pair watchlists, candlestick charts, and Jupiter-routed order flows.

This documentation covers everything you need to go from wallet connection to active trading in under five minutes.

TIPIf you just want to dive in, go straight to the terminal and connect your Phantom or Solflare wallet. Everything is self-explanatory from there.

Prerequisites

Before using Claudopolypse, you need:

  • Solana wallet Phantom or Solflare (browser extension or mobile)
  • SOL balance At least 0.01 SOL for transaction fees
  • Token balance The token you want to trade (e.g. USDC for buying, SOL for selling)

Supported Tokens

TokenPairCoinGecko ID
SOLSOL/USDCsolana
JUPJUP/USDCjupiter-exchange-solana
RAYRAY/USDCraydium
BONKBONK/USDbonk
WIFWIF/USDCdogwifcoin
PYTHPYTH/USDCpyth-network
RNDRRNDR/USDCrender-token
//Connect Your Wallet

Connect Your Wallet

Claudopolypse supports Phantom and Solflare wallets. Your keys never leave your browser — we never custody your funds or store private keys.

01
Install a Wallet
Download Phantom or Solflare as a browser extension from their official websites. Make sure you save your seed phrase in a secure location.
02
Open the Terminal
Navigate to /dashboard. You will see a CONNECT WALLET button in the top-right corner of the terminal.
03
Approve the Connection
A modal will appear listing available wallets. Select your wallet. Your wallet extension will ask you to approve the connection — click Approve.
04
Verify Connection
Once connected, your wallet address appears in the top bar (e.g. Ab3d...fG9h). The MAINNET status indicator turns green.
WARNINGClaudopolypse connects to Solana Mainnet. All trades use real funds. Never connect a wallet with funds you cannot afford to lose. Test with small amounts first.

Disconnecting

Click your wallet address in the top bar, then click DISCONNECT. Your session data is cleared immediately. Positions stored in localStorage remain available next time you connect.

//Terminal Overview

Terminal Layout

The terminal is divided into four main zones. Each zone is designed to maximize information density without creating noise.

AWatchlist

Left sidebar. Shows all tracked pairs with live prices and 24h change. Click any row to switch the active chart.

BChart Panel

Center top. TradingView-style candlestick chart for the selected pair. Supports 1D, 1W, 1M timeframes.

CPositions Panel

Center bottom. Lists all your open simulated positions with live PnL calculated against current market prices.

DTrade Panel

Right column top. Market/Limit order form with amount, leverage, and real Jupiter quote for price estimation.

EActivity Log

Right column bottom. Chronological log of all trade actions (BUY, SELL, CLOSE) with timestamps.

Navigation Tabs

TabStatusDescription
TRADELiveMain trading view — chart, watchlist, order form
PORTFOLIOLiveOverview of all open positions and total PnL
SNIPERSoonTarget-based entry triggers and sniper workflows
ANALYTICSSoonHistorical performance and trading statistics
//Watchlist

Watchlist & Pair Selection

The watchlist on the left sidebar displays real-time prices for all 7 supported pairs, fetched every 10 seconds from the CoinGecko API. No API key is required.

Reading the Watchlist

ElementMeaning
Pair nameToken symbol and quote currency (e.g. SOL/USDC)
Orange priceCurrent USD price from CoinGecko
Green % change24h price change — positive
Red % change24h price change — negative
LIVEData is fresh (updated within last 15 seconds)
STALENo successful fetch in the last 15 seconds

Switching Pairs

Click any row in the watchlist to switch the active pair. The chart will reload with OHLCV data for the selected token, and the Trade Panel will update its price and Jupiter quote context.

NOTEThe active pair is highlighted with an orange left border and a subtle orange background tint.
//Candlestick Chart

Candlestick Chart

Claudopolypse uses TradingView Lightweight Charts v5for the candlestick display. Chart data is fetched from CoinGecko's OHLC endpoint.

Timeframes

ButtonPeriodCandle interval
1DLast 24 hours~30 minute candles
1WLast 7 days4 hour candles
1MLast 30 daysDaily candles

Reading the Chart

  • Green candlesClosing price higher than opening (bullish)
  • Red candlesClosing price lower than opening (bearish)
  • WicksHigh and low of the candle period
  • Dashed crosshairShows exact price and time when hovering
  • Orange price labelCurrent price pinned on the right axis
NOTEThe CoinGecko free tier provides OHLC data without an API key. Data refreshes when you switch pairs or timeframes, not on a continuous interval (to stay within rate limits).
//Placing Orders

Placing Orders

The Trade Panel (right column) lets you open LONG or SHORT positions on any supported pair. Orders are simulated locally — no on-chain transaction is submitted. Real Jupiter quotes are fetched to give you accurate price estimates.

Order Types

TypeHow it works
MARKETExecutes at the current live price from CoinGecko. Best for immediate entries.
LIMITYou specify the target entry price. The position opens at that price regardless of current market.

How to Open a Position

01
Select a pair
Click the pair in the Watchlist. The Trade Panel updates to show the current price.
02
Choose Market or Limit
Toggle between MARKET and LIMIT at the top of the Trade Panel. For Limit orders, enter your desired entry price.
03
Enter amount
Type the number of tokens you want to trade. The Jupiter Quote API will automatically fetch a real swap estimate as you type.
04
Set leverage (optional)
Use the slider to set leverage from 1x to 10x. This multiplies your position size for PnL calculations.
05
Click BUY / LONG or SELL / SHORT
The position is added to your Open Positions panel and persisted to localStorage. The Activity Log records the action.
WARNINGClaudopolypse currently runs in simulation mode. No real on-chain transactions are submitted. Future versions will integrate full Jupiter swap execution.
//Jupiter Price Quotes

Jupiter Price Quotes

When you type an amount in the Trade Panel, Claudopolypse automatically queries the Jupiter v6 Quote API to get a real swap estimate. This gives you accurate pricing including liquidity depth, routing, and price impact.

What the Quote Shows

FieldDescription
Jupiter quoteEstimated USDC output for your exact input amount, routed through Jupiter aggregator
Price impactHow much your trade moves the market. Shown in red if above 0.1%
Total (leveraged)Your raw total × leverage multiplier for position sizing

Quote API Endpoint

Jupiter v6 Quote API
GET https://quote-api.jup.ag/v6/quote
  ?inputMint=So111...112        // SOL mint
  ?outputMint=EPjFW...1v       // USDC mint
  ?amount=1000000000           // 1 SOL in lamports
  ?slippageBps=50              // 0.5% slippage tolerance
TIPJupiter quotes are fetched with a 400ms debounce — so they only fire after you stop typing, not on every keystroke.

Token Mints Reference

Solana mainnet token mints
SOL   → So11111111111111111111111111111111111111112
USDC  → EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
JUP   → JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN
RAY   → 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R
BONK  → DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
WIF   → EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm
PYTH  → HZ1JovNiVvGrGNiiYvEozEVgZ58xaU3RKwX8eACQBCt3
RNDR  → rndrizKT3MK1iimdxRdWabcF7Zg7AR5T4nud4EkHBof
//Positions & PnL

Open Positions & PnL

Every time you open a trade, a position is created and stored in your browser's localStorage. Positions persist across page refreshes and browser sessions as long as you use the same browser.

PnL Calculation

PnL is calculated in real time using live prices from the Watchlist. The formula is:

PnL formula
// LONG position
pnl = ((current_price - entry_price) / entry_price) × position_size

// SHORT position
pnl = ((entry_price - current_price) / entry_price) × position_size

// Position size includes leverage
position_size = amount × entry_price × leverage

Closing a Position

Click the CLOSE button on any position row. The realized PnL is calculated at the current market price and logged to the Activity Log. The position is removed from localStorage immediately.

Portfolio View

Switch to the PORTFOLIO tab in the top bar for a summary view showing:

  • Total number of open positions
  • Aggregate unrealized PnL across all positions
  • Estimated total portfolio value
//Leverage

Leverage & Position Sizing

Claudopolypse supports simulated leverage from 1x to 10x. Leverage multiplies your effective position size for PnL calculation — it does not represent real on-chain borrowing at this stage.

WARNINGLeverage amplifies both gains and losses. A 10x leveraged position can lose its entire notional value with a 10% adverse move. Use leverage carefully.

Leverage Examples

AmountLeveragePosition Size10% Move PnL
1 SOL @ $1801x$180±$18
1 SOL @ $1803x$540±$54
1 SOL @ $1805x$900±$90
1 SOL @ $18010x$1,800±$180

Set leverage using the slider in the Trade Panel before clicking BUY/SELL. The Total field updates in real time to reflect the leveraged position size.

//Price Feeds

Price Feed Architecture

All market data is sourced from the CoinGecko Public API v3. No API key is required. The terminal polls prices in a single batched request every 10 seconds.

Live Price Polling

CoinGecko simple/price endpoint
GET https://api.coingecko.com/api/v3/simple/price
  ?ids=solana,jupiter-exchange-solana,raydium,
       bonk,dogwifcoin,pyth-network,render-token
  ?vs_currencies=usd
  ?include_24hr_change=true

// Response
{
  "solana": {
    "usd": 187.42,
    "usd_24h_change": 12.38
  },
  ...
}

OHLCV Chart Data

CoinGecko OHLC endpoint
GET https://api.coingecko.com/api/v3/coins/{id}/ohlc
  ?vs_currency=usd
  ?days=1     // 1D, 7 = 1W, 30 = 1M

// Response: array of [timestamp, open, high, low, close]
[
  [1712131200000, 185.10, 188.44, 184.20, 187.42],
  ...
]

Rate Limits

EndpointCalls/min (free tier)Our usage
simple/price~30/min6/min (1 batch every 10s)
coins/{id}/ohlc~30/minOn demand only (pair switch)
Jupiter QuoteUnlimitedOn demand (debounced 400ms)
TIPIf you see STALE in the watchlist, CoinGecko may be rate limiting your IP. Wait 30 seconds and the feed will resume automatically.
//Local Storage

Local Storage & Data Persistence

Claudopolypse stores your simulated positions in the browser's localStorage under the key claudopolypse_positions. No data is sent to any server.

Position Data Structure

Position object schema
{
  id: string,          // unique random ID
  pair: string,        // e.g. "SOL/USDC"
  coinId: string,      // CoinGecko ID e.g. "solana"
  side: "LONG"|"SHORT",
  entry: number,       // entry price in USD
  amount: number,      // token amount
  size: number,        // USD value × leverage
  timestamp: number    // Unix ms
}

Clearing Your Data

To manually clear all positions, open your browser console and run:

Browser console
localStorage.removeItem("claudopolypse_positions");
location.reload();
WARNINGData stored in localStorage is browser-specific. If you use a different browser or clear browser data, your positions will not carry over.
//Keyboard Shortcuts

Keyboard Shortcuts

Claudopolypse is designed for speed. Here are keyboard shortcuts available in the terminal (coming in v1.1):

ShortcutAction
TSwitch to TRADE tab
PSwitch to PORTFOLIO tab
1 / 7 / 30Switch chart timeframe (1D / 1W / 1M)
↑ / ↓Navigate watchlist pairs
EnterSelect highlighted pair
EscClose any modal
NOTEKeyboard shortcuts are planned for v1.1. Currently all interactions are mouse-based.
//FAQ

Frequently Asked Questions

QAre my trades real?
ANo. Claudopolypse is currently in simulation mode. No on-chain transactions are submitted. All positions are stored locally in your browser. Jupiter quotes are fetched for accurate price estimates, but no swap is executed.
QWhy do I need to connect a wallet if trades are simulated?
AWallet connection establishes your identity on-chain and is required for the upcoming real trade execution feature. Connecting your wallet now ensures a smooth upgrade path when live trading is enabled.
QThe watchlist shows STALE — what do I do?
ACoinGecko's free tier has rate limits (~30 requests/min per IP). If you see STALE, wait 30–60 seconds. The terminal will automatically retry and the status will return to LIVE.
QMy positions disappeared after a browser update
APositions are stored in localStorage which can be cleared by browser updates, private browsing sessions, or manual cache clears. Export functionality (CSV/JSON) is planned for v1.2.
QDoes leverage work on-chain?
ANot currently. Leverage in the current version is a simulation multiplier that affects PnL calculations only. Real leveraged trading via protocols like Drift or Mango is on the roadmap.
QWhat is Sniper Mode?
ASniper Mode (coming soon) lets you set target entry prices with automatic triggers. When your target price is hit, the position is opened automatically without manual intervention.
QWhich wallets are supported?
APhantom and Solflare are supported via the Solana Wallet Adapter standard. More wallets (Backpack, Glow, Ledger) will be added in future updates.
//Roadmap

Roadmap

Claudopolypse is actively developed. Here's what's planned across upcoming releases.

v1.0Current
  • 7-pair watchlist with live CoinGecko prices
  • TradingView lightweight-charts (1D/1W/1M)
  • Simulated LONG/SHORT with 1–10x leverage
  • Jupiter v6 Quote API integration
  • Phantom + Solflare wallet adapter
  • LocalStorage position persistence
  • Portfolio overview tab
v1.1Next
  • Keyboard shortcuts for full keyboard-driven trading
  • Sniper Mode — target-based auto entries
  • Alert system — price alerts via browser notifications
  • Volume data overlay on charts
  • More pairs (JITO, POPCAT, MEW, TRUMP)
v1.2Planned
  • Real on-chain swap execution via Jupiter
  • Real leveraged trading via Drift Protocol
  • Position export (CSV / JSON)
  • Analytics tab — win rate, avg hold time, best trades
  • Backpack, Glow, Ledger wallet support