Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
agiprolabs avatar

Raptor Dex

  • 189 installs
  • 257 repo stars
  • Updated June 24, 2026
  • agiprolabs/claude-trading-skills

raptor-dex is a Claude Code skill for driving Raptor, a self-hosted Solana DEX aggregator that routes swaps across 25+ DEXes via an HTTP API.

About

raptor-dex is a Claude Code skill for Raptor, a self-hosted Solana DEX aggregator by SolanaTracker. It documents the quote, swap, send-transaction, and status-tracking HTTP endpoints for multi-hop routing across 25+ DEXes, with local signing and Yellowstone Jet TPU submission. A developer uses it to build swap execution against a self-run Raptor binary with no rate limits or API key.

  • Multi-hop swap routing across 25+ Solana DEXes via a self-hosted Rust binary
  • Quote, swap, send-transaction, and status endpoints with local signing (private key never leaves the machine)
  • Yellowstone Jet TPU submission with auto-retry; no rate limits and no API key

Raptor Dex by the numbers

  • 189 all-time installs (skills.sh)
  • Ranked #489 of 1,106 Finance & Trading skills by installs in the Skillselion catalog
  • Data as of Aug 4, 2026 (Skillselion catalog sync)
At a glance

raptor-dex capabilities & compatibility

Free during public beta with no API key; requires you to self-host the Raptor binary and provide your own Solana RPC and Yellowstone gRPC endpoints.

Capabilities
dex aggregation · swap routing · transaction submission · quote comparison
Use cases
data analysis
Platforms
Linux · macOS
Runs
Runs locally
Pricing
Free
From the docs

What raptor-dex says it does

Raptor is a self-hosted Rust binary that aggregates swap quotes across 25+ Solana DEXes.
SKILL.md
Unlike Jupiter, Raptor runs on your own infrastructure with **no rate limits**, **no API key**, and **no dependency on external API availability**.
SKILL.md
npx skills add https://github.com/agiprolabs/claude-trading-skills --skill raptor-dex

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs189
repo stars257
Last updatedJune 24, 2026
Repositoryagiprolabs/claude-trading-skills

What it does

Get swap quotes and submit swaps across 25+ Solana DEXes through the self-hosted Raptor aggregator.

Who is it for?

Getting best-route swap quotes and executing Solana swaps through a self-hosted aggregator.

Skip if: Managed/hosted swap APIs with rate limits; Raptor must be self-hosted.

When should I use this skill?

You are building Solana swap execution and want self-hosted multi-DEX routing without an external API dependency.

What you get

Best-route swap quotes and submitted, locally-signed swap transactions across 25+ Solana DEXes.

  • Best-route swap quote
  • Unsigned swap transaction
  • Submitted transaction signature and status

By the numbers

  • 25+ Solana DEXes aggregated
  • 7 HTTP API endpoints (quote, swap, swap-instructions, quote-and-swap, send-transaction, transaction, health)
  • 1-4 max hops

Files

SKILL.mdMarkdownGitHub ↗

Raptor — Self-Hosted Solana DEX Aggregator

Raptor is a self-hosted Rust binary that aggregates swap quotes across 25+ Solana DEXes. Unlike Jupiter, Raptor runs on your own infrastructure with no rate limits, no API key, and no dependency on external API availability. Free during public beta.

Quick Start

# Clone the binary repo (includes required signature file)
git clone https://github.com/solanatracker/raptor-binary
cd raptor-binary

# Run with required environment variables
export RPC_URL="https://your-solana-rpc.com"
export YELLOWSTONE_ENDPOINT="https://your-yellowstone-grpc.com"
export YELLOWSTONE_TOKEN="your-token"  # if required by provider
./raptor
# Listens on 0.0.0.0:8080 by default

Requirements: Solana RPC endpoint + Yellowstone gRPC endpoint (for pool indexing). Raptor uses very few RPC calls during normal operation since pool state is streamed via Yellowstone.

Signature file: The signature file must be in the same directory as the Raptor binary. It authenticates your instance and is included in the repo clone. If you move the binary, copy the signature file with it.

Execution Flow

1. GET  /quote              → Best route across 25+ DEXes
2. POST /swap               → Unsigned versioned transaction
3. Sign locally              → Your private key never leaves your machine
4. POST /send-transaction   → Submit via Yellowstone Jet TPU
5. GET  /transaction/{sig}  → Confirm status (pending/confirmed/failed/expired)

API Endpoints

MethodEndpointDescription
GET/quoteGet swap quote with multi-hop routing
POST/swapBuild swap transaction from quote
POST/swap-instructionsGet swap instructions only (no tx wrapper)
POST/quote-and-swapQuote + transaction in one request
POST/send-transactionSubmit via Yellowstone Jet TPU with auto-retry
GET/transaction/:signatureTrack transaction status and parsed events
GET/healthHealth check (pools, cache, Yellowstone connection)

Get a Quote

import httpx

RAPTOR = "http://localhost:8080"

resp = httpx.get(f"{RAPTOR}/quote", params={
    "inputMint": "So11111111111111111111111111111111111111112",   # SOL
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",  # USDC
    "amount": 1_000_000_000,  # 1 SOL in lamports
    "slippageBps": 50,
})
quote = resp.json()
print(f"Output: {quote['amountOut']} lamports")
print(f"Price impact: {quote['priceImpact']}%")
print(f"Route: {len(quote['routePlan'])} hops")

Quote Parameters

ParameterTypeRequiredDescription
inputMintstringYesInput token mint address
outputMintstringYesOutput token mint address
amountintegerYesAmount in smallest unit (lamports)
slippageBpsstringNoBasis points or "dynamic" (default: 50)
dexesstringNoComma-separated DEX filter
excludeDexesstringNoDEXes to exclude
maxHopsintegerNo1-4 hops (default: 4)
directRouteOnlybooleanNoOnly single-hop routes
poolsstringNoComma-separated pool address filter
feeBpsintegerNoPlatform fee 0-1000 bps
feeAccountstringNoFee recipient wallet

Build and Sign a Swap

import base64
import os

# Step 2: Build transaction from quote
resp = httpx.post(f"{RAPTOR}/swap", json={
    "quoteResponse": quote,
    "userPublicKey": "YOUR_WALLET_PUBKEY",
    "wrapUnwrapSol": True,
    "txVersion": "v0",
    "priorityFee": "auto",       # min|low|auto|medium|high|veryHigh|turbo|unsafeMax
    "maxPriorityFee": 100_000,    # cap in lamports
})
swap = resp.json()
# swap["swapTransaction"] is base64-encoded unsigned transaction

# Step 3: Sign locally (private key never sent to Raptor)
from solders.transaction import VersionedTransaction
from solders.keypair import Keypair

tx_bytes = base64.b64decode(swap["swapTransaction"])
tx = VersionedTransaction.from_bytes(tx_bytes)
keypair = Keypair.from_base58_string(os.getenv("PRIVATE_KEY"))
signed_tx = VersionedTransaction(tx.message, [keypair])
signed_b64 = base64.b64encode(bytes(signed_tx)).decode()

# Step 4: Submit via Yellowstone Jet TPU
resp = httpx.post(f"{RAPTOR}/send-transaction", json={
    "transaction": signed_b64,
})
result = resp.json()
print(f"Signature: {result['signature']}")

# Step 5: Track status
resp = httpx.get(f"{RAPTOR}/transaction/{result['signature']}")
status = resp.json()
# status: pending | confirmed | failed | expired
print(f"Status: {status['status']}, Latency: {status.get('latency_ms')}ms")

WebSocket Streaming

Real-time quote streaming with slot-based updates when pool state changes:

import asyncio, websockets, json

async def stream_quotes():
    async with websockets.connect("ws://localhost:8080/stream") as ws:
        await ws.send(json.dumps({
            "type": "subscribe",
            "inputMint": "So11111111111111111111111111111111111111112",
            "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
            "amount": 1_000_000_000,
            "slippageBps": "50",
        }))
        async for msg in ws:
            data = json.loads(msg)
            if data.get("type") == "quote":
                print(f"Out: {data['data']['amountOut']} (slot {data['data']['contextSlot']})")

/stream/swap variant pre-builds transactions ready for signing, with automatic resend every 10 slots to prevent expiry.

Supported DEXes (25+)

Raydium: AMM, CLMM, CPMM, LaunchLab | Meteora: DLMM, Dynamic AMM, DAMM V2, Curve, DBC | Orca: Whirlpool v1/v2 | Bonding Curves: Pump.fun, Pumpswap, Heaven, MoonIt, Boopfun | PropAMM: Humidifi, Tessera, Solfi V1/V2, AlphaQ, ZeroFi, BisonFi, GoonFi V2 | Other: FluxBeam, PancakeSwap V3

Configuration

Environment Variables

VariableRequiredDefaultDescription
RPC_URLYesSolana RPC endpoint
YELLOWSTONE_ENDPOINTYesYellowstone gRPC endpoint
YELLOWSTONE_TOKENNoAuth token (if provider requires)
BIND_ADDRNo0.0.0.0:8080Listen address
INCLUDE_DEXESNoallComma-separated DEX filter
EXCLUDE_DEXESNononeDEXes to exclude
WORKER_THREADSNoCPU coresWorker thread count
ENABLE_WEBSOCKETNofalseEnable /stream endpoints
ENABLE_YELLOWSTONE_JETNofalseEnable Jet TPU for /send-transaction
ENABLE_ARBITRAGENofalseEnable circular arbitrage routes

CLI Flags

./raptor --include-dexes raydium,orca,meteora \
         --enable-websocket \
         --enable-yellowstone-jet \
         --workers 4

DEX Filtering Examples

# Only bonding curve DEXes (for PumpFun sniping)
INCLUDE_DEXES="pumpfun,pumpswap,heaven,moonit,boopfun" ./raptor

# Only major AMMs
INCLUDE_DEXES="raydium,orca,meteora" ./raptor

Priority Fee Levels

LevelUse Case
min / lowCost-saving, non-urgent
auto / mediumRecommended default
high / veryHighFaster confirmation
turbo / unsafeMaxMaximum speed, competitive scenarios

Raptor vs Jupiter

FeatureRaptorJupiter
Self-hostedYesNo
Rate limitsNone (your hardware)API rate limits
DEX coverage25+30+
LatencyNetwork-localRemote API
CostFree (beta)Free (hosted)
Tx submissionYellowstone Jet TPUStandard RPC
On-chain programRaptorD5o...JUP...
API key requiredNoNo

Deployment

See references/deployment.md for Docker, Fly.io, and bare metal setup.

Files

References

Scripts

  • scripts/raptor_quote.py — Get and compare swap quotes with --demo mode
  • scripts/raptor_swap.py — Full swap flow: quote → build → sign → submit → confirm (simulation only in --demo)

Related skills

FAQ

How is Raptor different from Jupiter?

Raptor runs on your own infrastructure with no rate limits, no API key, and no dependency on external API availability, and is free during public beta.

Does Raptor hold your private key?

No; you sign the unsigned transaction locally and your private key never leaves your machine.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.