// Documentation Guide
Market Sentiment
Lectura en tiempo real de la presión de compra y venta en el símbolo activo, enriquecida con información de Hyperliquid y el contexto general del mercado.

Qué muestra
El widget de sentimiento del mercado (Market Sentiment) responde a una única pregunta de estructura:
- ¿Se inclina el libro de órdenes hacia las compras (bids) o hacia las ventas (asks) y cómo se compara esto con el posicionamiento general del mercado perpetuo?
El panel muestra el indicador Pair Flow (flujo de par), derivado directamente del libro L2 del símbolo activo:
- Una barra de neón horizontal dividida en una zona verde (bids) y una roja (asks). El ancho es proporcional a la cuota nocional media móvil de 5 minutos de cada lado.
- El porcentaje spot actual ("Now") debajo de la barra.
- Tres estadísticas compactas: nocional total de bids, desviación (tilt) frente al equilibrio (50/50) y nocional total de asks.
Un punto verde parpadea en la cabecera cuando el widget se monta. Representa la presencia activa en el espacio de trabajo, no el estado de la red. Si el flujo del backend falla, el widget utiliza cálculos en el cliente a partir del libro de órdenes bruto.
Cómo leerlo
- La barra se inclina hacia el verde → Strong Bid / Bid Led (Dominio de bids): Los compradores límite dominan el libro visible. Si el precio sube, el movimiento tiene soporte estructural de límites.
- La barra se inclina hacia el rojo → Strong Ask / Ask Led (Dominio de asks): Los vendedores límite dominan. Si el precio cae, el movimiento tiene soporte en el lado de la oferta.
- Balanced (Equilibrado): El libro es simétrico; no hay un sesgo direccional claro.
- Indicador de desviación (Tilt): Un porcentaje positivo indica más volumen de bids que de asks; un porcentaje negativo indica lo contrario. Los valores dentro de ±1% se consideran neutros.
El promedio de 5 minutos filtra el ruido a corto plazo, exponiendo tendencias de posicionamiento duraderas en lugar de variaciones temporales.
Contexto de Hyperliquid (opcional)
Cuando los datos del backend están disponibles, el widget abre tres paneles adicionales:
- HL Pair Context (Contexto de par HL): Si el símbolo activo cotiza en Hyperliquid, muestra la tasa de financiación (en puntos básicos), la cuota de interés abierto (open interest) y el tipo de participantes (cohorte) con mayor volumen de OI.
- HL Market Breadth (Amplitud de mercado HL): Relación agregada de posiciones de interés abierto financiadas con largos frente a cortos en todos los perpetuos de Hyperliquid. Muestra el sesgo general de los traders de perpetuos.
- Segmentos de cohorte (Cohort segments): Tres tarjetas que resumen el sesgo de los grupos de participantes más grandes (ballenas, profesionales, minoristas).
Si el API del backend se desconecta o el símbolo no cotiza en Hyperliquid, estos paneles se ocultan automáticamente, volviendo a la vista compacta Pair Flow.
Consejos para operar
- Use el Market Sentiment como contexto, no como señal de entrada. Un sesgo de compra fuerte en el libro sin que suba el precio indica que hay liquidez presente pero no hay compras agresivas a mercado.
- Compare el sesgo de Pair Flow con el de HL Market Breadth. Una divergencia entre ambos suele preceder a una reversión a la media. Por ejemplo, si el par está dominado por compras (bid-led) pero HL está financiado con cortos (short-funded), aumenta el riesgo de estrangulamiento (squeeze) en los perpetuos.
- Combínelo con el interés abierto (Open Interest) y el seguimiento de financiación (Funding Tracker) para obtener un contexto de posicionamiento completo.
Limitaciones
- Los totales de bids y asks solo reflejan el libro L2 visible; las órdenes iceberg pasivas son invisibles. Trate las desviaciones extremas como sugerentes, no como definitivas.
- La capa de Hyperliquid funciona con el criterio de mejor esfuerzo. Cuando se alcanzan los límites del API o un símbolo no está mapeado, los paneles se ocultan en lugar de generar errores.
- El punto indicador de actividad refleja el estado del widget, no la salud del flujo de datos. Si los datos se detienen, la barra mantendrá su última posición.