Raptor Swap API Overview

Use Solana Tracker’s hosted Raptor Swap API for Solana quotes and swap transactions — no client to run. Self-host the binary only if you need it.

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

Endpoint	Description
GET /quote	Get the expected output amount and route before building a transaction
POST /swap	Build complete swap transactions with priority fee calculation, compute budget overrides, optional SOL tips, and destination account support
POST /swap-instructions	Build swap instructions only (without transaction wrapper)
POST /quote-and-swap	Combined quote and swap in single request with optional tips, fee config, and transaction tuning (optional feature)
POST /send-transaction	Send transactions via Yellowstone Jet TPU with automatic resending and confirmation tracking
GET /transaction/:signature	Track sent transaction status, latency, and parsed events

Analytics

Endpoint	Description
GET /health	Health check with detailed status (pools, cache, Yellowstone connection)

---

WebSocket

Feature	Details
/stream	Real-time quote streaming with subscription management
/stream/swap	Real-time streaming swap quotes with pre-built transactions (ready to sign), including tip support
Slot-based updates	Automatic 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

Level	Use Case
Min / Low	Cost-saving
Auto / Medium	Recommended default
High / VeryHigh	Speed priority
Turbo / UnsafeMax	Maximum 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

Variable	Flag
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

Variable	Description
RPC_URL	Solana RPC endpoint
YELLOWSTONE_ENDPOINT	Yellowstone gRPC endpoint
YELLOWSTONE_TOKEN	Yellowstone auth token (optional)
BIND_ADDR	Server bind address (default: 0.0.0.0:8080)