> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
> Use this file to discover all available pages before exploring further.

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

<Info>
  **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 →](/api-reference/index)
</Info>

<Info>
  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](#autenticación) antes de enviar solicitudes que requieran una firma de wallet.
</Info>

## 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](/es/api-reference/api-v3/overview)                           | `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](/es/api-reference/route-api-v2/overview)            | `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](/es/api-reference/perp-api-v1/overview)                   | `api-perp-v1.raydium.io`       | —                                     | Configuración, metadatos de activos, selección de RPC para la interfaz frontal de Raydium Perps.                                                               |
| [LaunchLab Mint API](/es/api-reference/launch-mint-v1/overview)       | `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](/es/api-reference/launch-history-v1/overview) | `launch-history-v1.raydium.io` | `launch-history-v1-devnet.raydium.io` | Historial de transacciones, agregados K-line para pools de LaunchLab.                                                                                          |
| [LaunchLab Forum API](/es/api-reference/launch-forum-v1/overview)     | `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](/es/api-reference/launch-auth-v1/overview)       | `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](/es/api-reference/dynamic-ipfs-v1/overview)        | `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](/es/api-reference/owner-api-v1/overview)                  | `owner-v1.raydium.io`          | `owner-v1-devnet.raydium.io`          | Posiciones por wallet, saldos, recompensas reclamables.                                                                                                        |
| [API v1](/es/api-reference/api-v1/overview)                           | `api.raydium.io`               | —                                     | Endpoints heredados v1/v2, mantenidos activos para clientes que no han migrado a API v3.                                                                       |
| [Temp API](/es/api-reference/temp-api-v1/overview)                    | `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:

```json theme={null}
{
  "id": "uuid-v4-per-request",
  "success": true,
  "data": { ... }
}
```

En caso de fallo:

```json theme={null}
{
  "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`](/es/sdk-api/typescript-sdk).

## Referencias

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