Referencia de API

Catálogo de todas las API HTTP operadas por Raydium: datos de pools, construcción de transacciones, perps, servicios de foro LaunchLab / mint / historial / autenticación, puerta de enlace IPFS, posiciones de propietario, y la API Python heredada. Los endpoints que se enumeran a continuación se abren en un área de prueba interactiva.

Esta página fue traducida automáticamente por IA. La versión en inglés es la fuente autorizada.

Ver versión en inglés →

Todo endpoint en este sitio tiene un panel Pruébalo impulsado por el área de pruebas OpenAPI de Mintlify. El área de pruebas se ejecuta en tu navegador e impacta directamente los hosts de producción en vivo (o devnet). Lee Autenticación antes de enviar solicitudes que requieran una firma de wallet.

​

Catálogo de servicios

Raydium opera once servicios HTTP públicos. Cada uno está documentado como su propio grupo en el árbol de navegación a la izquierda.

Servicio	Host Mainnet	Host Devnet	Qué hace
API v3	api-v3.raydium.io	api-v3-devnet.raydium.io	Pool / mint / config / chain-info — la API de lectura canónica en la que se basan la UI y el SDK.
Transaction API	transaction-v1.raydium.io	transaction-v1-devnet.raydium.io	Construcción de transacciones de swap / liquidez del lado del servidor. El punto de entrada del agregador.
Perps API	api-perp-v1.raydium.io	—	Configuración, metadatos de activos, selección de RPC para la interfaz frontal de Raydium Perps.
LaunchLab Mint API	launch-mint-v1.raydium.io	launch-mint-v1-devnet.raydium.io	Búsqueda de tokens, índices, tablas de clasificación, metadatos por mint para lanzamientos de LaunchLab.
LaunchLab History API	launch-history-v1.raydium.io	launch-history-v1-devnet.raydium.io	Historial de transacciones, agregados K-line para pools de LaunchLab.
LaunchLab Forum API	launch-forum-v1.raydium.io	launch-forum-v1-devnet.raydium.io	Comentarios, hilos, cargas IPFS asociadas a un lanzamiento de LaunchLab. Firmado con wallet.
LaunchLab Auth API	launch-auth-v1.raydium.io	launch-auth-v1-devnet.raydium.io	Emite JWTs ray-token de corta duración a partir de un mensaje firmado con wallet. Requerido para llamar a la API del foro.
Dynamic IPFS API	dynamic-ipfs.raydium.io	dynamic-ipfs-devnet.raydium.io	Regenerador de imagen / metadatos NFT. Impulsa el arte de posiciones CLMM y otros NFT en cadena cuya apariencia depende del estado dinámico.
Owner API	owner-v1.raydium.io	owner-v1-devnet.raydium.io	Posiciones por wallet, saldos, recompensas reclamables.
API v1	api.raydium.io	—	Endpoints heredados v1/v2, mantenidos activos para clientes que no han migrado a API v3.
Temp API	temp-api-v1.raydium.io	temp-api-v1-devnet.raydium.io	Área de espera para endpoints personalizados de corta duración. Actualmente expone resúmenes de tarifas de creador de CPMM. Sujeto a cambios sin previo aviso.

​

Autenticación

La mayoría de los servicios son de solo lectura y aceptan solicitudes anónimas. Aparecen dos patrones:

• Apretón de manos firmado con wallet — requerido por launch-auth-v1 para acuñar un ray-token, luego llevado como encabezado ray-token por launch-forum-v1. Firma un mensaje ed25519 de Solana de la forma time:<unix-seconds> con tu wallet, envía la firma + dirección de wallet a launch-auth-v1 /request-token, recibe un JWT de vuelta, y pásalo como encabezado de solicitud ray-token en llamadas posteriores al foro.
• Sin autenticación — todos los demás servicios. Los llamadores de confianza (la UI de Raydium, integradores) impactan los endpoints directamente sobre HTTPS.

El área de pruebas de Mintlify te permite pegar un ray-token en el panel de autenticación antes de enviar solicitudes del foro; el valor se mantiene solo en tu navegador.

​

Límites de velocidad

Todos los hosts están detrás de Cloudflare con límites de velocidad progresivos por IP de origen.

Los integradores que necesitan límites más altos deben contactar al equipo de Raydium. Los picos por encima de los límites publicados se devuelven como HTTP 429 con un encabezado Retry-After.

​

Envoltorio de respuesta

La mayoría de los servicios envuelven sus cargas JSON en un sobre uniforme:

{
  "id": "uuid-v4-per-request",
  "success": true,
  "data": { ... }
}

En caso de fallo:

{
  "id": "uuid-v4-per-request",
  "success": false,
  "msg": "human-readable error string",
  "data": null
}

api-v3 devuelve el sobre como { "id", "success", "data" }. Los servicios pump-* utilizan ayudantes addBorderSuccess / addBorderErr que producen la misma forma con msg rellenado solo en errores. Consulta la página de introducción de cada servicio para el envoltorio exacto que utiliza.

​

Cómo usar esta sección

Haz clic en cualquier endpoint en la navegación izquierda. Verás:

• El método HTTP, URL completa, y host base.
• Parámetros de solicitud con tipos extraídos de la especificación OpenAPI.
• Un panel Pruébalo que te permite establecer parámetros y enviar una solicitud real a mainnet (o selecciona un servidor devnet del menú desplegable cuando esté disponible).
• La forma de la respuesta, originada en una respuesta en vivo representativa y el sitio del callsite addBorderSuccess del código fuente.

Para acceso a nivel SDK — construir transacciones del lado del cliente, lotes de swaps, los tipos de TypeScript — consulta sdk-api/typescript-sdk.

​

Referencias

• sdk-api/rest-api — descripción general narrativa de la superficie REST, escrita para integradores que comienzan por primera vez.
• integration-guides/aggregator — cómo usar Transaction API junto con pools en cadena.
• reference/program-addresses — todo ID de programa devuelto por api-v3 se resuelve a uno de estos.