API pública de Nebula
Índice de referencia
Todos los endpoints siguientes tienen una página HTML estable y una versión gemela en Markdown. Este índice es estático, rastreable y seguro para que los agentes de IA lo lean sin ejecutar JavaScript.
Descubrimiento
3 endpoints/screener
Screener
Ordena activos o sujetos por una medida de 24 horas y filtra por las demás: share, share change, posts, net bullish posts (bullish menos bearish; un valor negativo es bearish) o variación del precio en 24 horas. Los rangos son inclusivos y se combinan; los filtros de precio se aplican solo a activos.
/top-momentum
Mayor impulso
Los activos o sujetos que ganan share de la conversación más rápido: la share de estas 24 horas menos la de las 24 horas anteriores. share_change_pct es la misma variación respecto a la share de ayer.
/top-trending
Mayor tendencia
Los activos o sujetos con mayor cuota de conversación durante las últimas 24 horas, ordenados de mayor a menor, con la variación respecto a las 24 horas anteriores.
Búsqueda
3 endpoints/assets
Texto a ID de activo
Busca acciones (stocks y ETFs), materias primas, índices y cripto por nombre o ticker, y obtén los asset_id y asset_class que acepta cada endpoint de activos. Envía query para buscar, asset_id para una coincidencia exacta, o ninguno de los dos para explorar los activos más activos.
/search
Buscar
Una sola búsqueda en activos, personas, cuentas y temas. El kind de cada resultado indica qué es: los activos llevan asset_id y asset_class, los sujetos llevan subject_id. Envía kind para buscar solo en un lado.
/subjects
Texto a ID de sujeto
Busca personas, cuentas y temas, incluida la IA, y obtén los subject_id que acepta cada endpoint de sujetos. Los activos no se incluyen; usa /assets o /search para esos.
Social & Sentimiento
6 endpoints/emotions
Distribución de emociones
Cuáles de 15 emociones dominan la conversación sobre un activo o sujeto a lo largo del tiempo. proportion es la share de cada emoción dentro de las emociones del bucket (suman 1); post_count cuenta los posts que la muestran. Un post puede mostrar varias.
/mindshare
Mindshare
La cuota de conversación de un activo o sujeto: sus publicaciones en las últimas 24 horas como fracción de todas las publicaciones de su mercado (acciones, cripto, o personas y temas), de 0 a 1. Envía clusters para medir la cuota dentro de uno o más grupos de autores.
/related-subjects
Temas relacionados
Las personas, cuentas y temas que se mencionan con más frecuencia en las mismas publicaciones que un activo o asunto. share son las publicaciones compartidas como fracción de las publicaciones del ancla; los campos de sentimiento son el sentimiento del ancla dentro de esas publicaciones compartidas.
/sentiment
Sentimiento
Cuán alcista o bajista es la conversación sobre un activo, un sujeto o todo un mercado, a lo largo del tiempo. sentiment_signal es publicaciones alcistas menos bajistas durante las últimas 24 horas, con más peso para las publicaciones recientes: un valor positivo indica un sesgo alcista neto. Crece con el volumen, así que compara un activo con su propio historial.
/sentiment/timeframes
Sentimiento por intervalo temporal
Sentimiento dividido por el horizonte del que habla la gente: corto plazo (hasta una semana), medio plazo (de semanas a meses) y largo plazo (tres meses o más), cada uno en la escala de /sentiment. Separa a una multitud que es bajista esta semana pero alcista en el año de otra que es bajista en todo momento.
/social-momentum
Impulso social
Publicaciones, autores únicos y sentimiento dentro de cada clúster de autores, en paralelo, para un activo, un asunto o un mercado completo: qué grupos impulsan la conversación y en qué se diferencia su tono. Los clústeres se solapan, así que no los sumes. Envía clusters para devolver solo los que nombres.
Pronósticos
3 endpoints/forecasts/assets
Activos predecibles
Todos los activos con una previsión en este momento. La lista abarca tanto /forecasts/mindshare como /forecasts/sentiment, que pronostican los mismos activos: pasa el asset_id y el asset_class de un activo a cualquiera de los dos. Las acciones, las materias primas y los índices van primero, luego las criptomonedas, de mayor a menor número de menciones. La lista se actualiza cada cinco minutos.
/forecasts/mindshare
Previsión de mindshare
Dónde es probable que esté el mindshare de un activo en las próximas 72 horas, como un rango de resultados con sus probabilidades. series da la distribución cada 4 horas; chance_higher_72h y likely_low_share a likely_high_share resumen dónde acaba; takeoff_chance_72h es la probabilidad de un repunte repentino de la atención.
/forecasts/sentiment
Previsión de sentimiento
Hacia dónde es probable que vaya el sentimiento de un activo en las próximas 72 horas, como un rango de resultados con sus probabilidades. series da, cada 4 horas, los posts alcistas, bajistas, neutrales y totales esperados en ese paso y el sentiment_signal al final del mismo, en la escala /sentiment. chance_higher_24h y chance_higher_72h dan la probabilidad de que la señal termine por encima de current_sentiment_signal; sus indicadores _confident marcan cuándo esa probabilidad se inclina claramente hacia un lado.
Sentimiento de mercado
7 endpoints/calls
Llamadas long/short
Cuántas llamadas largas y cortas hace la gente sobre un activo, o en todos los mercados, a lo largo del tiempo. Una llamada afirma que un activo subirá o bajará, revela una posición o indica a otros que tomen una; una opinión sin más no cuenta. Envía clusters para contar las llamadas de un grupo.
/calls/returns
Distribución de resultados de las llamadas
Cómo se han comportado las llamadas recientes: tasa de acierto, rentabilidad mediana y media, y la distribución de las rentabilidades. Cada llamada se puntúa según el movimiento del precio durante las 24 horas posteriores, desde el lado de quien la hace, de modo que una llamada corta ante una caída del 10% es +10%. Envía clusters para comparar grupos, por ejemplo smart_money frente a dumb_money.
/conviction-index
Índice de convicción
Una lectura de 0 a 100 de cuán firmemente cree la gente en un activo. Combina el ratio alcista del activo frente al del mercado, cuánto se mantiene el sentimiento mientras el precio cae, el último ratio alcista y las emociones de tipo codicia. Alrededor de 50 es lo típico; compara un activo con su propio historial.
/fear-greed-index
Índice de miedo y codicia
Una lectura diaria de 0 a 100 de miedo frente a codicia para un activo, que combina precio, volatilidad, momentum, volumen de negociación y estado de ánimo social: hasta 20 Extreme Fear, 40 Fear, 60 Neutral, 80 Greed, por encima de 80 Extreme Greed. metadata enumera los componentes.
/price-levels
Niveles de precio mencionados en redes sociales
Los precios que la gente menciona para un activo (objetivos, soportes y niveles cotizados), agrupados por precio y tiempo: dónde está anclando el mercado sus expectativas. mentions cuenta los niveles declarados, así que una publicación puede sumar varios.
/social-volume-index
Volumen social frente a volumen de trading
Si el trading o la conversación están más calientes para un activo, cada uno medido contra su propia normal de 90 días. volume_index va de 0 a 100: 50 significa que ambos están igualmente elevados, por encima de 50 el trading va por delante de la conversación, por debajo de 50 la conversación va por delante del trading. Diario, hasta 90 días.
/social-volume-profile
Perfil de volumen social
Un perfil de volumen formado por publicaciones en lugar de operaciones: dónde se produjo la conversación sobre un activo en el eje de precios. Cada bin tiene recuentos de publicaciones, proporciones alcistas y bajistas, y directional_imbalance de −1 (todo bajista) a +1 (todo alcista); significance_score clasifica los bins de 0 a 1 según las publicaciones, el equilibrio, con qué frecuencia el precio los revisita y la compresión; el punto de control es el bin con más actividad. Envía clusters para perfilar un grupo.
Datos de mercado
1 endpointInteligencia
3 endpoints/calendar-events
Eventos del calendario
Eventos de mercado próximos y pasados (resultados, publicaciones económicas, OPV, cotizaciones, votaciones, audiencias), a nivel global o para un activo o tema concreto, con tipo, estado, importancia de 1 a 3 y las entidades implicadas. Por defecto, desde hoy en adelante, los más próximos primero; envía min_importance_score=2 para los destacados.
/insights
Inteligencia
Historias breves sobre lo que ocurre en los mercados, a nivel global o sobre un activo o sujeto concreto, cada una con un titular, un resumen, sentimiento (−1, 0 o +1), etiquetas, importancia de 1 a 3 y las entidades implicadas. Las actualizadas más recientemente primero; envía order_by=start_time_desc para ver primero los eventos más recientes.
/insights/attention
Atención de los insights
La conversación en torno a un elemento de inteligencia: la ventana de atención de 24 horas, los recuentos de autores y de sentimiento, los buckets por hora, la mezcla de clústeres, los vectores de impacto y las reacciones de precio de cada entidad vinculada con precio. Úsalo después de /insights cuando un lector abre un elemento y necesita todo el contexto del panel de detalle.
Clústeres
10 endpoints/clusters
Clústeres de autores
Actividad y sentimiento de cada clúster de autores en un mercado: publicaciones, autores únicos, variación frente a la ventana anterior y sentimiento neto (publicaciones alcistas menos bajistas) con una serie por hora. asset_class es equity (el valor predeterminado) o crypto.
/clusters/comparison
Comparación de clústeres
Todos los clústeres de autores en paralelo durante la ventana: publicaciones y su variación, cuán alcista es frente al mercado (cluster_bullish_share frente a market_bullish_share), el activo al que más se orientó en los últimos 7 días (trending_asset) y publicaciones diarias.
/clusters/comparison/divisive-assets
Activos divisivos
Los activos ampliamente comentados en los que los clústeres discrepan más. minority_share es la proporción del bando más pequeño entre los clústeres claramente alcistas o bajistas, por lo que 0.5 es un empate. Mide una conversación dividida, no un movimiento próximo.
/clusters/comparison/hype-cycles
Llegadas del ciclo de hype
Los mayores ciclos de hype de la ventana y el orden en que llegaron los clústeres a cada uno, en relación con la hora punta del mercado, con las publicaciones horarias del mercado en torno a la punta.
/clusters/comparison/traits
Comparación de rasgos de clústeres
Todos los rasgos de /clusters/profile de todos los clústeres, el más alto primero, para ver qué grupos lideran o van por detrás en cada uno.
/clusters/hype-cycles
Ciclos de hype de clústeres
Con cuánta antelación llega un clúster a los ciclos de hype en comparación con el mercado. curve es la proporción acumulada de publicaciones de cada lado desde 7 días antes de un pico hasta 7 después, por lo que la línea más a la izquierda es más temprana; lead_days es la ventaja del clúster (positiva es temprano) y clusters clasifica la ventaja de cada clúster.
/clusters/overlap
Solapamiento de clústeres
Qué clústeres siguen los mismos activos que este y si coinciden. overlap_share es la proporción de sus 50 principales activos que comparte un par; direction_agreement_share es la frecuencia con la que se inclinan en el mismo sentido; stance_gap es positivo cuando este clúster es el más alcista.
/clusters/profile
Perfil de clúster
Los rasgos de comportamiento de un clúster, cada uno clasificado frente a todos los demás clústeres (rank 1 es el más alto):
/clusters/rotation
Rotación de clústeres
Hacia dónde se mueve la atención de un clúster: los activos que ganan y pierden proporción de sus publicaciones frente a la ventana anterior, en puntos básicos, y cómo se reparten sus publicaciones entre mercados, personas y eventos.
/clusters/stances
Posturas de clústeres
La postura de un clúster sobre sus activos más comentados junto a la del mercado, de −1 (todo bajista) a +1 (todo alcista). contrarian_share indica con qué frecuencia se inclina en sentido contrario al mercado, con la media de los demás clústeres para comparar.