YH Finance APIs

Acceso programático a cotizaciones en vivo, gráficos OHLCV, fundamentales de empresas, calendario de resultados, filtros y noticias financieras. Construye aplicaciones de trading, paneles de cartera y herramientas de investigación con datos de renta variable en tiempo real. Utilizada por plataformas fintech y de trading en todo el mundo.

🔍

Autocompletado de símbolos y palabras clave

Búsqueda predictiva de símbolos y palabras clave para acciones, ETF e índices. Alimenta cuadros de búsqueda y selectores de símbolos en aplicaciones de trading e investigación. Devuelve símbolos y entidades coincidentes mientras el usuario escribe para descubrir tickers rápidamente.

GET /api/project/yh-finance/auto-complete
📦

Contar eventos en un período

Cuenta el número de eventos (resultados, splits, información IPO, eventos económicos) en un período. Usa operandos de filtro para rango de fechas y región. Ideal para KPIs de panel y umbrales de alerta.

POST /api/project/yh-finance/calendar-count-events

Obtener eventos en un período

Obtiene eventos (resultados, splits, información IPO, eventos económicos) con paginación, orden y campos opcionales. El cuerpo de la petición admite operadores de filtro para feeds de calendario flexibles.

POST /api/project/yh-finance/calendar-get-events
🔄

Contar conversaciones para un símbolo

Obtiene el conteo total de conversaciones del tablón de mensajes de un ticker. Usa messageBoardId de market/v2/get-quotes. Métrica ligera para paneles de comunidad y sentimiento.

GET /api/project/yh-finance/conversations-count
📡

Listar conversaciones (Obsoleto)

Lista conversaciones relacionadas con un símbolo con orden y paginación. Obsoleto; preferir conversations/v2/list para nuevas integraciones.

GET /api/project/yh-finance/conversations-list
🔗

Listar conversaciones (v2)

Lista conversaciones de un símbolo con count, offset y orden. Usa messageBoardId de market/v2/get-quotes. Alimenta pestañas de comunidad y sentimiento.

GET /api/project/yh-finance/conversations-v2-list
📋

Datos de gráfico para símbolo y comparativas (Obsoleto)

Obtiene datos para dibujar gráfico de un símbolo y símbolos de comparación. Obsoleto; considerar stock/v2/get-chart o stock/v3/get-chart.

GET /api/project/yh-finance/market-get-charts
🌐

Obtener resultados recientes del mercado

Obtiene resultados recientes del mercado por región y rango de fechas. Admite size para número de resultados. Alimenta resúmenes y pantallas de resultados a nivel de mercado.

GET /api/project/yh-finance/market-get-earnings
🔍

Obtener listas populares

Obtiene las listas de seguimiento populares del mercado. Sin parámetros; devuelve lista de listas curadas para descubrimiento y plantillas de cartera.

GET /api/project/yh-finance/market-get-popular-watchlists
📦

Datos spark/mini gráfico

Datos OHLCV ligeros para múltiples tickers para renderizar sparklines y mini gráficos. Combinar con market/get-trending-tickers para vistas spark de tendencias.

GET /api/project/yh-finance/market-get-spark

Tickers agrupados por tipo de cotización

Obtiene tickers agrupados por tipos de cotización (renta variable, ETF, fondo mutuo, etc.). Región y lang opcionales para selección de universo y filtros.

GET /api/project/yh-finance/market-get-tickers-by-quote-type
🔄

Obtener tickers en tendencia

Obtiene los últimos tickers en tendencia del mercado por región. Combinar con market/get-spark para gráficos spark. Sin entrada de símbolo; devuelve lista de tendencias actual.

GET /api/project/yh-finance/market-get-trending-tickers
📡

Detalle de lista de seguimiento

Obtiene información detallada de una lista de seguimiento por userId e id de cartera (pfId). Definición completa y metadatos para mostrar o editar.

GET /api/project/yh-finance/market-get-watchlist-detail
🔗

Rendimiento de lista de seguimiento

Obtiene información de rendimiento de una lista de seguimiento. Símbolos y región opcionales. Rentabilidad y estadísticas relacionadas para vistas de cartera y comparación.

GET /api/project/yh-finance/market-get-watchlist-performance
📋

Subidas, bajadas y más activos del día

Las subidas, bajadas y acciones más activas del día en una región. Admite count y start para paginación. Listas precalculadas para la sesión.

GET /api/project/yh-finance/market-v2-get-movers
🌐

Cotizaciones en vivo

Obtiene cotizaciones en vivo para uno o más símbolos. Símbolos separados por comas; región requerida. Cotizaciones sincronizadas en tiempo de petición para tiras de cotización y formularios de orden.

GET /api/project/yh-finance/market-v2-get-quotes
🔍

Resumen de mercado por región

Obtiene información de resumen en vivo del mercado por región. Una llamada por región; sin entrada de símbolo. Índices y estado de alto nivel para paneles.

GET /api/project/yh-finance/market-v2-get-summary
📦

Detalles de artículo de noticias

Lee un artículo de noticias completo. UUID de la respuesta de news/v2/list. Obtén contenido completo para vistas de lectura y enlaces profundos.

GET /api/project/yh-finance/news-v2-get-details

Listar noticias y feeds

Lista últimas noticias generales o feeds de vídeo, o noticias relativas a un símbolo (parámetro s). Cuerpo POST para paginación (uuids). Noticias y vídeos financieros paginados.

POST /api/project/yh-finance/news-v2-list
🔄

Opciones de filtro del screener

Obtiene filtros opcionales para uso posterior en screeners/list. Category y quoteType acotan el conjunto de filtros. Construye UIs de screening dinámicas y documentación.

GET /api/project/yh-finance/screeners-get-filters
📡

Símbolos por screener predefinido

Obtiene símbolos relacionados con un screener predefinido (p. ej. MOST_ACTIVES). scrIds, start y count opcionales. Listas de símbolos curadas sin filtros personalizados.

GET /api/project/yh-finance/screeners-get-symbols-by-predefined
🔗

Ejecutar screener con filtros

Lista subidas, bajadas, más activos, fondos mutuos, ETF y más con filtros opcionales. Cuerpo POST para criterios de filtro. Pantallas por categoría y personalizadas.

POST /api/project/yh-finance/screeners-list
📋

IDs de screener para un ticker

Obtiene IDs de screener relacionados con un ticker. Usa símbolo de auto-complete. Encuentra qué screeners predefinidos o personalizados contienen esta acción.

GET /api/project/yh-finance/screeners-list-by-ticker
🌐

Perspectiva de la empresa

Obtiene la perspectiva de empresa para un símbolo. Incluye narrativa de negocio y crecimiento de alto nivel; región y lang opcionales. Texto de perspectiva curado y temas clave.

GET /api/project/yh-finance/stock-get-company-outlook
🔍

Resultados para un símbolo

Obtiene resultados relacionados con un símbolo. Resultados históricos y próximos; región y lang opcionales. Todos los datos de resultados para un ticker.

GET /api/project/yh-finance/stock-get-earnings
📦

Puntuaciones ESG de riesgo para pares (Obsoleto)

Obtiene puntuaciones ESG de riesgo para pares relacionados con un símbolo. Obsoleto; preferir stock/get-esg-scores cuando aplique.

GET /api/project/yh-finance/stock-get-esg-score-for-peers

Puntuaciones ESG para símbolo

Obtiene puntuaciones ESG relacionadas con un símbolo. Región y lang opcionales. Puntuaciones y ratings para sostenibilidad y riesgo para inversión sostenible.

GET /api/project/yh-finance/stock-get-esg-scores
🔄

Calendario de eventos para símbolo

Obtiene calendario de eventos (IPO, resultados, informes SEC) para un símbolo. modules y tickersFilter requeridos; rango de fechas opcional. Soporte de calendario multi-ticker.

GET /api/project/yh-finance/stock-get-events-calendar
📡

Comisiones y gastos

Obtiene comisiones y gastos relacionados con un símbolo (p. ej. fondos). Región y lang opcionales. Ratio de gastos y detalle de comisiones para comparación de fondos.

GET /api/project/yh-finance/stock-get-fees-and-expenses
🔗

Datos fundamentales

Obtiene datos fundamentales. modules (separados por comas) seleccionan qué bloques devolver; symbol y región y lang opcionales. Datos fundamentales completos.

GET /api/project/yh-finance/stock-get-fundamentals
📋

Cadena de futuros

Obtiene la cadena de futuros para un símbolo. Región y lang opcionales. Contratos y vencimientos del subyacente para flujos de derivados.

GET /api/project/yh-finance/stock-get-futures-chain
🌐

Actualizaciones recientes para símbolo

Obtiene actualizaciones recientes relacionadas con un símbolo. Región y lang opcionales. Actualizaciones cronológicas para feeds de actividad.

GET /api/project/yh-finance/stock-get-recent-updates
🔍

Tendencia de recomendación

Obtiene información de tendencia de recomendación (tendencia de consenso de analistas). Región y lang opcionales. Recomendación agregada de analistas en el tiempo.

GET /api/project/yh-finance/stock-get-recommendation-trend
📦

Presentaciones SEC para símbolo

Obtiene presentaciones SEC relacionadas con un símbolo. Región y lang opcionales. Lista de presentaciones con tipo y fecha para cumplimiento e investigación.

GET /api/project/yh-finance/stock-get-sec-filings

Principales posiciones para símbolo

Obtiene principales posiciones relacionadas con un símbolo (p. ej. para fondos o ETF). Región y lang opcionales. Principales posiciones con ponderaciones para vistas de composición.

GET /api/project/yh-finance/stock-get-top-holdings
🔄

Qué dicen los analistas

Obtiene la sección "qué dicen los analistas" para uno o más símbolos. Símbolos separados por comas; región y lang opcionales. Narrativa y conclusiones clave.

GET /api/project/yh-finance/stock-get-what-analysts-are-saying
📡

Datos de gráfico (v2)

Obtiene datos para dibujar gráfico a pantalla completa. range e interval o period1/period2; región opcional. OHLCV para gráficos y backtest.

GET /api/project/yh-finance/stock-v2-get-chart
🔗

Informes breves para símbolo (v2)

Obtiene informes breves relacionados con un símbolo. Un solo símbolo. Informes cortos y destacados para contexto rápido.

GET /api/project/yh-finance/stock-v2-get-insights
📋

Símbolos similares y recomendados

Obtiene símbolos similares al especificado. Un símbolo. Símbolos similares o frecuentemente comparados para descubrimiento.

GET /api/project/yh-finance/stock-v2-get-recommendations
🌐

Series temporales financieras (trimestral/anual)

Obtiene datos trimestrales o anuales en pestaña Financieros. type selecciona métricas; period1 y period2 para rango. Fundamentales históricos para gráficos y modelos.

GET /api/project/yh-finance/stock-v2-get-timeseries
🔍

Datos de gráfico (v3)

Obtiene datos para dibujar gráfico a pantalla completa con comparativas, eventos (dividendos, splits) y pre/post mercado. range e interval requeridos. Gráficos avanzados para profesionales.

GET /api/project/yh-finance/stock-v3-get-chart
📦

Tenedores para símbolo

Obtiene tenedores (institucionales, principales, insiders) relacionados con un símbolo. Región y lang opcionales. Desglose de propiedad para análisis.

GET /api/project/yh-finance/stock-v3-get-holders

Informes breves para símbolo (v3)

Obtiene informes breves relacionados con un símbolo. Preferido sobre v2 para nuevas integraciones. Informes de insight y destacados.

GET /api/project/yh-finance/stock-v3-get-insights
🔄

Precios de opciones

Obtiene precios de opciones para un símbolo. Fecha, straddle, región y lang opcionales. Calls y puts con strikes y vencimientos.

GET /api/project/yh-finance/stock-v3-get-options
📡

Perfil del ticker

Obtiene perfil del ticker (sector, industria, empleados, descripción, etc.). Región y lang opcionales. Perfil de empresa para páginas de detalle.

GET /api/project/yh-finance/stock-v3-get-profile
🔗

Historial de mejoras y rebajas

Obtiene historiales de mejoras y rebajas relacionados con un símbolo. Región y lang opcionales. Cambios de rating cronológicos.

GET /api/project/yh-finance/stock-v3-get-upgrades-downgrades
📋

Estadísticas para símbolo

Obtiene estadísticas relacionadas con un símbolo. Endpoint de estadísticas preferido; región y lang opcionales. Valoración, rentabilidad y métricas de mercado.

GET /api/project/yh-finance/stock-v4-get-statistics
🌐

Sección Análisis (Obsoleto)

Obtiene datos de la sección Análisis. Obsoleto. Usar endpoints de fundamentales o insights en su lugar.

GET /api/project/yh-finance/stock-v2-get-analysis
🔍

Balance (Obsoleto)

Obtiene datos de la pestaña Balance. Usar stock/v2/get-timeseries y stock/get-fundamentals en su lugar.

GET /api/project/yh-finance/stock-v2-get-balance-sheet
📦

Flujo de caja (Obsoleto)

Obtiene pestaña Flujo de caja. Usar stock/v2/get-timeseries y stock/get-fundamentals en su lugar.

GET /api/project/yh-finance/stock-v2-get-cash-flow

Cuenta de resultados anual (Obsoleto)

Obtiene datos de Cuenta de resultados anual. Usar get-timeseries y get-fundamentals en su lugar; para trimestral usar get-timeseries.

GET /api/project/yh-finance/stock-v2-get-financials
🔄

Tenedores principales (Obsoleto)

Obtiene pestaña Tenedores principales. Preferir stock/v3/get-holders.

GET /api/project/yh-finance/stock-v2-get-holders
📡

Pestaña Posiciones (Obsoleto)

Obtiene pestaña Posiciones (fondo mutuo). Un símbolo. Usar stock/get-top-holdings cuando aplique.

GET /api/project/yh-finance/stock-v2-get-holdings
🔗

Listado insider (Obsoleto)

Obtiene pestaña Listado insider en sección Tenedores. Usar get-fundamentals o v3/get-holders.

GET /api/project/yh-finance/stock-v2-get-insider-roster
📋

Transacciones insider (Obsoleto)

Obtiene pestaña Transacciones insider. Usar módulos get-fundamentals.

GET /api/project/yh-finance/stock-v2-get-insider-transactions
🌐

Sección Opciones (Obsoleto)

Obtiene datos de la sección Opciones. Preferir stock/v3/get-options.

GET /api/project/yh-finance/stock-v2-get-options
🔍

Pestaña Perfil (Obsoleto)

Obtiene pestaña Perfil. Preferir stock/v3/get-profile.

GET /api/project/yh-finance/stock-v2-get-profile
📦

Símbolos similares (Obsoleto)

Obtiene símbolos similares y recomendados. Preferir stock/v2/get-recommendations.

GET /api/project/yh-finance/stock-v2-get-similarities

Pestaña Estadísticas (Obsoleto)

Obtiene pestaña Estadísticas. Usar stock/get-fundamentals o stock/v4/get-statistics en su lugar.

GET /api/project/yh-finance/stock-v2-get-statistics
🔄

Sección Resumen (Obsoleto)

Obtiene sección Resumen. Usar market/v2/get-quotes en su lugar.

GET /api/project/yh-finance/stock-v2-get-summary
📡

Mejoras y rebajas (Obsoleto)

Obtiene mejoras y rebajas. Preferir stock/v3/get-upgrades-downgrades.

GET /api/project/yh-finance/stock-v2-get-upgrades-downgrades
🔗

Balance v3 (Obsoleto)

Obtiene pestaña Balance. Usar get-timeseries y get-fundamentals en su lugar.

GET /api/project/yh-finance/stock-v3-get-balance-sheet
📋

Pestaña Datos históricos (Obsoleto)

Obtiene pestaña Datos históricos. Usar stock/get-fundamentals en su lugar.

GET /api/project/yh-finance/stock-v3-get-historical-data
🌐

Estadísticas v3 (Obsoleto)

Obtiene pestaña Estadísticas. Usar stock/get-fundamentals o stock/v4/get-statistics en su lugar.

GET /api/project/yh-finance/stock-v3-get-statistics