Una conexión, muchos topics
Un único stream de SharpAPI puede cubrir todo lo que necesitas — múltiples deportes, múltiples ligas, múltiples casas de apuestas, múltiples eventos, y odds + cada tipo de oportunidad — en un solo socket. Casi nunca necesitas abrir un stream por cada filtro.
El límite de streams concurrentes por key es 1 por defecto en cada nivel de pago, con desplazamiento newer-wins: una segunda conexión desde la misma key expulsa a la anterior. Esta página muestra los patrones que hacen que una sola conexión sea suficiente. Si realmente necesitas sockets paralelos (múltiples procesos / máquinas), consulta Flota y multiproceso más abajo.
Por qué una conexión es suficienteEnlace permanente a esta sección
Cada filtro de identidad en el endpoint del stream acepta una lista separada por comas, y el parámetro channel (all) fusiona los eventos de odds y oportunidades en el mismo flujo de eventos. El servidor preserializa cada ciclo una vez y aplica tus filtros por conexión, por lo que los filtros amplios son baratos — no hay penalización de eficiencia por suscribirse a “todo lo que te interesa” en un solo socket frente a dividirlo.
| Filtro | Valor único | Múltiples valores |
|---|---|---|
sport | sport=basketball | sport=basketball,football,ice_hockey |
league | league=nba | league=nba,nfl,mlb,nhl |
sportsbook | sportsbook=draftkings | sportsbook=draftkings,fanduel,pinnacle |
market | market=moneyline | market=moneyline,point_spread,total_points |
event_id | event_id=evt_abc | event_id=evt_abc,evt_def,evt_ghi |
channel (SSE) | channel=odds | channel=all (odds + oportunidades), channel=all,low_hold (también low-hold) |
channels (WS) | channels=ev | channels=ev,odds,arbitrage,middles,low_hold |
PatronesEnlace permanente a esta sección
Multideporte: NBA + NFL + MLB en un solo socketEnlace permanente a esta sección
En lugar de abrir tres streams, pasa las tres ligas a uno solo:
JavaScript
const rows = new Map(); // id -> full odds row
const es = new EventSource(
'https://api.sharpapi.io/api/v1/stream' +
'?channel=all' +
'&league=nba,nfl,mlb' +
'&api_key=YOUR_KEY'
);
// channel=all never resumes, so every connect is followed by a full snapshot: start empty
es.addEventListener('connected', () => rows.clear());
// Snapshot rows are full Odds objects (league included): store them by id.
// Opportunity chunks carry ev / arbitrage / middles instead of odds.
es.addEventListener('snapshot', (e) => {
for (const o of JSON.parse(e.data).odds ?? []) rows.set(o.id, o);
});
es.addEventListener('odds:update', (e) => {
const { odds, book } = JSON.parse(e.data);
for (const o of odds) {
// A delta row carries id + price fields only: merge it into the stored row, then read league off that
let row = rows.get(o.id);
if (row) Object.assign(row, o);
// A line that opened after your snapshot arrives as a full row
else if (o.sportsbook !== undefined) rows.set(o.id, (row = o));
else continue; // a delta for a row you never stored has no league to route by
routeByLeague(row);
}
});Odds + cada tipo de oportunidad en un solo socketEnlace permanente a esta sección
Establece channel=all,low_hold (SSE) o incluye cada tipo de oportunidad, también low_hold, en channels= (WS):
SSE
const es = new EventSource(
'https://api.sharpapi.io/api/v1/stream?channel=all,low_hold&api_key=YOUR_KEY'
);
es.addEventListener('odds:update', handleOddsDelta);
es.addEventListener('ev:detected', handleEV);
es.addEventListener('arb:detected', handleArb);
es.addEventListener('middles:detected', handleMiddle);
es.addEventListener('low_hold:detected', handleLowHold);
// Each `:detected` payload is an envelope, not a bare array — in your handlers:
// const { opportunities, count, type } = JSON.parse(e.data);El servidor etiqueta cada mensaje con su tipo de evento — tu handler despacha por nombre de evento, exactamente como si hubieras abierto cinco streams separados.
Seguimiento de N eventos específicosEnlace permanente a esta sección
Si quieres actualizaciones precisas sobre una lista fija de eventos (p. ej. diez partidos esta noche), pásalos todos a event_id=:
const eventIds = [
'nba_lal_bos_2026-04-30', 'nba_phx_dal_2026-04-30',
'nfl_kc_buf_2026-05-01', /* ... */
].join(',');
const es = new EventSource(
`https://api.sharpapi.io/api/v1/stream?channel=all&event_id=${eventIds}&api_key=YOUR_KEY`
);Esto reemplaza el patrón de abrir un socket /stream/events/{eventId} por evento.
Divisiones por casa de apuestas o por mercadoEnlace permanente a esta sección
La misma idea se aplica a casas de apuestas y mercados:
// Track Pinnacle sharp moves + DK/FD live prices, moneyline + spreads only:
const es = new EventSource(
'https://api.sharpapi.io/api/v1/stream' +
'?channel=odds' +
'&sportsbook=pinnacle,draftkings,fanduel' +
'&market=moneyline,point_spread' +
'&api_key=YOUR_KEY'
);Resuscripción dinámica (WebSocket)Enlace permanente a esta sección
El control bidireccional de WebSocket te permite cambiar filtros a mitad de conexión sin cerrar el socket. Úsalo cuando tu conjunto de topics “interesantes” cambie a lo largo del día (p. ej. el usuario abre / cierra vistas en un dashboard):
const ws = new WebSocket('wss://ws.sharpapi.io?api_key=YOUR_KEY');
// Initial subscription
ws.onopen = () => ws.send(JSON.stringify({
type: 'subscribe',
channels: ['odds', 'ev'],
filters: { sport: ['basketball'], league: ['nba'] },
}));
// Later — user adds NFL to their dashboard
function addNFL() {
ws.send(JSON.stringify({
type: 'subscribe',
filters: { sport: ['basketball', 'football'], league: ['nba', 'nfl'] },
}));
}Consulta la Referencia de la API WebSocket para el esquema completo del mensaje subscribe.
Flota y multiprocesoEnlace permanente a esta sección
El único caso en el que una sola conexión realmente no funciona: procesos o máquinas separadas que no pueden compartir un socket. Ejemplos:
- Diez bots de trading ejecutándose en diez servidores, cada uno necesitando su propio feed en vivo.
- Pool de workers donde N workers consumen un stream cada uno de forma independiente.
- Servicio backend + dashboard del navegador, ambos autenticados como el mismo usuario.
El límite por defecto de 1 stream significa que una segunda conexión con la misma key desplazará a la primera (código de cierre 4001 displaced by newer session en WS, cierre del writer en SSE). Un cliente desplazado no debe reconectarse automáticamente: el slot está ocupado por la sesión más nueva, y reconectarse la expulsaría de inmediato.
Flota con tantos procesos como keys incluye tu plan: cada API key tiene su propio slot de stream independiente. Asigna una key por proceso — no se necesita ningún override ni add-on. Las asignaciones son pequeñas: Hobby y Pro incluyen una key, Sharp dos — meta.max_keys en GET /api/v1/account/keys muestra la tuya — así que, sin Enterprise, esta vía cubre como máximo una flota de dos procesos. Consulta Pricing para ver detalles de planes y add-ons.
Flota mayor que tu límite de keys, o una sola key para múltiples streams: la vía de escape prevista es un override de maxStreams por key, dimensionado para la flota. Es un add-on de pago en cualquier plan de pago, aprovisionado por key — contacta con sales@sharpapi.io para que se fije un límite mayor en una key específica.
Consulta los Límites de streams concurrentes y el contrato de fiabilidad para la semántica de desplazamiento.
Para todo lo demás — incluso suscripciones muy amplias — los patrones anteriores permiten que un solo socket cubra lo que parecen diez preocupaciones distintas.
Coste en el servidorEnlace permanente a esta sección
No hay ninguna razón de eficiencia para dividir. La ruta caliente del servidor:
- Calcula el diff por ciclo del libro una vez.
- Preserializa los payloads sin filtrar de cambios/eliminados una vez.
- Para cada cliente conectado, aplica su filtro y serializa el subconjunto correspondiente (o envía los bytes preserializados directamente cuando el cliente no tiene filtros de contenido).
Un cliente con league=nba,nfl,mlb,nhl cuesta casi lo mismo que cuatro clientes cada uno con una liga — menos cuatro sockets, cuatro handshakes TLS, cuatro conjuntos de cabeceras HTTP y cuatro ciclos connected/snapshot. El patrón de conexión única también es mejor para la consistencia de los deltas: ves todas las actualizaciones en el orden en que el servidor las produjo, en lugar de intercalarlas entre sockets con backpressure independiente.
Lista de comprobación de migraciónEnlace permanente a esta sección
Si estás migrando desde una arquitectura multi-stream:
- Combina los filtros de identidad — recopila cada valor de
sport,league,sportsbook,marketyevent_idde tus streams antiguos y únelos con comas en una sola URL. - Usa
channel=all(SSE;channel=all,low_holdsi usas low-hold) o cada valor necesario dechannels=(WS) en lugar de un stream por tipo de evento. - Despacha en tu handler — lee
odds[].league/odds[].sportsbook/event.eventpara enrutar mensajes internamente exactamente como antes. - Elimina tu lógica de reconexión N veces — un solo socket significa una sola ruta de reconexión. SSE se reconecta automáticamente; para WS, consulta el patrón de reconexión.
- Mantén los umbrales
min_ev/min_profit— estos siguen reduciendo el stream de oportunidades en el servidor y reducen el ancho de banda.
Véase tambiénEnlace permanente a esta sección
- Visión general de streaming — comparación de protocolos e inicio rápido
- Guía de streaming WebSocket — mensajes subscribe, reconexión
- Referencia de la API SSE — lista completa de parámetros de filtro
- Referencia de la API WebSocket — esquema subscribe, códigos de cierre