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

# Referencia de Parsed Streams

> Referencia de la API para los métodos JSON-RPC de Parsed Streams mediante WebSocket. Suscríbete a transacciones decodificadas de Solana con filtrado del lado del servidor.

<Note>
  Parsed Streams está en **beta abierta**. Está disponible en los planes de pago. Autentícate con la clave de API de tu proyecto. La API aún puede cambiar antes de su disponibilidad general.
</Note>

Parsed Streams usa **JSON-RPC 2.0** mediante una única conexión WebSocket. Cada solicitud recibe una respuesta con el mismo `id`. Luego, una suscripción envía mensajes `parsedTransactionNotification` hasta que canceles la suscripción o te desconectes.

| Método                         | Propósito                                                                   |
| ------------------------------ | --------------------------------------------------------------------------- |
| `parsedTransactionSubscribe`   | Iniciar una suscripción con un filtro                                       |
| `parsedTransactionUnsubscribe` | Detener una suscripción                                                     |
| `ping`                         | Comprobar la disponibilidad; devuelve el slot actual                        |
| `describeProgram`              | Mostrar las instrucciones, los eventos y los roles de cuenta de un programa |

<CardGroup cols={2}>
  <Card title="parsedTransactionSubscribe" href="/docs/es/api-reference/parsed-streams/parsedtransactionsubscribe">
    Suscríbete a transacciones decodificadas que coincidan con un filtro de programa, cuenta e instrucción.
  </Card>

  <Card title="parsedTransactionUnsubscribe" href="/docs/es/api-reference/parsed-streams/parsedtransactionunsubscribe">
    Detén una suscripción mediante su identificador.
  </Card>

  <Card title="ping" href="/docs/es/api-reference/parsed-streams/ping">
    Comprueba la disponibilidad y mantén activa una conexión inactiva.
  </Card>

  <Card title="describeProgram" href="/docs/es/api-reference/parsed-streams/describeprogram">
    Descubre los nombres exactos de las instrucciones y los roles con los que compara el buscador de coincidencias.
  </Card>
</CardGroup>

## Conexión

Obtén tu clave de API y el endpoint de conexión en el [panel de Helius](https://dashboard.helius.dev). Autentícate con la clave de API de tu proyecto, enviada como parámetro de consulta `api-key` (o como encabezado `x-api-key`):

```bash wscat theme={"system"}
wscat -c "wss://<ENDPOINT>/?api-key=YOUR_API_KEY"
```

Si la clave falta o no es válida, la solicitud se rechaza con HTTP 401. Si un proyecto alcanza su límite de conexiones, recibe HTTP 429.

## Límites

| Límite                              | Valor                                              |
| ----------------------------------- | -------------------------------------------------- |
| Conexiones simultáneas por proyecto | 100                                                |
| Suscripciones por conexión          | 25                                                 |
| Mensajes del cliente                | 10 por segundo, con una ráfaga de 20               |
| Tamaño de los mensajes del cliente  | 64 KiB                                             |
| `programs` por filtro               | 10                                                 |
| `instructionNames` por filtro       | 50, cada uno de hasta 64 caracteres                |
| `accounts.include` por filtro       | 100                                                |
| `accounts.roles` por filtro         | 20, cada nombre de hasta 64 caracteres             |
| Búfer de salida por conexión        | 2048 notificaciones; después se cierra la conexión |

## Errores

Los errores siguen JSON-RPC 2.0: `{ "error": { "code": <int>, "message": "<text>" }, "id": <id> }`. Los mensajes indican exactamente qué estaba mal y dónde.

| Código   | Significado                                                                                                         |
| -------- | ------------------------------------------------------------------------------------------------------------------- |
| `-32700` | Error de análisis (JSON no válido)                                                                                  |
| `-32600` | Solicitud no válida                                                                                                 |
| `-32601` | Método no encontrado                                                                                                |
| `-32602` | Parámetros no válidos: clave pública incorrecta, campo desconocido o valor de confirmación o detalles no compatible |
| `-32000` | Se superó el límite del filtro                                                                                      |
| `-32001` | El servidor no está listo; vuelve a intentarlo con espera exponencial                                               |
| `-32002` | Límite de frecuencia alcanzado (10 mensajes por segundo)                                                            |
| `-32006` | Demasiadas suscripciones (25 por conexión)                                                                          |

Las conexiones también pueden cerrarse con un código de cierre de WebSocket. Consulta [Gestión de reconexiones](/docs/es/parsed-streams/guides/handling-reconnects) para saber qué significa cada código y cómo recuperarte.

## Más información

<CardGroup cols={2}>
  <Card title="Parsed Streams Overview" href="/docs/es/parsed-streams">
    Qué es Parsed Streams y el modelo mental en el que se basan los filtros.
  </Card>

  <Card title="Quickstart" href="/docs/es/parsed-streams/quickstart">
    Conéctate, envía tu primer filtro y lee una notificación decodificada.
  </Card>

  <Card title="Parsed Events Reference" href="/docs/es/api-reference/parsed-events/overview">
    Consulta bajo demanda las mismas transacciones decodificadas mediante REST o GraphQL.
  </Card>

  <Card title="Handling Reconnects" href="/docs/es/parsed-streams/guides/handling-reconnects">
    Supera los tiempos de espera por inactividad y las implementaciones, y luego recupera exactamente lo que te perdiste.
  </Card>
</CardGroup>