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.
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
| Token | Pair | CoinGecko ID |
|---|---|---|
| SOL | SOL/USDC | solana |
| JUP | JUP/USDC | jupiter-exchange-solana |
| RAY | RAY/USDC | raydium |
| BONK | BONK/USD | bonk |
| WIF | WIF/USDC | dogwifcoin |
| PYTH | PYTH/USDC | pyth-network |
| RNDR | RNDR/USDC | render-token |
Connect Your Wallet
Claudopolypse supports Phantom and Solflare wallets. Your keys never leave your browser — we never custody your funds or store private keys.
/dashboard. You will see a CONNECT WALLET button in the top-right corner of the terminal.Ab3d...fG9h). The MAINNET status indicator turns green.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 Layout
The terminal is divided into four main zones. Each zone is designed to maximize information density without creating noise.
Left sidebar. Shows all tracked pairs with live prices and 24h change. Click any row to switch the active chart.
Center top. TradingView-style candlestick chart for the selected pair. Supports 1D, 1W, 1M timeframes.
Center bottom. Lists all your open simulated positions with live PnL calculated against current market prices.
Right column top. Market/Limit order form with amount, leverage, and real Jupiter quote for price estimation.
Right column bottom. Chronological log of all trade actions (BUY, SELL, CLOSE) with timestamps.
Navigation Tabs
| Tab | Status | Description |
|---|---|---|
| TRADE | Live | Main trading view — chart, watchlist, order form |
| PORTFOLIO | Live | Overview of all open positions and total PnL |
| SNIPER | Soon | Target-based entry triggers and sniper workflows |
| ANALYTICS | Soon | Historical performance and trading statistics |
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
| Element | Meaning |
|---|---|
Pair name | Token symbol and quote currency (e.g. SOL/USDC) |
| Orange price | Current USD price from CoinGecko |
| Green % change | 24h price change — positive |
| Red % change | 24h price change — negative |
| LIVE | Data is fresh (updated within last 15 seconds) |
| STALE | No 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.
Candlestick Chart
Claudopolypse uses TradingView Lightweight Charts v5for the candlestick display. Chart data is fetched from CoinGecko's OHLC endpoint.
Timeframes
| Button | Period | Candle interval |
|---|---|---|
| 1D | Last 24 hours | ~30 minute candles |
| 1W | Last 7 days | 4 hour candles |
| 1M | Last 30 days | Daily candles |
Reading the Chart
- →Green candles — Closing price higher than opening (bullish)
- →Red candles — Closing price lower than opening (bearish)
- →Wicks — High and low of the candle period
- →Dashed crosshair — Shows exact price and time when hovering
- →Orange price label — Current price pinned on the right axis
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
| Type | How it works |
|---|---|
| MARKET | Executes at the current live price from CoinGecko. Best for immediate entries. |
| LIMIT | You specify the target entry price. The position opens at that price regardless of current market. |
How to Open a Position
MARKET and LIMIT at the top of the Trade Panel. For Limit orders, enter your desired entry price.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
| Field | Description |
|---|---|
| Jupiter quote | Estimated USDC output for your exact input amount, routed through Jupiter aggregator |
| Price impact | How 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
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
Token Mints Reference
SOL → So11111111111111111111111111111111111111112 USDC → EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v JUP → JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN RAY → 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R BONK → DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 WIF → EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm PYTH → HZ1JovNiVvGrGNiiYvEozEVgZ58xaU3RKwX8eACQBCt3 RNDR → rndrizKT3MK1iimdxRdWabcF7Zg7AR5T4nud4EkHBof
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:
// 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 & 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.
Leverage Examples
| Amount | Leverage | Position Size | 10% Move PnL |
|---|---|---|---|
| 1 SOL @ $180 | 1x | $180 | ±$18 |
| 1 SOL @ $180 | 3x | $540 | ±$54 |
| 1 SOL @ $180 | 5x | $900 | ±$90 |
| 1 SOL @ $180 | 10x | $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 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
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
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
| Endpoint | Calls/min (free tier) | Our usage |
|---|---|---|
| simple/price | ~30/min | 6/min (1 batch every 10s) |
| coins/{id}/ohlc | ~30/min | On demand only (pair switch) |
| Jupiter Quote | Unlimited | On demand (debounced 400ms) |
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
{
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:
localStorage.removeItem("claudopolypse_positions");
location.reload();Keyboard Shortcuts
Claudopolypse is designed for speed. Here are keyboard shortcuts available in the terminal (coming in v1.1):
| Shortcut | Action |
|---|---|
T | Switch to TRADE tab |
P | Switch to PORTFOLIO tab |
1 / 7 / 30 | Switch chart timeframe (1D / 1W / 1M) |
↑ / ↓ | Navigate watchlist pairs |
Enter | Select highlighted pair |
Esc | Close any modal |
Frequently Asked Questions
Roadmap
Claudopolypse is actively developed. Here's what's planned across upcoming releases.
- ✓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
- ○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)
- ○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
