pnclENGINEObter acesso à API

CAPACIDADE WEBSOCKET

Capacidade da API WebSocket da Pinnacle: frames brutos, não polls.

O dimensionamento da API REST da Pinnacle parte de um intervalo de polling e de um orçamento por segundo. Um stream WebSocket bruto remove os dois e os substitui por um fluxo de frames, um orçamento de reconexão e uma cópia do estado de mercado que só o seu cliente mantém. O planejamento de capacidade continua importando; ele só mede coisas diferentes.

O que a API WebSocket da Pinnacle muda

No REST, a atualidade é uma agenda que você projeta. Cada atualização é uma requisição, e requisições são o que os planos medem: 10 por segundo no Core 10 a US$ 99 por mês, 30 por segundo no Core 30 a US$ 229 por mês. Toda a questão de capacidade se reduz a intervalo vezes escopo, medido contra esse teto.

Um stream WebSocket bruto inverte o modelo. Depois que o socket está aberto e inscrito, os frames chegam conforme os preços se movem: não há intervalo de polling para ajustar nem orçamento por segundo para defender no próprio stream. O que chega não é um alerta processado, mas o fluxo bruto de frames, e aplicar esses frames em um quadro coerente de cada evento e mercado que você acompanha é trabalho do seu código. A API deixa de ser um serviço de consulta e vira um feed do qual você mantém uma réplica.

As questões de capacidade que permanecem

Taxa de frames no pico. O tráfego médio é calmo; uma rodada completa de sábado ou um favorito ao vivo não são. Dimensione parsing, CPU e filas a jusante para o minuto mais movimentado que você pretende acompanhar, não para a média diária, porque os frames entram em fila do seu lado do socket no momento em que seu consumidor fica para trás.

Custo de reconexão e ressincronização. Sockets caem. A recuperação significa reinscrever-se e reconstruir o estado a partir do snapshot novo que o socket envia no início de cada conexão. Esse snapshot chega pelo socket, não pelo seu orçamento REST, mas um quadro grande vem em vários blocos, então reconstruir leva tempo real de parsing exatamente no momento em que você está mais ocupado.

Armazenamento de estado. Cada worker que consome o stream mantém sua própria cópia dos mercados que acompanha. Decida o que vive em memória, o que você persiste para reinícios mais rápidos e quanta RAM uma rodada completa de mercados custa antes de se inscrever em uma.

Frames brutos vs alertas SSE

SSE e WebSocket bruto são ambos push, mas empurram coisas diferentes. Alertas de queda via SSE são processados: o lado do feed já decidiu o que mudou e se o movimento ultrapassa um limite, e seu código reage a uma notificação. Frames de WebSocket bruto não são processados: você calcula as mudanças, os limites e o significado por conta própria.

Essa divisão corresponde a dois tipos de consumidor. Se seu produto reage a movimentos, o SSE encaixa: Alertas de queda a US$ 99 por mês, ou Core 10 + alertas a US$ 149 por mês quando você também precisa de 10 requisições por segundo de REST. Se seu produto é dono do estado, uma tela de precificação, um backend de trading, qualquer coisa que renderize o livro em vez de reportar eventos, frames brutos são a entrada certa. O complemento custa US$ 99 a cada 30 dias e é elegível no Core 10, Core 10 + alertas e Core 30; não está disponível em Alertas de queda nem na chave gratuita.

Comparar planos e complementos

Quando ficar no REST

Se suas leituras são simples e seu volume é baixo, o REST é a ferramenta melhor. Um punhado de eventos, atualidade em nível de minuto, um job acionado por cron: as 20 requisições por minuto e 100 requisições por dia da chave gratuita podem cobrir a avaliação, e o Core 10 cobre a maioria dos dashboards de produção, sem nada para manter entre as chamadas. O guia de planejamento de capacidade mostra como transformar esportes, mercados e intervalos na taxa de requisições que você precisa.

O WebSocket justifica seu complemento quando você de fato é dono do estado ao vivo: percepção abaixo de um segundo em uma rodada relevante, muitos mercados por evento, um produto que renderiza o livro continuamente. Nesse ponto o complemento de US$ 99 a cada 30 dias no Core 10 e acima substitui a matemática de intervalo de polling pela matemática de taxa de frames, e a comparação de planos mostra os níveis elegíveis lado a lado.

Ver planos de capacidade