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

# Referência de Streams Analisados

> Referência da API para métodos Parsed Streams JSON-RPC via WebSocket. Assine transações Solana decodificadas com filtragem do lado do servidor.

<Note>
  Parsed Streams está em **beta fechado**. O acesso está limitado a ids de projeto na lista de permissões por enquanto, e a API pode mudar antes da disponibilidade geral. Para participar do beta fechado, [inscreva-se aqui](https://form.typeform.com/to/BlFWKbC9).
</Note>

Parsed Streams usa **JSON-RPC 2.0** sobre uma única conexão WebSocket. Cada solicitação recebe uma resposta com o mesmo `id`. Uma assinatura então envia mensagens `parsedTransactionNotification` até você cancelar a assinatura ou desconectar.

| Método                         | Finalidade                                                    |
| ------------------------------ | ------------------------------------------------------------- |
| `parsedTransactionSubscribe`   | Iniciar uma assinatura com um filtro                          |
| `parsedTransactionUnsubscribe` | Parar uma assinatura                                          |
| `ping`                         | Verificação de atividade; retorna o slot atual                |
| `describeProgram`              | Lista as instruções, eventos e papéis de conta de um programa |

<CardGroup cols={2}>
  <Card title="parsedTransactionSubscribe" href="/docs/pt-BR/api-reference/parsed-streams/parsedtransactionsubscribe">
    Inscreva-se em transações decodificadas que correspondem a um programa, conta e filtro de instrução.
  </Card>

  <Card title="parsedTransactionUnsubscribe" href="/docs/pt-BR/api-reference/parsed-streams/parsedtransactionunsubscribe">
    Pare uma assinatura por seu id.
  </Card>

  <Card title="ping" href="/docs/pt-BR/api-reference/parsed-streams/ping">
    Verifique a atividade e mantenha uma conexão silenciosa viva.
  </Card>

  <Card title="describeProgram" href="/docs/pt-BR/api-reference/parsed-streams/describeprogram">
    Descubra os nomes exatos de instruções e papéis que o comparador utiliza.
  </Card>
</CardGroup>

## Conexão

A equipe Helius adiciona seu id de projeto à lista de permissões e compartilha o ponto de conexão com você. Autentique com a chave de API do seu projeto, passada como o `api-key` parâmetro de consulta (ou no cabeçalho `x-api-key`):

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

Uma chave ausente, inválida ou que não esteja na lista de permissões é rejeitada com HTTP 401. Um projeto no seu limite de conexões recebe HTTP 429.

## Limites

| Limite                           | Valor                                        |
| -------------------------------- | -------------------------------------------- |
| Conexões simultâneas por projeto | 100                                          |
| Assinaturas por conexão          | 25                                           |
| Mensagens do cliente             | 10 por segundo, com pico de 20               |
| Tamanho da mensagem do cliente   | 64 KiB                                       |
| `programs` por filtro            | 10                                           |
| `instructionNames` por filtro    | 50, cada um com até 64 caracteres            |
| `accounts.include` por filtro    | 100                                          |
| `accounts.roles` por filtro      | 20, cada nome com até 64 caracteres          |
| Buffer de saída por conexão      | 2048 notificações, então a conexão é fechada |

## Erros

Os erros seguem JSON-RPC 2.0: `{ "error": { "code": <int>, "message": "<text>" }, "id": <id> }`. As mensagens explicam exatamente o que estava errado e onde.

| Código   | Significado                                                                                                   |
| -------- | ------------------------------------------------------------------------------------------------------------- |
| `-32700` | Erro de análise (JSON inválido)                                                                               |
| `-32600` | Solicitação inválida                                                                                          |
| `-32601` | Método não encontrado                                                                                         |
| `-32602` | Params inválidos: chave pública incorreta, campo desconhecido, valor de compromisso ou detalhes não suportado |
| `-32000` | Limite do filtro excedido                                                                                     |
| `-32001` | Servidor não pronto; tente novamente com backoff                                                              |
| `-32002` | Limite de taxa (10 mensagens por segundo)                                                                     |
| `-32006` | Muitas assinaturas (25 por conexão)                                                                           |

As conexões também podem ser fechadas com um código de fechamento WebSocket — veja [Lidando com Reconexões](/docs/pt-BR/parsed-streams/guides/handling-reconnects) para o que cada um significa e como se recuperar.

## Saiba mais

<CardGroup cols={2}>
  <Card title="Visão Geral dos Streams Analisados" href="/docs/pt-BR/parsed-streams">
    O que é Parsed Streams e o modelo mental por trás dos filtros.
  </Card>

  <Card title="Início Rápido" href="/docs/pt-BR/parsed-streams/quickstart">
    Conecte, envie seu primeiro filtro e leia uma notificação decodificada.
  </Card>

  <Card title="Referência de Eventos Analisados" href="/docs/pt-BR/api-reference/parsed-events/overview">
    Consulte as mesmas transações decodificadas sob demanda via REST ou GraphQL.
  </Card>

  <Card title="Lidando com Reconexões" href="/docs/pt-BR/parsed-streams/guides/handling-reconnects">
    Supere tempos de inatividade e implantações, em seguida, recupere exatamente o que você perdeu.
  </Card>
</CardGroup>