YH Finance APIs
Acesso programático a cotações ao vivo, gráficos OHLCV, fundamentos de empresas, calendário de resultados, filtros e notícias financeiras. Construa aplicativos de trading, painéis de carteira e ferramentas de pesquisa com dados de ações em tempo real. Confiável por plataformas fintech e de trading no mundo todo.
Autocompletar símbolo e palavra-chave
Busca preditiva de símbolos e palavras-chave para ações, ETFs e índices. Alimenta caixas de busca e seletores de símbolo em aplicativos de trading e pesquisa. Retorna símbolos e entidades correspondentes conforme o usuário digita para descoberta rápida de tickers.
Contar eventos em um período
Conta o número de eventos (resultados, desdobramentos, informações de IPO, eventos econômicos) em um período. Use operandos de filtro para intervalo de datas e região. Ideal para KPIs de painel e limites de alerta.
Obter eventos em um período
Obtém eventos (resultados, desdobramentos, informações de IPO, eventos econômicos) com paginação, ordenação e campos opcionais. O corpo da requisição suporta operadores de filtro para feeds de calendário flexíveis.
Contar conversas para um símbolo
Obtém a contagem total de conversas do quadro de mensagens de um ticker. Use messageBoardId de market/v2/get-quotes. Métrica leve para painéis de comunidade e sentimento.
Listar conversas (Descontinuado)
Lista conversas relacionadas a um símbolo com ordenação e paginação. Descontinuado; prefira conversations/v2/list para novas integrações.
Listar conversas (v2)
Lista conversas de um símbolo com count, offset e ordenação. Use messageBoardId de market/v2/get-quotes. Alimenta abas de comunidade e sentimento.
Dados de gráfico para símbolo e comparações (Descontinuado)
Obtém dados para desenhar gráfico de um símbolo e símbolos de comparação. Descontinuado; considere stock/v2/get-chart ou stock/v3/get-chart.
Obter resultados recentes do mercado
Obtém resultados recentes do mercado por região e intervalo de datas. Suporta size para quantidade de resultados. Alimenta resumos e telas de resultados em nível de mercado.
Obter listas populares
Obtém as listas de acompanhamento populares do mercado. Sem parâmetros; retorna lista de listas curadas para descoberta e modelos de carteira.
Dados spark/mini gráfico
Dados OHLCV leves para múltiplos tickers para renderizar sparklines e mini gráficos. Combine com market/get-trending-tickers para visualizações spark de tendências.
Tickers agrupados por tipo de cotação
Obtém tickers agrupados por tipos de cotação (ações, ETF, fundo mútuo, etc.). region e lang opcionais para seleção de universo e filtros.
Obter tickers em tendência
Obtém os tickers mais recentes em tendência no mercado por região. Combine com market/get-spark para gráficos spark. Sem entrada de símbolo; retorna lista de tendências atual.
Detalhe da lista de acompanhamento
Obtém informações detalhadas de uma lista de acompanhamento por userId e id de carteira (pfId). Definição completa e metadados para exibição ou edição.
Desempenho da lista de acompanhamento
Obtém informações de desempenho de uma lista de acompanhamento. Símbolos e região opcionais. Retornos e estatísticas relacionadas para visualizações de carteira e comparação.
Alta, baixa e mais ativos do dia
As altas, baixas e ações mais ativas do dia em uma região. Suporta count e start para paginação. Listas pré-calculadas para a sessão de trading.
Cotações ao vivo
Obtém cotações ao vivo para um ou mais símbolos. Símbolos separados por vírgula; região obrigatória. Cotações sincronizadas no momento da requisição para barras de cotação e formulários de ordem.
Resumo de mercado por região
Obtém informações de resumo ao vivo do mercado por região. Uma chamada por região; sem entrada de símbolo. Índices e status de alto nível para painéis.
Detalhes do artigo de notícias
Lê um artigo de notícias financeiras completo. UUID da resposta de news/v2/list. Obtenha conteúdo completo para visualizações de leitura e links profundos.
Listar notícias e feeds
Lista últimas notícias gerais ou feeds de vídeo, ou notícias relativas a um símbolo (parâmetro s). Corpo POST para paginação (uuids). Notícias e vídeos financeiros paginados.
Opções de filtro do screener
Obtém filtros opcionais para uso posterior em screeners/list. Category e quoteType delimitam o conjunto de filtros. Construa UIs de triagem dinâmicas e documentação.
Símbolos por screener pré-definido
Obtém símbolos relacionados a um screener pré-definido (ex.: MOST_ACTIVES). scrIds, start e count opcionais. Listas de símbolos curadas sem filtros personalizados.
Executar screener com filtros
Lista altas, baixas, mais ativos, fundos mútuos, ETFs e mais com filtros opcionais. Corpo POST para critérios de filtro. Telas por categoria e personalizadas.
Ids de screener para um ticker
Obtém ids de screener relacionados a um ticker. Use símbolo do auto-complete. Descubra quais screeners pré-definidos ou personalizados contêm esta ação.
Perspectiva da empresa
Obtém a perspectiva da empresa para um símbolo. Inclui narrativa de negócios e crescimento de alto nível; region e lang opcionais. Texto de perspectiva curado e temas-chave.
Resultados para um símbolo
Obtém resultados relacionados a um símbolo. Resultados históricos e próximos; region e lang opcionais. Todos os dados de resultados para um ticker.
Pontuações de risco ESG para pares (Descontinuado)
Obtém pontuações de risco ESG para pares relacionados a um símbolo. Descontinuado; prefira stock/get-esg-scores quando aplicável.
Pontuações ESG para símbolo
Obtém pontuações ESG relacionadas a um símbolo. region e lang opcionais. Pontuações e ratings para sustentabilidade e risco para investimento sustentável.
Calendário de eventos para símbolo
Obtém calendário de eventos (IPO, resultados, relatórios SEC) para um símbolo. modules e tickersFilter obrigatórios; intervalo de datas opcional. Suporte a calendário multi-ticker.
Taxas e despesas
Obtém taxas e despesas relacionadas a um símbolo (ex.: fundos). region e lang opcionais. Índice de despesas e detalhes de taxas para comparação de fundos.
Dados fundamentais
Obtém dados fundamentais. modules (separados por vírgula) selecionam quais blocos retornar; symbol e region e lang opcionais. Dados fundamentais abrangentes.
Cadeia de futuros
Obtém a cadeia de futuros para um símbolo. region e lang opcionais. Contratos e vencimentos do subjacente para fluxos de derivativos.
Atualizações recentes para símbolo
Obtém atualizações recentes relacionadas a um símbolo. region e lang opcionais. Atualizações cronológicas para feeds de atividade.
Tendência de recomendação
Obtém informações de tendência de recomendação (tendência de consenso de analistas). region e lang opcionais. Recomendação agregada de analistas ao longo do tempo.
Arquivamentos SEC para símbolo
Obtém arquivamentos SEC relacionados a um símbolo. region e lang opcionais. Lista de arquivamentos com tipo e data para conformidade e pesquisa.
Principais posições para símbolo
Obtém principais posições relacionadas a um símbolo (ex.: para fundos ou ETFs). region e lang opcionais. Principais posições com pesos para visualizações de composição.
O que os analistas estão dizendo
Obtém a seção "o que os analistas estão dizendo" para um ou mais símbolos. Símbolos separados por vírgula; region e lang opcionais. Narrativa e conclusões-chave.
Dados de gráfico (v2)
Obtém dados para desenhar gráfico em tela cheia. range e interval ou period1/period2; região opcional. OHLCV para gráficos e backtest.
Relatórios breves para símbolo (v2)
Obtém relatórios breves relacionados a um símbolo. Um símbolo. Relatórios curtos e destaques para contexto rápido.
Símbolos similares e recomendados
Obtém símbolos similares ao especificado. Um símbolo. Símbolos similares ou frequentemente comparados para descoberta.
Séries temporais financeiras (trimestral/anual)
Obtém dados trimestrais ou anuais na aba Dados financeiros. type seleciona métricas; period1 e period2 para intervalo. Fundamentos históricos para gráficos e modelos.
Dados de gráfico (v3)
Obtém dados para desenhar gráfico em tela cheia com comparações, eventos (dividendos, desdobramentos) e pré/pós mercado. range e interval obrigatórios. Gráficos avançados para profissionais.
Detentores para símbolo
Obtém detentores (institucionais, principais, insiders) relacionados a um símbolo. region e lang opcionais. Detalhamento de propriedade para análise.
Relatórios breves para símbolo (v3)
Obtém relatórios breves relacionados a um símbolo. Preferido ao v2 para novas integrações. Relatórios de insight e destaques.
Preços de opções
Obtém preços de opções para um símbolo. Data, straddle, região e lang opcionais. Calls e puts com strikes e vencimentos.
Perfil do ticker
Obtém perfil do ticker (setor, indústria, funcionários, descrição, etc.). region e lang opcionais. Perfil da empresa para páginas de detalhe.
Histórico de upgrades e downgrades
Obtém históricos de upgrades e downgrades relacionados a um símbolo. region e lang opcionais. Mudanças de rating cronológicas.
Estatísticas para símbolo
Obtém estatísticas relacionadas a um símbolo. Endpoint de estatísticas preferido; region e lang opcionais. Avaliação, rentabilidade e métricas de mercado.
Seção Análise (Descontinuado)
Obtém dados da seção Análise. Descontinuado. Use endpoints de fundamentos ou insights em vez disso.
Balanço (Descontinuado)
Obtém dados da aba Balanço. Use stock/v2/get-timeseries e stock/get-fundamentals em vez disso.
Fluxo de caixa (Descontinuado)
Obtém aba Fluxo de caixa. Use stock/v2/get-timeseries e stock/get-fundamentals em vez disso.
Demonstração de resultado anual (Descontinuado)
Obtém dados da Demonstração de resultado anual. Use get-timeseries e get-fundamentals em vez disso; para trimestral use get-timeseries.
Detentores principais (Descontinuado)
Obtém aba Detentores principais. Prefira stock/v3/get-holders.
Aba Posições (Descontinuado)
Obtém aba Posições (fundo mútuo). Um símbolo. Use stock/get-top-holdings quando aplicável.
Lista de insiders (Descontinuado)
Obtém aba Lista de insiders na seção Detentores. Use get-fundamentals ou v3/get-holders.
Transações de insiders (Descontinuado)
Obtém aba Transações de insiders. Use módulos get-fundamentals.
Símbolos similares (Descontinuado)
Obtém símbolos similares e recomendados. Prefira stock/v2/get-recommendations.
Aba Estatísticas (Descontinuado)
Obtém aba Estatísticas. Use stock/get-fundamentals ou stock/v4/get-statistics em vez disso.
Upgrades e downgrades (Descontinuado)
Obtém upgrades e downgrades. Prefira stock/v3/get-upgrades-downgrades.
Balanço v3 (Descontinuado)
Obtém aba Balanço. Use get-timeseries e get-fundamentals em vez disso.
Aba Dados históricos (Descontinuado)
Obtém aba Dados históricos. Use stock/get-fundamentals em vez disso.
Estatísticas v3 (Descontinuado)
Obtém aba Estatísticas. Use stock/get-fundamentals ou stock/v4/get-statistics em vez disso.