Saltar a contenido

Conexión de suscriptor Phoenix Edge

Al conectarme a DoubleZero, acepto los Términos de Uso de DoubleZero. Ten en cuenta que los datos son solo para tus fines internos y no pueden ser retransmitidos (ver Sección 2(e)).

Los feeds de Phoenix entregan datos de mercado de perpetuos de Phoenix a través de la red DoubleZero Edge como multicast UDP. Hay dos feeds:

  • Top of Book (TOB): mejor oferta de compra y venta, más impresiones de operaciones
  • Market by Price (MBP): profundidad por nivel de precio, más impresiones de operaciones

Precios

Los feeds se facturan por mes:

Feed Precio
phoenix-tob $50 / mes
phoenix-mbp $100 / mes

¿Qué camino debo tomar?

# Camino Ideal para Esfuerzo
1 Edge Connect Agentes y aplicaciones que desean una CLI simple y JSON decodificado a través de WebSocket Mínimo
2 Multicast nativo Construir tu propio decodificador contra el formato de cable crudo Máximo

Antes de cualquier camino: adquiere los feeds que necesitas en doublezero.xyz/edge/subscribe. Al comprar, aceptas los Términos de Uso de DoubleZero.

¿Quieres que una IA te ayude con la instalación? Conecta el DoubleZero MCP y pídele que te guíe a través de Phoenix / Edge Connect.

Empieza aquí. doublezero-edge-connect es el camino ideal para agentes: un solo comando de instalación, el host se une a DoubleZero, y tu aplicación consume JSON decodificado a través de WebSocket (ws://<host>:8081) en lugar de decodificar multicast binario.

Edge Connect satisface las necesidades de su creciente base de usuarios. Este es el método de conexión más fácil y debe utilizarse a menos que tengas una necesidad técnica específica.

Versión corta:

curl -fsSL https://get.doublezero.xyz/connect | \
  DZ_SECRET=/path/to/keypair.json DZ_FEEDS=PHOENIX DZ_ASSUME_YES=1 bash

Las variables van después del pipe para que el instalador (bash) las reciba. DZ_SECRET es un token de acceso DZ_… o la ruta al archivo JSON del keypair de Solana que posee tu pase de acceso / compra de feed.

Si ya hay un doublezerod del host ejecutándose, tanto él como el daemon propio del contenedor intentan vincular el puerto UDP 44880, por lo que el daemon del contenedor se detiene justo después de iniciar. El instalador ofrece detener y deshabilitar el daemon del host, y lo hace sin preguntar cuando DZ_ASSUME_YES=1 está configurado. Para hacerlo manualmente:

sudo systemctl stop doublezerod
sudo systemctl disable doublezerod

Luego verifica el estado dentro del contenedor (espera BGP Session Up y tu grupo Phoenix) y conecta un cliente WebSocket al :8081:

docker exec doublezero-edge-connect doublezero status

Edge Connect arbitra entre los publicadores de Phoenix, por lo que los clientes WebSocket ven una sola copia de cada actualización.

Pasos completos, verificación y problemas comunes: conecta el DoubleZero MCP y pídele que te guíe a través de Edge Connect para Phoenix.
Contrato WebSocket: PROTOCOL.md.

2. Multicast nativo (avanzado)

Se requiere un conocimiento técnico más profundo

Multicast nativo significa que te unes al grupo tú mismo y decodificas el formato de cable crudo de Edge en tu host. Solo los usuarios con mayor capacidad técnica deben tomar este camino. Necesitarás leer y comprender las especificaciones, comenzando con market-by-price/spec.md y el resto de edge-feed-spec. Prefiere Edge Connect a menos que tengas un requisito estricto de controlar el decodificador.

Configuración del cliente DoubleZero

Sigue las instrucciones de configuración para instalar y configurar el cliente DoubleZero. Mantén el cliente actualizado:

sudo apt update && sudo apt install doublezero

Comprar un feed

Con doublezerod ejecutándose, identifica el dispositivo de menor latencia antes de comprar:

doublezero latency

Compra en https://doublezero.xyz/edge/subscribe.

Configurar el firewall

Permite GRE, BGP, PIM y el tráfico del feed Phoenix. Los puertos UDP de Phoenix están en el rango 9201–9213: 9201/9202 transportan datos de mercado y referencia de Top of Book, y 9211/9212/9213 transportan datos de mercado, referencia y snapshot de Market by Price. Ver Direcciones de feeds.

iptables:

sudo iptables -A OUTPUT -p gre -j ACCEPT
sudo iptables -A INPUT -i doublezero1 -s 169.254.0.0/16 -d 169.254.0.0/16 -p tcp --dport 179 -j ACCEPT
sudo iptables -A OUTPUT -o doublezero1 -s 169.254.0.0/16 -d 169.254.0.0/16 -p tcp --dport 179 -j ACCEPT
sudo iptables -A OUTPUT -o doublezero1 -p pim -j ACCEPT
# Phoenix market / reference / snapshot (ambos feeds)
sudo iptables -A INPUT -i doublezero1 -p udp --dport 9201:9213 -j ACCEPT

UFW:

sudo ufw allow proto gre from any to any
sudo ufw allow in on doublezero1 from 169.254.0.0/16 to 169.254.0.0/16 port 179 proto tcp
sudo ufw allow out on doublezero1 from 169.254.0.0/16 to 169.254.0.0/16 port 179 proto tcp
# Phoenix market / reference / snapshot (ambos feeds)
sudo ufw allow in on doublezero1 to any port 9201:9213 proto udp

UFW no tiene protocolo pim. El PIM saliente está permitido por la política de salida por defecto de UFW; si deniega el tráfico saliente, agregue una regla raw para PIM en /etc/ufw/before.rules.

Suscribirse

Únete a cada feed que compraste (cliente v0.35.0 o posterior):

doublezero connect multicast

O nombra los feeds por código de feed:

doublezero connect multicast --subscribe-feed phoenix-tob phoenix-mbp

Usa los códigos de feed phoenix-tob / phoenix-mbp, no los nombres de feed por metro (como phoenix-tob-cmh) ni los códigos de grupo (edge-phoenix-…). Suscribirse por código de grupo con --subscribe falla con un pase comprado.

Espera ✅ User Provisioned. Espera aproximadamente 60 segundos y luego:

doublezero status

Espera BGP Session Up en la red DoubleZero correcta.

doublezero user list --client-ip <your ip>

Tus feeds aparecen en la columna groups. Inspecciona las IPs del grupo con:

doublezero multicast group list

Decodificar el cable tú mismo

La versión del esquema es 3 — descarta los datagramas cuya versión tu decodificador no implementa. Layouts autoritativos: edge-feed-spec, incluyendo top-of-book/spec.md, market-by-price/spec.md y el GLOSSARY.

Cada datagrama comienza con un encabezado de datagrama de 24 bytes, seguido de uno o más mensajes de aplicación empaquetados hasta el MTU. Los datagramas son little-endian y de layout fijo.

Campo Notas
Magic u16 en offset 0: 0x445A en TOB, 0x4442 en MBP. Valídalo.
Versión del esquema 3
Channel ID Ambos feeds de Phoenix usan el canal 1
Secuencia Monótona por dirección IP de origen, Channel ID y puerto de destino — cada puerto tiene su propia serie. Úsala para detección de gaps.
Timestamp de envío Nanosegundos desde la época Unix
Cantidad de mensajes Mensajes empaquetados en este datagrama
Contador de reset Cualquier cambio (incluyendo el wrap de 255 → 0) es un reset; descarta el estado del canal de ese publicador. MBP también puede incrementarlo a mitad de sesión en un re-seed de todo el venue.
Longitud del datagrama Total de bytes

Más de un publicador envía cada feed de Phoenix, en los mismos grupos, canal y puertos. Indexa todo el estado del canal e instrumento por la dirección IP de origen además del Channel ID, o las series de secuencia de dos publicadores se intercalarán en una sola. Un suscriptor nativo recibe una copia de cada operación por publicador.

Mensajes de aplicación (TOB)

Tipo ID Tamaño Puerto Contiene
Heartbeat 0x01 16 B market Señal de vida mientras el mercado está tranquilo
InstrumentDefinition 0x02 130 B reference Símbolo, exponentes, tick y lote, vencimiento
Quote 0x03 60 B market Mejor oferta de compra y venta, precio y tamaño, flags de actualización
Trade 0x04 52 B market Precio, tamaño, lado agresor, ID de operación
EndOfSession 0x06 12 B market Apagado limpio
ManifestSummary 0x07 24 B reference Flag de validez, contador de cambios de Manifest Seq, cantidad de instrumentos, timestamp

Phoenix no envía 0x08 (Liquidation). El Source ID de Phoenix en el registro de edge-feed-spec es 2. Lee price_exponent y qty_exponent de cada InstrumentDefinition — no los codifiques de forma fija. El exponente es la precisión del precio, no el tick: BTC en Phoenix usa exponente -2 con un tamaño de tick de 100, por lo que se mueve en dólares enteros.

El feed MBP usa el conjunto de mensajes de market-by-price. Consulta las especificaciones de market-by-price y reference-data en edge-feed-spec. Ambos feeds provienen del mismo proceso publicador, por lo que comparten IDs de instrumento, y el puerto de datos de mercado de MBP transporta las mismas impresiones de operaciones que TOB. Los IDs de operación de Phoenix son números de secuencia por mercado, así que deduplica operaciones por (instrument ID, trade ID), nunca por trade ID solo.

La entrega es UDP de tipo fire-and-forget sin retransmisión, y el puerto de reference-data no repara datos de mercado: solo repite InstrumentDefinition (al menos una vez cada 30 s) y ManifestSummary (al menos una vez cada 1 s). Un Quote de TOB perdido permanece perdido hasta que la mejor oferta de compra o venta de ese mercado cambie. Solo MBP tiene un mecanismo de reparación — su ciclo de snapshot — y un arranque en frío de MBP debe vincular el puerto de snapshot.

Direcciones de feeds

Código de feed Código de grupo Descripción Grupo multicast Datos de mercado Datos de referencia Snapshot
phoenix-tob edge-phoenix-tob Top-of-book de perpetuos y operaciones 233.84.178.24 9201 9202 —
phoenix-mbp edge-phoenix-mbp Market-by-price de perpetuos 233.84.178.25 9211 9212 9213

Suscríbete con el código de feed; doublezero status y multicast group list muestran el código de grupo.

El grupo selecciona el feed; el puerto selecciona datos de mercado, datos de referencia o snapshot dentro de él. La replicación multicast ocurre por dirección IP de origen y grupo, y la infraestructura nunca inspecciona el puerto UDP, por lo que unirse a un grupo entrega todo en ese grupo a través de tu túnel DoubleZero. El puerto es un filtro de socket aplicado en tu propio host después de que los bytes llegan.

Solución de problemas

Si encuentras un problema no cubierto aquí, por favor comunícate a través de tu canal existente antes de intentar solucionarlo por tu cuenta. Si no tienes un canal, consulta Soporte.

Asegúrate de que tu cliente esté actualizado

Ejecuta: sudo apt update && sudo apt install doublezero

No llegan datagramas

  1. Confirma que el feed fue comprado en https://doublezero.xyz/edge/subscribe. Un feed no comprado no entrega tráfico.
  2. Confirma que BGP está activo: doublezero status debe mostrar BGP Session Up en la red DoubleZero correcta.
  3. Confirma que la suscripción está activa: doublezero user list --client-ip <your ip> debe listar el feed bajo groups.
  4. Confirma que el grupo está unido en la interfaz correcta. El multicast llega por doublezero1, no por doublezero0.
  5. Confirma que el firewall permite los puertos UDP del feed de entrada en doublezero1.

Gaps de secuencia

Rastrea la secuencia por dirección IP de origen, Channel ID y puerto de destino; un decodificador indexado solo por Channel ID verá gaps falsos. Un gap real significa datagramas perdidos. En MBP, los mercados afectados se recuperan del siguiente ciclo de snapshot. En TOB no hay reparación: la cotización de un mercado vuelve a estar actualizada una vez que su mejor oferta de compra o venta cambia nuevamente.

Cambios en el contador de reset

Cualquier cambio en el contador de reset significa que ese publicador reinició o re-sembró el canal. Descarta el estado para esa dirección IP de origen y canal, recopila las definiciones del puerto de reference-data nuevamente, y en MBP reconstruye los libros de órdenes desde el puerto de snapshot.

El túnel no se establece

  1. Edge Connect: ejecuta status en el contenedor — docker exec doublezero-edge-connect doublezero status. El doublezero status del host a menudo falla mientras el feed funciona bien (el contenedor posee el daemon). Confirma que el doublezerod del host está detenido.
  2. Nativo: verifica que el daemon del host esté ejecutándose: sudo systemctl status doublezerod
  3. Verifica que las reglas de firewall estén en su lugar (GRE, BGP, PIM y los puertos del feed en doublezero1)
  4. Verifica el estado de la conexión desde el mismo lugar donde te conectaste (contenedor o host) — espera BGP Session Up en la red DoubleZero correcta

La IP del cliente se descubre automáticamente a partir de la IP pública de tu host. Verifica que coincida con la IP que usaste al comprar el feed.

Diseño de referencia para investigación

Opcional. Si ya tienes un túnel DoubleZero y una suscripción en el host y deseas grabar y graficar datos del feed, el diseño de referencia para investigación ejecuta multicast → parser → topofbook-bot → ClickHouse → Grafana con Docker Compose:

github.com/malbeclabs/edge-multicast-ref/tree/main/demo

Esto apunta la demo a Phoenix TOB (ver Direcciones de feeds):

cd demo
cp .env.example .env
sed -i -e 's/^DZ_MULTICAST_GROUP=.*/DZ_MULTICAST_GROUP=233.84.178.24/' \
       -e 's/^DZ_MARKETDATA_PORT=.*/DZ_MARKETDATA_PORT=9201/' \
       -e 's/^DZ_REFDATA_PORT=.*/DZ_REFDATA_PORT=9202/' \
       -e 's/^DZ_INTERFACE=.*/DZ_INTERFACE=doublezero1/' .env
docker compose up -d --build

Grafana normalmente está en http://localhost:3000 en el host. Detalles y dashboards: el README de la demo.

Esto visualiza datos que ya estás recibiendo. No reemplaza la compra del feed, la suscripción ni ninguno de los caminos de conexión anteriores.