Skip to main content
Public Beta — Join Discord for support queries. Raptor is currently free to use with no rate limits.

​
How to use Raptor

You do not need to run a Raptor client or server. Call Solana Tracker’s hosted API from your app, backend, or bot — get quotes, build swap transactions, sign them in the user’s wallet, and send them back. No binary and no RPC setup to operate.
Hosted API (recommended for most integrations)
  • HTTP: https://raptor-beta.solanatracker.io
  • WebSocket: wss://raptor-beta.solanatracker.io
Start with the Swap API guide for the full flow and copy-paste examples. Use the HTTP API reference and WebSocket section below for every endpoint.

Swap API guide

Step-by-step: quote → build → sign → send. Works with curl, fetch, and WebSockets.

Send transactions

Submit signed swaps and track confirmation status.
Self-host (optional) — Only if you want your own Raptor instance. Binary release: GitHub. CLI flags and environment variables are documented below.

​
Endpoints

Raptor’s basic flow is simple: get a quote, build a transaction, sign it with the user’s wallet, send it, then track status.

​
Swap

EndpointDescription
GET /quoteGet the expected output amount and route before building a transaction
POST /swapBuild complete swap transactions with priority fee calculation, compute budget overrides, optional SOL tips, and destination account support
POST /swap-instructionsBuild swap instructions only (without transaction wrapper)
POST /quote-and-swapCombined quote and swap in single request with optional tips, fee config, and transaction tuning (optional feature)
POST /send-transactionSend transactions via Yellowstone Jet TPU with automatic resending and confirmation tracking
GET /transaction/:signatureTrack sent transaction status, latency, and parsed events

​
Analytics

EndpointDescription
GET /healthHealth check with detailed status (pools, cache, Yellowstone connection)

​
WebSocket

FeatureDetails
/streamReal-time quote streaming with subscription management
/stream/swapReal-time streaming swap quotes with pre-built transactions (ready to sign), including tip support
Slot-based updatesAutomatic quote recalculation on pool state changes
Inactivity resend/stream/swap re-sends the latest swap transaction after 10 slots without an update to help avoid transaction expiry
Program ID - Mainnet: RaptorD5ojtsqDDtJeRsunPLg6GvLYNnwKJWxYE4m87

​
Supported DEXs

​
Raydium

  • Raydium AMM
  • Raydium CLMM
  • Raydium CPMM
  • Raydium LaunchLab/Launchpad

​
Meteora

  • Meteora DLMM
  • Meteora Dynamic AMM
  • Meteora DAMM (Dynamic AMM V2)
  • Meteora Curve
  • Meteora DBC (Dynamic Bonding Curve)

​
Orca

  • Whirlpool (legacy)
  • Whirlpool V2

​
Bonding Curves

  • Pump.fun
  • Pumpswap
  • Heaven (Buy/Sell)
  • MoonIt (Buy/Sell)
  • Boopfun (Buy/Sell)

​
PropAMM

  • Humidifi
  • Tessera
  • Solfi V1/V2
  • AlphaQ
  • ZeroFi
  • BisonFi
  • GoonFi V2

​
Other

  • FluxBeam
  • PancakeSwap V3

​
Routing

​
Multi-Hop

  • Up to 4-hop routes for optimal pricing
  • Route-aware slippage calculation (accounts for multi-hop risk)
  • DEX-specific routing preferences
  • Pool filtering by address lists
  • Mint allowlists via txt files
  • Direct-only route mode (onlyDirectRoutes / maxHops=1)
  • Circular arbitrage option

​
Slippage

  • Dynamic slippage based on volatility and route complexity
  • Route-aware multi-hop slippage adjustment
  • Manual slippage override (numeric or "dynamic")
  • Minimum output amount calculation with slippage protection

​
Platform Fees

  • Fee taken from input OR output tokens
  • Configurable fee basis points (up to 10%)
  • Fee wallet specification
  • Extra charge on positive slippage
  • Automatic fee adjustment in quotes and swaps

​
Tips & Transaction Controls

  • Optional native SOL tips via tipAccount and tipLamports
  • Transaction version selection (V0 or LEGACY)
  • Compute unit price override (computeUnitPriceMicroLamports)
  • Compute unit limit override (computeUnitLimit)
  • Maximum priority fee caps (maxPriorityFee)
  • Optional destination token account override (destinationTokenAccount)

​
Priority Fees

​
Dynamic Calculation

  • Route-specific priority fee calculation
  • DEX-specific fee adjustments
  • Recent fee data tracking (slots tracked, total fees)
  • Maximum fee caps and overrides

​
Priority Levels

LevelUse Case
Min / LowCost-saving
Auto / MediumRecommended default
High / VeryHighSpeed priority
Turbo / UnsafeMaxMaximum speed

​
Transaction Management

​
Yellowstone Jet TPU

  • Transaction sending
  • Automatic resending with slot alignment
  • Multiple identity support (4 default, configurable)

​
Tracking

  • Real-time status monitoring (pending / confirmed / failed / expired)
  • Latency measurement (send to confirm)
  • Parsed Raptor program events
  • Raw transaction storage
  • Automatic cleanup

​
Rate Limiting

  • Configurable RPS (uses few RPC calls generally)

​
Self-hosting (optional)

The sections below apply only when you run the Raptor binary yourself. If you use the hosted API above, you can ignore CLI flags and environment variables.

​
CLI flags

​
Help & Version

-h, --help       Show help message
-v, --version    Show version information

​
Pool Indexer

--no-pool-indexer          Disable pool indexer client (Yellowstone only)
--skip-pool-indexer-wait   Skip startup wait for pool indexer sync readiness

​
Routing Filters

--include-dexes <DEXES>    Only include these DEXes (comma-separated)
--exclude-dexes <DEXES>    Exclude these DEXes (comma-separated)
--include-mints-file <PATH>  Only use pools touching mints in this txt file
--include-pools-file <PATH>  Only use pools listed in this txt file

​
Allowlist File Format

Both --include-mints-file and --include-pools-file expect a plain text file with one pubkey per line. Example: 
So11111111111111111111111111111111111111112
EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
# comments are allowed
  • Empty lines are ignored
  • # starts a comment
  • Mint allowlists keep any pool where either token_a or token_b matches a listed mint
  • Pool allowlists keep only the exact listed pool addresses
  • If used together with DEX filters, both filters apply

​
Performance

--workers <N>              Number of worker threads (default: CPU cores)
--low-memory               Enable low-memory mode with automatic cache clearing
--memory-limit <MB>        Memory limit in MB (default: 80% of system RAM)

​
Feature Toggles

--enable-arbitrage         Enable circular arbitrage (same input/output mint)
-s, --enable-quote-and-swap    Enable the /quote-and-swap endpoint
--rpc-rate-limit <N>       Limit RPC calls to N per second (default: unlimited)
--enable-yellowstone-jet   Enable Yellowstone Jet TPU sender for /send-transaction
--enable-websocket         Enable WebSocket streaming quotes at /stream

​
Yellowstone Jet TPU

--jet-identity <PATH>      Path to identity keypair for Jet TPU (optional)
--jet-identities <N>       Number of random identities for Jet (default: 4)
--tx-cache-ttl <SECS>      Transaction cache TTL in seconds (default: 30)
--tx-pending-expiry <SECS> Pending transaction expiry in seconds (default: 120)

​
Request Options

Common swap-building fields supported by POST /swap, POST /quote-and-swap, and /stream/swap subscriptions include:
  • dexes — comma-separated DEX allowlist
  • pools — comma-separated pool allowlist
  • maxHops — maximum route depth (1-4)
  • onlyDirectRoutes — force direct routes only
  • feeAccount, feeBps, feeFromInput, chargeBps — platform fee controls
  • priorityFee, maxPriorityFee — dynamic or fixed priority fee control
  • computeUnitPriceMicroLamports, computeUnitLimit — compute budget overrides
  • txVersion, asLegacyTransaction — transaction format controls
  • tipAccount, tipLamports — optional SOL tip transfer
  • destinationTokenAccount — custom output destination token account

​
Environment Variables

​
CLI Flag Equivalents

VariableFlag
NO_POOL_INDEXER--no-pool-indexer
SKIP_POOL_INDEXER_WAIT--skip-pool-indexer-wait
INCLUDE_DEXES--include-dexes
EXCLUDE_DEXES--exclude-dexes
INCLUDE_MINTS_FILE--include-mints-file
INCLUDE_POOLS_FILE--include-pools-file
WORKER_THREADS--workers
ENABLE_ARBITRAGE--enable-arbitrage
ENABLE_QUOTE_AND_SWAP--enable-quote-and-swap
RPC_RATE_LIMIT--rpc-rate-limit
ENABLE_YELLOWSTONE_JET--enable-yellowstone-jet
JET_IDENTITY--jet-identity
JET_NUM_IDENTITIES--jet-identities
TX_CACHE_TTL_SECS--tx-cache-ttl
TX_PENDING_EXPIRY_SECS--tx-pending-expiry
ENABLE_WEBSOCKET--enable-websocket
LOW_MEMORY_MODE--low-memory
MEMORY_LIMIT_MB--memory-limit

​
Additional Variables

VariableDescription
RPC_URLSolana RPC endpoint
YELLOWSTONE_ENDPOINTYellowstone gRPC endpoint
YELLOWSTONE_TOKENYellowstone auth token (optional)
BIND_ADDRServer bind address (default: 0.0.0.0:8080)