SolTrader Pro
A full-stack, browser-based Solana trading terminal with AI-powered strategy selection, multi-wallet management, smart contract governance, and real-time DEX routing — all connected to the TAC Trader v12 backend.
Table of Contents
SolTrader Pro is a single-page HTML application that operates in two independent modes: standalone (browser → Solana RPC directly) and backend-connected (browser → TAC Trader v12 FastAPI → Solana). The backend connection unlocks AI intelligence scans, strategy tournaments, contract management, and reconciliation services.
│ Dashboard Trading Strategies Settings Contracts │
└─────────────────────────────┬────────────────────────────────────┘
│
┌──────────────┴──────────────┐
│ │
Solana RPC TAC Trader v12 API
(Direct) (https://trader.tuce.app)
• getBalance • /api/v12/system/*
• sendTransaction • /api/v12/trading/*
• getTokenAccounts • /api/v12/contracts/*
• /api/v12/strategies/*
│ │
┌──────┴──────┐ ┌───────┴───────┐
Jupiter Raydium UnifiedRuntime
Swap API Swap API PhasorCore v3
VoidEngine
EulerProbabilityEngine
RPCControlPlane
-
1Open SolTrader Pro
Navigate tohttps://trader.tuce.app/static/SolTrader_Pro_Fixed.htmlin any modern browser (Chrome, Firefox, Brave). No installation required. -
2Connect a Wallet
Click the "+ Add Wallet" button in the top navigation bar. Choose from Phantom (browser extension), Private Key import, or a read-only manual address. You can add and manage multiple wallets simultaneously. -
3Configure RPC
Go to the Settings tab and set your preferred Solana RPC endpoint. The default ishttps://api.mainnet-beta.solana.com. For best performance, use a dedicated RPC provider (Helius, QuickNode, Alchemy). -
4Set Risk Limits
In Settings, configure your Daily Loss Limit (default: 0.5 SOL), Max Slippage (default: 1%), and enable Bad Coin Detection. These guardrails are enforced on every trade. -
5Start Trading
Use Manual Trading for immediate token swaps, or enable the Auto Trader for continuous AI-driven trading. Run an Intelligence Scan first to see current market conditions before activating automation.
The Dashboard is the default landing screen. It provides a live view of your portfolio across all connected wallets, active positions, recent trade history, and the system activity log.
| Metric | Description | Update Frequency |
|---|---|---|
| Total Value | Sum of all wallet balances in USD, calculated using CoinGecko SOL/USD price | Every 30s |
| Total P&L | Cumulative realized profit/loss across all closed trades in the current session | Real-time |
| Win Rate | Percentage of profitable trades out of all closed trades | On trade close |
| Total Trades | Count of all executed trades (buys + sells) in the current session | On trade execution |
Displays all currently open token positions with entry price, current price (live from Birdeye/Jupiter), unrealized P&L, and a quick-sell button. Positions are tracked in-memory and persist for the browser session duration.
Chronological list of all executed trades. Each entry shows token symbol, trade type (BUY/SELL), amount in SOL, approximate USD value, and execution timestamp. The table automatically fetches on-chain transaction history for connected wallets via fetchTransactionHistory().
The real-time activity log displays timestamped entries for all INFO, WARNING, ERROR, and SUCCESS events. Each log entry includes the level badge, timestamp, and message. Logs are colour-coded for quick scanning. Use the Clear Logs button to reset. The log is also used by Diagnostics to surface system health issues.
Execute immediate token swaps by entering a Solana token mint address, specifying the SOL amount, and adjusting slippage tolerance. All swaps are routed through the multi-DEX fallback chain.
| Field | Description | Default |
|---|---|---|
| Token Address | Solana SPL token mint address (base58-encoded) | — |
| Amount (SOL) | Amount of SOL to spend on the trade | — |
| Slippage (%) | Maximum acceptable price impact before trade reverts | 3% |
| Buy / Sell | Direction of the swap (SOL→Token or Token→SOL) | — |
The Auto Trader runs a continuous trading loop that scans the market, scores tokens, and executes buy/sell decisions based on the active strategy and configured risk parameters.
- 1Market Intelligence Scan — Calls
runIntelligenceScan()to compute market score, regime, sentiment, and active signals via TAC v12 API. - 2Strategy Selection — Auto-selects the best strategy based on detected regime and sentiment, or uses the forced strategy override from Settings.
- 3Token Scoring — Each candidate token receives a composite score from
generateTokenScore()incorporating momentum, volume, liquidity, and strategy alignment. - 4Risk Validation — Checks daily loss limit, max slippage, bad coin detection, and available SOL balance before permitting execution.
- 5Trade Execution — Routes order through Jupiter → Raydium → Orca fallback chain. Records result in trade history.
- 6Position Monitoring — After entry, monitors open positions for stop-loss and take-profit thresholds via
checkPositions().
Click Run Intelligence Scan to trigger a full market analysis. The panel displays four real-time metrics:
SolTrader Pro ships with four pre-optimised trading strategies. Each is tuned for a specific market regime. The AI auto-selector automatically picks the best strategy based on current conditions, or you can force a specific strategy from the override dropdown.
| Strategy | Market Regime | Approach | Risk Level |
|---|---|---|---|
| Momentum | TRENDING / BULLISH | Follows strong price trends using velocity and acceleration signals from PhasorCore v3 | Medium |
| Mean Reversion | RANGING / NEUTRAL | Buys oversold conditions, sells overbought. Counter-trend entries near statistical extremes | Medium-Low |
| Breakout | VOLATILE / TRENDING | Detects price consolidation and enters on confirmed breakout with volume confirmation | High |
| Scalping | Any (short timeframe) | High-frequency micro-entries capturing small price differentials on liquid tokens | High |
| Auto (AI) | Adaptive | Uses selectBestStrategy() to pick from above based on live regime and sentiment |
Adaptive |
The position size selector controls how much of your portfolio is allocated per trade. Available options range from 1% to 100% of portfolio value. The recommended setting for automated trading is 3–5% per position to maintain adequate diversification and limit drawdown impact from any single trade.
| Option | Use Case |
|---|---|
| 1–3% of Portfolio | Conservative — suitable for volatile markets and beginners |
| 5% of Portfolio (default) | Balanced — standard setting for most automated strategies |
| 10–15% | Aggressive — higher returns and higher drawdown risk |
| 25–50% | Concentrated — single large position, for high-conviction setups only |
| 100% | All-in — extremely high risk, not recommended for automation |
SolTrader Pro connects directly to the Solana blockchain via configurable JSON-RPC endpoints. Three slots are available: Primary, Backup 1, and Backup 2. The application automatically fails over to backup RPCs if the primary becomes unresponsive.
| Field | Default | Notes |
|---|---|---|
| Primary RPC | https://api.mainnet-beta.solana.com | Solana Foundation public endpoint. Rate limited. Consider upgrading to a paid provider for production use. |
| Backup RPC 1 | https://solana-api.projectserum.com | Project Serum public endpoint (legacy). Useful as a secondary fallback. |
| Backup RPC 2 | https://rpc.ankr.com/solana | Ankr public Solana endpoint. Higher rate limits on free tier than Foundation. |
The TAC Trader v12 backend maintains its own RPC control plane with four endpoints, used for backend AI computations and live mode coordination:
| Endpoint ID | URL | Network | Use |
|---|---|---|---|
solana_mainnet_a | api.mainnet-beta.solana.com | Mainnet | Primary live |
solana_mainnet_b | rpc.ankr.com/solana | Mainnet | Secondary live |
solana_devnet | api.devnet.solana.com | Devnet | Testing |
solana_testnet | api.testnet.solana.com | Testnet | Staging |
The nginx proxy on rpc.trader.tuce.app forwards all Solana JSON-RPC calls to the mainnet primary endpoint.
| API Key | Required | Purpose |
|---|---|---|
| Jupiter API Key | Recommended | Enables higher rate limits and priority routing on Jupiter v6 swap API. Obtain from pro.jup.ag. |
| Birdeye API Key | Optional | Provides enhanced token price data, volume metrics, and holder analytics for improved token scoring. |
| Setting | Default | Description |
|---|---|---|
| Bad Coin Detection | Enabled | Screens tokens against known scam patterns (honeypot, low liquidity, freeze authority) before any trade. |
| Max Slippage (%) | 1% | Hard cap on acceptable slippage for automated trades. Trades exceeding this threshold are rejected. |
| Daily Loss Limit (SOL) | 0.5 SOL | Automatically halts all trading once cumulative daily losses exceed this amount. Resets at midnight UTC. |
| Manual Override | Disabled | When enabled, bypasses all automated position sizing and strategy constraints for direct control. |
The Diagnostics panel provides a real-time health score (0–100) and error count for the current session. Click Run Diagnostics to perform a comprehensive self-test:
- ✅ RPC Connectivity — Tests all configured RPC endpoints and reports latency
- ✅ Wallet Connection — Validates active wallet addresses and balance retrieval
- ✅ DEX API Reachability — Checks Jupiter, Raydium, and Birdeye API availability
- ✅ Backend API Health — Pings TAC Trader v12 /api/v12/system/inventory endpoint
- ✅ Contract Registry — Verifies smart contract bundle loads correctly
- ✅ Risk Config Validation — Confirms loss limits and slippage settings are within safe ranges
Use Export Logs to download the full activity log as a JSON file, and Export Settings to save your current configuration. Both exports are useful for debugging and support requests.
The Contracts tab was introduced in TAC Trader v12 as part of the on-chain governance layer. It provides a complete visual registry of the 24 smart contracts that form the TAC platform's blockchain-native risk and governance infrastructure. From this tab, operators can enable or disable individual contracts, execute contract actions, and run bundle audits.
Click Refresh Contracts to load the full contract bundle from the TAC v12 API (GET /api/v12/contracts/bundle). The registry grid shows all contracts with chain badges and toggle switches. The toggle calls POST /api/v12/contracts/toggle with the contract ID and desired state.
Use the Contract Actions panel to perform targeted operations on individual contracts:
| Action | API Call | Description |
|---|---|---|
| Enable | POST /api/v12/contracts/toggle {id, enabled: true} | Activates contract in the registry. Does not deploy on-chain. |
| Disable | POST /api/v12/contracts/toggle {id, enabled: false} | Deactivates contract without removing from registry. |
| Audit All | GET /api/v12/contracts/bundle + /api/v12/system/inventory | Runs a full audit comparing bundle state with system inventory. Reports mismatches. |
SolTrader Pro supports three wallet connection methods and up to 5 simultaneous wallets. All wallet operations are performed client-side. The active wallet is selected from the dropdown in the top navigation bar.
Phantom is the recommended connection method for live trading. It provides the highest security as private keys remain in the Phantom extension and are never exposed to the browser application.
- 1Install the Phantom browser extension from phantom.app and set up your Solana wallet.
- 2Click "+ Add Wallet" in SolTrader Pro and select Phantom.
- 3Phantom will display an approval prompt — click "Connect" to grant read access.
- 4The wallet address and SOL balance will appear. Phantom automatically signs all transactions with its own approval modal.
Import a wallet by pasting its base58-encoded private key. This method is suitable for server-side or headless environments where a browser extension is unavailable.
- 1Click "+ Add Wallet" and select Private Key.
- 2Paste the base58-encoded private key (88 characters) into the field.
- 3The app derives the public key using
@solana/web3.js Keypair.fromSecretKey()and loads the balance. - 4The private key is encrypted in memory via
encryptPrivateKey(). Clear the input field after connection.
Enter any Solana public key to monitor its balance and positions in read-only mode. No signing capability is available — this mode is for portfolio monitoring only.
SolTrader Pro implements a three-tier DEX routing system. Every trade attempt flows through the priority cascade until a successful quote and execution is achieved.
| Priority | DEX | API | Fallback Trigger |
|---|---|---|---|
| 1st | Jupiter | quote-api.jup.ag/v6 | Primary — used for all swaps. Aggregates 20+ Solana DEXes for best price. |
| 2nd | Raydium | api.raydium.io/v2 | Activated if Jupiter returns error or price impact exceeds threshold. |
| 3rd | Orca | api.orca.so | Final fallback. If Orca also fails, trade is aborted and logged as error. |
SolTrader Pro integrates with the TAC Trader v12 FastAPI backend hosted at https://trader.tuce.app. The following endpoints are called from the frontend.
{"id": "contract_id", "enabled": true|false}. Returns updated contract status.The TAC platform maintains full backward compatibility across all versions:
| Prefix | Version | Status |
|---|---|---|
/api/v6 | TAC Trader v6 | Active |
/api/v9 | TAC Trader v9 | Active |
/api/v10 | TAC Trader v10 | Active |
/api/v11 | TAC Trader v11 | Active |
/api/v12 | TAC Trader v12 (current) | Current |
- 🔑 Private keys are never transmitted to the backend. All signing occurs client-side in the browser via @solana/web3.js.
- 🌐 Use HTTPS exclusively. SolTrader Pro must only be accessed over encrypted connections. Unencrypted HTTP connections expose wallet operations.
- 🔐 API keys are stored in localStorage. Clear browser data when using shared devices. Consider using a dedicated browser profile.
- 📱 Phantom is the safest connection method. Private key import should only be used on fully trusted, private devices.
- ⚡ Emergency Stop is available at all times. The button in Settings immediately halts all automated trading and closes pending operations.
- 💰 Always set a Daily Loss Limit. The default 0.5 SOL limit prevents runaway automated trading losses. Adjust to your risk tolerance.
- 🛡 Bad Coin Detection is enabled by default. This screens for honeypot contracts, tokens with freeze authority, and low-liquidity rugs before every trade.
| Situation | Action | Button/Function |
|---|---|---|
| Auto Trader running out of control | Toggle Auto Trader off | Auto Trader switch in Trading tab |
| Unexpected large loss | Emergency Stop — halts all trading immediately | Settings → Emergency Stop button |
| Suspicious position | Close All Positions — sells all open positions at market | Settings → Close All Positions button |
| Compromised private key | Immediately transfer funds to a new wallet, remove from SolTrader | Disconnect wallet, transfer funds externally |
| Smart contract malfunction | Disable contract in Contracts tab, audit bundle | Contracts → toggle + Audit All |
| Term | Definition |
|---|---|
| PhasorCore v3 | TAC's core signal processing engine. Uses phasor mathematics to compute multi-dimensional market signals from price, volume, and liquidity data. |
| VoidEngine | TAC's market void detection system. Identifies periods of low liquidity or anomalous price action that indicate elevated risk. |
| EulerProbabilityEngine | Probability calculation engine using Euler methods for option-like payoff estimations and signal confidence scoring. |
| RPCControlPlane | Backend component managing connections to multiple Solana RPC endpoints with automatic health scoring and failover. |
| UnifiedRuntime | The central orchestration class in TAC v12 that manages all engines, routers, and services under a single execution context. |
| ReconciliationVerifier | New in v12. Verifies that all services, configs, and datasets in the platform match the expected reconciled state from the v12 build manifest. |
| HybridRouter | API router that forwards requests to the appropriate version-specific handler while maintaining backward compatibility. |
| DEX | Decentralised Exchange. SolTrader Pro uses Jupiter (aggregator), Raydium (AMM), and Orca (concentrated liquidity) for trade execution. |
| Anchor Program | Solana smart contract framework. The sol_guardrail_anchor contract is written using the Anchor framework for Solana Program development. |
| Paper Mode | Simulation mode where trades are computed and tracked but not executed on-chain. Used for testing strategies without real financial risk. |
| Live Mode | Real execution mode where trades are submitted as on-chain transactions and settled on the Solana blockchain. |
| Shadow Mode | Intermediate mode where signals are computed and orders are prepared but held pending human review before submission. |
| Slippage | The difference between the expected price of a trade and the price at which it is executed. Higher slippage tolerance allows trades in lower liquidity conditions. |
| Mint Address | The unique identifier for a Solana SPL token. Used to identify which token to buy or sell in trade instructions. |
| Market Regime | The characterisation of current market behaviour: TRENDING (directional), RANGING (oscillating), VOLATILE (high noise), or BEAR (downtrend). |
| TWAMM | Time-Weighted Average Market Maker. The evm_twamm_adapter contract slices large orders over time to minimise market impact. |
| EVM | Ethereum Virtual Machine. The runtime environment for smart contracts on Ethereum and compatible blockchains (Polygon, BSC, Avalanche, etc.). |