Architecture

Architecture

A high-level look at what makes WhalesX fast. You don’t need this to trade — it’s here for the curious.

The pipeline

WhalesX ingests on-chain activity, decodes it, scores it, and acts — all in real time, with no polling delay.

 Solana ──(gRPC streams)──► Ingester ──► decode 9 DEXes ──► event bus

        ┌──────────────────────────────────────────────────┬─┴───────────────┐
        ▼                          ▼                         ▼                 ▼
  Token Tracker            Copy Strategy             Market Analytics    Smart Exit
  score & promote          detect leaders            identity & trends   PnL & exits
        │                          │                                          │
        └──────────► Trading Engine (build · sign · send) ◄───────────────────┘

                            Settler (confirm)

What each part does

ComponentRole
IngesterSubscribes to 9 real-time Solana streams (one per DEX) and decodes every swap, create and migration.
Token TrackerMaintains a live state machine per token; runs bundle / rug / KOL / sniper detection and applies your promotion rules.
Copy StrategyDetects when a leader you follow trades and creates a mirror order.
Trading EngineBuilds the instruction, signs it with your vault-held key, and sends it with your chosen priority/tip.
SettlerCorrelates your sent transaction with the on-chain trade and confirms it.
Smart ExitTracks each open position’s PnL and fires one of 14 exit strategies.
Market AnalyticsBuilds wallet & creator identity scores that feed the quality filters.

Supported DEXes

Pumpfun · PumpSwap · Raydium (CPMM / CLMM / Launchpad) · Meteora (DBC / DAMM / DAMM v2) — created, traded and migrated events are all decoded natively.

Non-custodial by design

Your trading wallet’s private key is encrypted in a HashiCorp Vault. The Trading Engine requests a signature only when executing your own configured strategy. You can export the key and walk away at any time.

Precision first

This system moves real money on-chain. Every price calculation is done against the exact on-chain curve/reserve math for each DEX — not estimates — because a single inverted reserve would mean a wrong fill.