Resumen - Solana Tracker

Únete al Discord para consultas de soporte. Raptor es actualmente gratis y sin límites de tasa.

Cómo usar Raptor

No necesitas ejecutar un cliente ni servidor de Raptor. Llama a la API alojada de Solana Tracker desde tu app, backend o bot: obtén cotizaciones, construye transacciones de swap, fírmalas en la wallet del usuario y envíalas. Sin binario, sin configurar RPC ni operar un indexador de pools.

API alojada (recomendada para la mayoría de integraciones)

HTTP: https://raptor.solanatracker.io
WebSocket: wss://raptor.solanatracker.io

Empieza con la guía Swap API para el flujo completo y ejemplos listos para copiar. Consulta la referencia HTTP y la sección WebSocket más abajo para cada endpoint.

Guía Swap API

Paso a paso: cotización → construir → firmar → enviar. Con curl, fetch y WebSockets.

Enviar transacciones

Envía swaps firmados y sigue el estado de confirmación.

Autoalojamiento (opcional) — Solo si quieres tu propia instancia de Raptor. Release binario: GitHub. Flags CLI y variables de entorno en Autoalojamiento (opcional) más abajo.

JIT routing

Una ruta normal elige sus pools al cotizar. Con el routing just-in-time (JIT), la transacción lleva varios pools candidatos y elige los mejores al ejecutarse, con precios en vivo. Ayuda sobre todo en órdenes grandes y en pools que se mueven rápido.

`jitRouting`	Comportamiento
`auto` (por defecto)	Raptor usa JIT cuando mejora el resultado. Las órdenes de unos $10,000 o más reciben una búsqueda completa.
`true`	Siempre construye una ruta JIT
`false`	Nunca usa JIT

Las cotizaciones que usan JIT incluyen "jitRouting": true. A tener en cuenta:

minAmountOut se sigue aplicando. Si los precios en vivo no lo alcanzan, la transacción falla en lugar de ejecutarse a peor precio.
JIT funciona con transacciones V0 y V1. Las transacciones LEGACY no tienen tablas de búsqueda y su límite es de 1.232 bytes, así que las rutas JIT rara vez caben; cotiza con jitRouting=false si necesitas LEGACY.
Los swaps JIT no se pueden llamar desde otro programa. /swap-instructions devuelve un swap normal salvo que envíes jitRouting: true. Cuando devuelve topLevelOnly: true, pon swapInstruction al final de la transacción y llámala directamente, no por CPI. Si no, falla con InvalidJitPlan (6026).
JIT está disponible en todos los DEX soportados excepto Heaven, SolFi V1, BisonFi y Quantum.

Endpoints

El flujo básico de Raptor es simple: obtén una cotización, construye una transacción, fírmala con la wallet del usuario, envíala y sigue el estado.

Swap

Endpoint	Descripción
`GET /quote`	Obtén la cantidad de salida esperada y la ruta antes de construir una transacción
`POST /swap`	Construye transacciones de swap completas con cálculo de priority fee, overrides de compute budget, propinas SOL opcionales y soporte para cuenta de destino
`POST /swap-instructions`	Construye solo las instrucciones de swap (sin wrapper de transacción)
`POST /quote-and-swap`	Cotización y swap combinados en una sola solicitud con propinas, configuración de fee y ajuste de transacción opcionales (feature opcional)
`POST /send-transaction`	Envía transacciones vía Yellowstone Jet TPU con reenvío automático y tracking de confirmación
`GET /transaction/:signature`	Sigue el estado de transacciones enviadas, latencia y eventos parseados

Analytics

Endpoint	Descripción
`GET /health`	Health check con estado detallado (pools, cache, conexión Yellowstone)

WebSocket

Feature	Detalles
`/stream`	Streaming de cotizaciones en tiempo real con gestión de suscripción
`/stream/swap`	Cotizaciones de swap en vivo con transacciones preconstruidas (listas para firmar), incluido soporte de tip
Updates por slot	Recálculo automático de cotización en cambios de estado de pool
Reenvío por inactividad	`/stream/swap` reenvía la última transacción de swap tras 10 slots sin actualización para ayudar a evitar la expiración

ID del programa - Mainnet: RaptorD5ojtsqDDtJeRsunPLg6GvLYNnwKJWxYE4m87

DEXs soportados

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

Otros

FluxBeam
PancakeSwap V3

Routing

Multi-Hop

Rutas hasta de 4 saltos para mejor pricing
Cálculo de slippage consciente de la ruta (considera riesgo multi-hop)
Preferencias de routing específicas por DEX
Filtrado de pools por listas de direcciones
Allowlists de mints vía archivos txt
Modo solo rutas directas (onlyDirectRoutes / maxHops=1)
Opción de arbitraje circular

Arbitraje

Cotiza con el mismo mint de entrada y salida, por ejemplo SOL a SOL, y Raptor busca un ciclo a través de varios pools que devuelva más de lo que pusiste.

Si routePlan no está vacío, Raptor encontró un ciclo. amountOut menos amount es la ganancia esperada, antes de las comisiones de red y de prioridad. Constrúyelo y envíalo como cualquier otro swap.
Si ningún ciclo es rentable, la respuesta trae routePlan vacío y amountOut igual a amount. No hay nada que construir.
En una instancia autoalojada, arranca el binario con --enable-arbitrage.

Slippage

Slippage dinámico basado en volatilidad y complejidad de la ruta
Ajuste de slippage multi-hop consciente de la ruta
Override manual de slippage (numérico o "dynamic")
Cálculo de cantidad mínima de salida con protección de slippage

Platform Fees

Fee tomada del input O del output
Basis points configurables (hasta 10%)
Especificación de wallet de fees
Cargo extra sobre slippage positivo
Ajuste automático de fees en cotizaciones y swaps

Tips y controles de transacción

Tips opcionales en SOL nativo vía tipAccount y tipLamports
Selección de versión de transacción (V0 o LEGACY)
Override de compute unit price (computeUnitPriceMicroLamports)
Override del compute unit limit (computeUnitLimit)
Topes de priority fee máximo (maxPriorityFee)
Override opcional de cuenta de destino (destinationTokenAccount)

Priority Fees

Cálculo dinámico

Cálculo de priority fee específico de la ruta
Ajustes de fee específicos por DEX
Tracking de datos recientes de fees (slots tracked, total fees)
Caps de fee máximo y overrides

Niveles de prioridad

Nivel	Caso de uso
`Min` / `Low`	Ahorro de costes
`Auto` / `Medium`	Predeterminado recomendado
`High` / `VeryHigh`	Prioridad de velocidad
`Turbo` / `UnsafeMax`	Velocidad máxima

Gestión de transacciones

Yellowstone Jet TPU

Envío de transacciones
Reenvío automático alineado por slot
Soporte multi-identidad (4 por defecto, configurable)

Tracking

Monitorización en tiempo real (pending / confirmed / failed / expired)
Medición de latencia (envío a confirmación)
Eventos parseados del programa Raptor
Almacenamiento de transacción cruda
Limpieza automática

Rate Limiting

RPS configurable (en general usa pocas llamadas RPC)

Autoalojamiento (opcional)

Las secciones siguientes aplican solo si ejecutas el binario de Raptor por tu cuenta. Si usas la API alojada de arriba, puedes ignorar flags CLI y variables de entorno.

Flags de CLI

Ayuda y versión

-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

Filtros de routing

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

Formato del archivo de allowlist

Tanto --include-mints-file como --include-pools-file esperan un archivo de texto plano con un pubkey por línea. Ejemplo:

So11111111111111111111111111111111111111112
EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
# comments are allowed

Las líneas vacías se ignoran
# inicia un comentario
Las allowlists de mints conservan cualquier pool en el que token_a o token_b coincida con un mint listado
Las allowlists de pools conservan solo las direcciones de pool listadas exactamente
Si se usan junto con filtros de DEX, ambos filtros aplican

Rendimiento

--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)

Opciones de solicitud

Campos comunes para construcción de swap soportados por POST /swap, POST /quote-and-swap y suscripciones de /stream/swap:

dexes — allowlist de DEX separada por comas
pools — allowlist de pools separada por comas
maxHops — profundidad máxima de ruta (1-4)
onlyDirectRoutes — forzar solo rutas directas
feeAccount, feeBps, feeFromInput, chargeBps — controles de platform fee
priorityFee, maxPriorityFee — control de priority fee dinámico o fijo
computeUnitPriceMicroLamports, computeUnitLimit — overrides de compute budget
txVersion, asLegacyTransaction — controles de formato de transacción
tipAccount, tipLamports — transferencia opcional de tip en SOL
destinationTokenAccount — cuenta de destino personalizada para el token de salida

Variables de entorno

Equivalentes de flags de CLI

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`

Variables adicionales

Variable	Descripción
`RPC_URL`	Endpoint RPC de Solana
`YELLOWSTONE_ENDPOINT`	Endpoint gRPC de Yellowstone
`YELLOWSTONE_TOKEN`	Token de auth de Yellowstone (opcional)
`BIND_ADDR`	Dirección de bind del servidor (por defecto: `0.0.0.0:8080`)

​Cómo usar Raptor

Guía Swap API

Enviar transacciones

​JIT routing

​Endpoints

​Swap

​Analytics

​WebSocket

​DEXs soportados

​Raydium

​Meteora

​Orca

​Bonding Curves

​PropAMM

​Otros

​Routing

​Multi-Hop

​Arbitraje

​Slippage

​Platform Fees

​Tips y controles de transacción

​Priority Fees

​Cálculo dinámico

​Niveles de prioridad

​Gestión de transacciones

​Yellowstone Jet TPU

​Tracking

​Rate Limiting

​Autoalojamiento (opcional)

​Flags de CLI

​Ayuda y versión

​Pool Indexer

​Filtros de routing

​Formato del archivo de allowlist

​Rendimiento

​Feature toggles

​Yellowstone Jet TPU

​Opciones de solicitud

​Variables de entorno

​Equivalentes de flags de CLI

​Variables adicionales

Cómo usar Raptor

JIT routing

Endpoints

Swap

Analytics

WebSocket

DEXs soportados

Raydium

Meteora

Orca

Bonding Curves

PropAMM

Otros

Routing

Multi-Hop

Arbitraje

Slippage

Platform Fees

Tips y controles de transacción

Priority Fees

Cálculo dinámico

Niveles de prioridad

Gestión de transacciones

Yellowstone Jet TPU

Tracking

Rate Limiting

Autoalojamiento (opcional)

Flags de CLI

Ayuda y versión

Pool Indexer

Filtros de routing

Formato del archivo de allowlist

Rendimiento

Feature toggles

Yellowstone Jet TPU

Opciones de solicitud

Variables de entorno

Equivalentes de flags de CLI

Variables adicionales