OnFinality
Nuevos usuarios de RPC: 35% de descuento el primer mesVer oferta
OnFinality Learn
Integración y desarrollo9 min de lectura

API de Raydium: datos, swaps e integración con Solana RPC

Aprende cómo funcionan conjuntamente en integraciones de producción las API HTTP de Raydium, sus servicios de transacciones, SDK y Solana RPC.

TL;DR

La API de Raydium no es una única interfaz con un único propósito. Raydium documenta servicios HTTP independientes para datos de pools y tokens, construcción de transacciones, funciones de LaunchLab, perps, posiciones de wallets y otras funciones, mientras que Solana RPC proporciona el acceso subyacente a la cadena necesario para inspeccionar cuentas, simular transacciones y enviar transacciones firmadas. Esta guía explica cómo elegir la capa correcta, crear un flujo reproducible de lectura y verificación, y diagnosticar errores sin tratar una respuesta HTTP indexada como la verdad on-chain definitiva. También muestra dónde encaja un proveedor de RPC y cómo medir el comportamiento que realmente necesita tu aplicación.

Alcance y límites de los servicios

Usa la API de Raydium cuando tu aplicación necesite datos específicos de Raydium o un servicio operado por Raydium. Usa Solana JSON-RPC cuando necesites el estado autoritativo de la blockchain o ejecutar operaciones con transacciones. En un swap, por ejemplo, una integración práctica puede obtener información del pool o de la ruta desde Raydium, crear o recibir una transacción mediante el servicio de transacciones o SDK correspondiente y, después, usar RPC para obtener un blockhash reciente, simular, enviar y confirmar la transacción firmada.

El catálogo de servicios documentado por Raydium separa API v3, Transaction API, Perps API, servicios de LaunchLab, Dynamic IPFS, Owner API, la API heredada v1 y servicios temporales. API v3 se describe como la API de lectura canónica para información de pools, mints, configuración y cadena. Transaction API es el punto de entrada del lado del servidor para la construcción de transacciones y el agregador. Trata cada servicio como un contrato independiente, en lugar de asumir que un endpoint de datos de pools también puede construir o enviar un swap.

Antes de implementar, consulta la referencia actual de la API de Raydium para conocer el host, la ruta, los parámetros, los requisitos de autenticación, el envoltorio de respuesta y los límites de solicitudes exactos. Estos detalles pueden cambiar de forma independiente de tu configuración de Solana RPC.

  • API HTTP de Raydium: datos indexados y operaciones de servicio específicos del protocolo.
  • SDK de Raydium o Transaction API: construcción de transacciones e instrucciones.
  • Solana RPC: lecturas de cuentas, simulación, blockhashes, envío y confirmación.
  • Tu aplicación: validación, reintentos, registros, gestión de claves y reglas de negocio.

Modelo mental de la integración

Un modelo útil consiste en dividir el flujo en intención, construcción, ejecución y verificación. La intención describe lo que quiere el usuario, como intercambiar un mint por otro con una restricción de slippage máximo. La construcción convierte esa intención en instrucciones o en una transacción serializada. La ejecución envía la transacción firmada a un endpoint de Solana RPC. La verificación comprueba la firma resultante y las cuentas relevantes on-chain.

La ruta de datos y la ruta de ejecución están relacionadas, pero no son idénticas. Una respuesta de Raydium puede ser práctica para descubrir pools, metadatos de tokens o una ruta, pero la transacción sigue dependiendo del estado actual de Solana, la propiedad de las cuentas, el rent, los límites de cómputo, la validez del blockhash y la liquidez disponible. No asumas que una solicitud HTTP exitosa significa que se ejecutó un swap.

Para productos con muchas lecturas, como los dashboards, usa el servicio de Raydium documentado para el conjunto de datos requerido y almacena en caché las respuestas de acuerdo con las reglas del servicio. Para saldos críticos, liquidaciones o estados de transacciones, contrasta los datos con RPC e identifica el nivel de commitment utilizado en cada lectura.

Requisitos previos y separación de entornos

Prepara configuraciones independientes para desarrollo y producción. La documentación de Raydium distingue hosts de mainnet y devnet para varios servicios, mientras que la URL de Solana RPC también debe apuntar al mismo clúster. Mezclar un servicio de Raydium de devnet con una URL de RPC de mainnet, o al contrario, produce resultados vacíos confusos y cuentas no válidas.

Mantén los secretos fuera de los paquetes del navegador y del control de versiones. Un backend o servicio de firma controlado debe conservar cualquier clave privada, y la aplicación solo debe exponer las operaciones mínimas necesarias para el flujo del usuario. Para experimentos de solo lectura, una URL de RPC y direcciones públicas de mint o de cuentas son suficientes; no se requiere firmar.

Si necesitas un endpoint de Solana gestionado, compara los requisitos operativos del servicio de API de OnFinality, consulta los precios de RPC disponibles y confirma los detalles relevantes de la red de Solana. Elegir un proveedor es una decisión de infraestructura; no sustituye la documentación específica de la API de Raydium.

  • RPC_URL: un endpoint para el clúster de Solana previsto.
  • RAYDIUM_API_BASE: el host documentado de Raydium para el servicio seleccionado.
  • Direcciones públicas de mint, pool o wallet apropiadas para ese clúster.
  • Un ID de solicitud, una marca de tiempo, el nombre del clúster y el estado de la respuesta en los registros de la aplicación.

Base de la API de solo lectura y RPC

Empieza con dos comprobaciones de estado independientes: llama a un endpoint de lectura documentado de Raydium usando su ruta y parámetros actuales y, después, llama directamente a Solana JSON-RPC. La primera confirma que tu aplicación puede acceder al servicio específico del protocolo. La segunda confirma que tu URL de RPC puede responder a solicitudes de la cadena. No ocultes ninguno de los dos errores detrás de un único mensaje genérico de «Raydium no disponible».

La siguiente solicitud JSON-RPC se puede ejecutar con cualquier endpoint de Solana compatible. Solicita el blockhash más reciente y devuelve la respuesta sin afirmar una altura de bloque ni una latencia concretas.

Para las llamadas HTTP de Raydium, copia la ruta exacta de la referencia actual de la API en lugar de codificar un endpoint inferido. Registra la forma completa de la solicitud y el envoltorio de respuesta en una prueba de contrato para detectar un cambio de API antes de que llegue a producción.

curl --fail-with-body --silent --show-error -X POST "$RPC_URL" -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","id":1,"method":"getLatestBlockhash","params":[{"commitment":"confirmed"}]}'

Verificación de cuentas con JavaScript

Después de obtener datos de Raydium, verifica contra Solana los objetos importantes para tu aplicación. Por ejemplo, una dirección de pool debe resolver a una cuenta del clúster esperado, y el propietario de la cuenta debe coincidir con el programa o tipo de cuenta que espera tu integración. La lógica de decodificación exacta depende del programa de Raydium y del diseño de la cuenta; no deduzcas el estado de un pool únicamente a partir de una dirección.

Este ejemplo mínimo de Node.js comprueba la existencia de una cuenta e informa de su propietario, indicador de ejecutable y longitud de datos. No decodifica el estado de Raydium, no firma una transacción ni demuestra que un pool sea seguro de usar. Sustituye ACCOUNT_ADDRESS por una dirección pública del clúster seleccionado.

Usa en producción una versión fijada y revisada de tu biblioteca cliente de Solana. El ejemplo utiliza una variable de entorno para el endpoint, de modo que el mismo código de verificación pueda ejecutarse en desarrollo, staging y producción.

import { Connection, PublicKey } from "@solana/web3.js";

const rpcUrl = process.env.RPC_URL;
const address = process.env.ACCOUNT_ADDRESS;
if (!rpcUrl || !address) throw new Error("Set RPC_URL and ACCOUNT_ADDRESS");

const connection = new Connection(rpcUrl, "confirmed");
const publicKey = new PublicKey(address);
const account = await connection.getAccountInfo(publicKey, "confirmed");

if (!account) {
  console.log(JSON.stringify({ exists: false, address }));
  process.exit(0);
}

console.log(JSON.stringify({
  exists: true,
  address,
  owner: account.owner.toBase58(),
  executable: account.executable,
  lamports: account.lamports,
  dataBytes: account.data.length
}));

Construcción de swaps y ejecución de transacciones

Una integración de swaps normalmente tiene más componentes que una consulta de precios. Debes identificar los mints de entrada y salida, elegir una ruta o un pool, calcular el slippage aceptable, crear o validar las cuentas de tokens, construir las instrucciones, obtener un blockhash reciente, firmar, simular cuando corresponda, enviar y confirmar. El SDK de Raydium y Transaction API pueden reducir la cantidad de ensamblaje de instrucciones que debes escribir, pero tu aplicación sigue siendo responsable de validar la transacción devuelta y hacer cumplir la intención del usuario.

Mantén separada la firma del descubrimiento de rutas. Un backend puede solicitar una cotización o una carga útil de transacción, pero una wallet o un firmante controlado debe mostrar y autorizar la transacción. Nunca aceptes una transacción serializada arbitraria de una fuente no fiable sin inspeccionar sus cuentas, programas, importes y destino previsto.

Usa la simulación de RPC antes del envío cuando el flujo de trabajo y el modelo de wallet lo permitan. La simulación puede revelar cuentas faltantes, fondos insuficientes, datos de instrucciones no válidos, agotamiento de cómputo y otros errores de ejecución. Es una señal de diagnóstico, no una garantía: el estado puede cambiar entre la simulación y la inclusión.

Para cargas de trabajo de gran volumen o sensibles a la latencia, evalúa si un endpoint compartido es suficiente. Las opciones de nodos dedicados pueden ser relevantes cuando importan el aislamiento, una capacidad predecible o el control operativo, pero mide tu carga de trabajo antes de cambiar la arquitectura.

  • Valida las direcciones de los mints y los decimales de los tokens a partir de datos fiables.
  • Aplica una política de slippage máximo y de salida mínima antes de firmar.
  • Usa un blockhash reciente y gestiona explícitamente su expiración.
  • Persiste la firma e inspecciona on-chain el resultado final de la transacción.

Mediciones reproducibles de latencia y coherencia

Mide la ruta completa en lugar de citar una velocidad de API sin contexto. Separa la configuración de DNS y de la conexión del tiempo de solicitud, el tiempo de respuesta HTTP de Raydium del tiempo de respuesta de RPC y el acuse de recibo del envío de la confirmación de la transacción. Ejecuta el mismo conjunto de solicitudes contra el mismo clúster, región, versión de software y nivel de concurrencia.

Una tabla de resultados útil debe completarse con datos de tu propia ejecución. Captura las marcas de tiempo con un reloj monótono, registra el estado HTTP o el error JSON-RPC y anota el nivel de commitment. Repite cada caso las veces suficientes para calcular una distribución, en lugar de basarte en una única solicitud exitosa.

Usa una tabla como la siguiente y deja los valores en blanco hasta haberlos medido:

Caso de pruebaEndpoint o métodoIntentosÉxitosp50p95ErroresNotas
Solicitud de lectura de RaydiumRuta de API documentada
Lectura de cuenta RPCgetAccountInfo
Simulación RPCsimulateTransaction
Envío de transacciónsendTransaction
ConfirmacióngetSignatureStatuses o equivalente

Interpreta los resultados con cuidado. Una respuesta rápida de Raydium no demuestra una finalización rápida de la transacción, y una respuesta rápida de sendTransaction normalmente significa que el nodo aceptó la solicitud, no que la transacción se haya finalizado. Informa del nivel de commitment y del periodo de observación en cada comparación de producción.

Modos de fallo y diagnóstico

Un resultado vacío de pool o token puede indicar el clúster incorrecto, un formato de mint incorrecto, un endpoint no compatible, una indexación obsoleta o que el objeto realmente no existe. Primero muestra el host de Raydium seleccionado, el clúster de RPC, la ruta de solicitud, el código de estado y el envoltorio de respuesta. Después consulta la dirección pública relevante mediante RPC y compara el clúster y la existencia de la cuenta.

Una transacción que falla durante la simulación debe diagnosticarse a partir de los registros devueltos y del estado de las cuentas, no reintentarse a ciegas. Entre las categorías habituales se incluyen SOL insuficiente para comisiones o rent, cuentas de tokens asociadas faltantes, incompatibilidad con el programa de tokens, blockhashes obsoletos, cuentas de ruta no válidas, límites de slippage y restricciones de presupuesto de cómputo. Un reintento solo es apropiado cuando el error se clasifica como transitorio y la transacción se reconstruye con el estado actual.

Las respuestas HTTP 429, los tiempos de espera agotados y los reinicios de conexión requieren backoff acotado con jitter, cancelación de solicitudes y observabilidad. No multipliques indefinidamente el tráfico durante una interrupción. Almacena en caché los metadatos inmutables o que cambien lentamente cuando esté permitido, pero no almacenes en caché saldos ni valores sensibles a la ruta más allá del periodo que acepte tu modelo de riesgo.

Cuando Raydium y RPC no coincidan, registra ambas marcas de tiempo y niveles de commitment. Los servicios indexados pueden ofrecer una vista útil para la aplicación mientras la cadena avanza, y los nodos RPC pueden diferir en actualidad. Vuelve a leer con un commitment más fuerte cuando la operación de negocio lo requiera, teniendo en cuenta que un commitment más fuerte puede aumentar el tiempo de respuesta.

Ventajas, limitaciones y compromisos

Las API HTTP operadas por Raydium son prácticas porque presentan conceptos específicos del protocolo, como pools, rutas y datos de LaunchLab. Su limitación es la dependencia del servicio: la disponibilidad, los límites de solicitudes, los esquemas de respuesta y el comportamiento de indexación son independientes de la capa de consenso de Solana. El RPC directo está más cerca de la verdad de la cadena, pero los datos de cuentas sin procesar suelen requerir conocimiento del programa, decodificación binaria, paginación y más código de aplicación.

El SDK y Transaction API pueden acelerar la integración, pero la abstracción no elimina el riesgo del protocolo. Revisa las instrucciones generadas, el tamaño de la transacción, los requisitos de cómputo, los programas de tokens, el comportamiento de las comisiones y la gestión del slippage. Si necesitas operaciones históricas, OHLCV o analítica de muchos programas, un servicio de datos indexados diseñado para ese fin puede ser más adecuado que escanear repetidamente respuestas RPC sin procesar.

No uses ejemplos públicos como prueba de que un endpoint, una ruta, una comisión o el comportamiento de un programa sean permanentes. Fija las dependencias, supervisa la documentación de la API, prueba en devnet cuando el servicio correspondiente lo admita y mantén un modo alternativo o de lectura degradada para las funciones no críticas.

Lista de comprobación para producción y próximos pasos

Una integración fiable de Raydium hace explícita la frontera entre la comodidad off-chain y la autoridad on-chain. Documenta qué campos proceden de Raydium, qué valores se verifican de forma independiente mediante RPC y qué acción autoriza el usuario. Incluye el clúster, el commitment, la antigüedad del blockhash, la firma y los registros de errores en tu registro operativo.

Después, crea una prueba de contrato pequeña que ejecute una solicitud de lectura documentada de Raydium y una lectura de cuenta de Solana. Añade una prueba de simulación para una transacción representativa en el clúster de desarrollo apropiado y, después, ejecuta el procedimiento de medición con una concurrencia realista. Si tu aplicación necesita una orientación más amplia sobre la selección de endpoints, consulta la guía de endpoints RPC y la guía sobre el mejor proveedor de RPC de Solana desde la perspectiva de la selección de proveedores.

El resultado debe ser un diseño por capas: servicios de Raydium para el descubrimiento y la construcción específicos de Raydium, Solana RPC para la ejecución y la verificación, y controles a nivel de aplicación para la seguridad, los reintentos, la coherencia y la protección del usuario.

  • Confirma cada host y ruta en la documentación actual de Raydium.
  • Mantén aislados mainnet, devnet y las credenciales.
  • Verifica mediante RPC las cuentas importantes y los resultados de las transacciones.
  • Mide por tu cuenta p50, p95, errores, actualidad y comportamiento de confirmación.
  • Revisa los límites de solicitudes, los cambios de esquema y las actualizaciones del SDK como parte de la gestión de versiones.

Nunca te preocupes por la infraestructura nuevamente

OnFinality elimina la carga pesada de DevOps para que puedas construir de forma más inteligente y rápida.

Comenzar