Finanças · Yahoo Finance
API de dados de mercado do Yahoo Finance
API de dados de mercado do Yahoo Finance: dados ao vivo de Yahoo Finance no momento em que você pede, limpos e estruturados – prontos para seu próprio app, uma planilha ou um assistente de IA. Sem scraping, nada para manter.
100 requisições grátis por mês · sem cartão de crédito · uma chave de API para todas as plataformas
Fatos principais
Atualizado em
Dados de mercado são mais do que uma série de preços. O gráfico de um trader precisa do bloco meta com a faixa de 52 semanas e o nome da bolsa, timestamps alinhados ao calendário da bolsa, marcadores de dividendos e desdobramentos e, muitas vezes, um índice de referência sobreposto. Analistas também querem a cadeia de opções, quem detém a ação, o que os insiders estão fazendo e onde está o consenso. A everydata.io entrega cada uma dessas visões do Yahoo Finance como um endpoint GET em /yho, no formato JSON do próprio Yahoo, atualizado no momento da requisição.
- Plataforma
- Yahoo Finance
- Endpoint principal
- /stock-v3-get-chart
- Cota por chamada
- 1 requisição
- Plano gratuito
- 100 req. / mêsdepois, a partir de € 30 / mês
Dados de Yahoo Finance, prontos para usar
O endpoint de gráfico é o carro-chefe. /stock-v3-get-chart exige symbol, range e interval e retorna chart.result[0] com três partes: meta (currency, exchangeName, fullExchangeName, regularMarketPrice, regularMarketChangePercent, fiftyTwoWeekHigh, fiftyTwoWeekLow, regularMarketVolume, chartPreviousClose, dataGranularity, validRanges), um array timestamp[] em segundos epoch e indicators.quote[] com arrays paralelos open/high/low/close/volume, além de indicators.adjclose[]. Adicione events=div,split,earn para receber marcadores de dividendos, desdobramentos e resultados, comparisons=^GDAXI,^FCHI para sobrepor índices e includePrePost=true para barras do horário estendido.
Cinco endpoints irmãos completam o quadro do mercado. /stock-v3-get-options retorna optionChain.result[] com expirationDates, strikes e straddles por vencimento, junto com um bloco quote; /stock-v3-get-holders lista acionistas institucionais e fundos; /stock-v2-get-insider-transactions traz as compras e vendas recentes de insiders; /stock-v2-get-analysis contém recommendationTrend e earningsTrend; /stock-v3-get-insights acrescenta a leitura técnica e fundamentalista do Yahoo sobre o símbolo.
- meta do gráfico: regularMarketPrice, fiftyTwoWeekHigh/Low, regularMarketDayHigh/Low, exchangeName, timezone, dataGranularity
- timestamp[] com arrays OHLCV em indicators.quote[] e indicators.adjclose[] para qualquer combinação de range/interval
- Marcadores de eventos via events=div,split,earn e sobreposições via comparisons (ex.: ^GDAXI,^FCHI)
- Barras de pré e pós-mercado com includePrePost=true onde a bolsa oferece
- Cadeias de opções com expirationDates, strikes e linhas de straddle por vencimento
- Acionistas institucionais e fundos, transações de insiders, tendências de recomendações e de lucros, insights do Yahoo
- Parâmetro region (US, DE, GB, HK, IN e mais oito) para selecionar a edição do Yahoo
O que equipes criam com isso
Gráficos de preços interativos
Renderize candlesticks a partir de indicators.quote[] com marcadores de dividendos e desdobramentos vindos de events e deixe os usuários ativar a sobreposição de um índice via comparisons – os mesmos dados que o gráfico do próprio Yahoo desenha.
Análise de opções
Baixe a cadeia completa de um símbolo, calcule skews de volatilidade implícita e concentrações de open interest por vencimento e atualize os vencimentos mais próximos ao longo do dia dentro do seu limite de taxa.
Monitoramento de acionistas e insiders
Acompanhe mudanças nos acionistas institucionais e as transações recentes de insiders em uma lista de cobertura, com alertas quando um diretor vende ou a posição de um fundo dá um salto.
Acompanhamento do consenso de analistas
Armazene snapshots semanais de recommendationTrend e earningsTrend para mostrar como as contagens de strongBuy/hold/sell e as estimativas de LPA mudam até a temporada de resultados.
Requisição e resposta de exemplo
Ao contrário do endpoint de dados históricos, aqui range e interval são obrigatórios, porque definem a granularidade da série. Combine-os como o Yahoo faz: 1d com 1m ou 5m para uma visão intradiária, 1mo com 1d para um mês de barras diárias, 5y com 1wk para um gráfico de longo prazo. Consulte meta.validRanges na resposta para saber quais ranges o instrumento suporta.
GET /yho/stock-v3-get-chart
curl "https://api.everydata.io/yho/stock-v3-get-chart?symbol=AAPL&range=1mo&interval=1d®ion=US&events=div%2Csplit" \
-H "x-api-key: YOUR_API_KEY"Resposta (resumida)
{
"chart": {
"result": [
{
"meta": {
"currency": "USD",
"symbol": "AAPL",
"exchangeName": "NMS",
"fullExchangeName": "NasdaqGS",
"instrumentType": "EQUITY",
"regularMarketTime": 1789761602,
"timezone": "EDT",
"regularMarketPrice": 336.13,
"regularMarketChangePercent": -0.258,
"fiftyTwoWeekHigh": 344.57,
"fiftyTwoWeekLow": 243.42,
"regularMarketDayHigh": 338.49,
"regularMarketDayLow": 332.53,
"regularMarketVolume": 86241049,
"longName": "Apple Inc.",
"chartPreviousClose": 310.03,
"dataGranularity": "1d",
"range": "1mo",
"validRanges": [
"1d",
"5d",
"1mo",
"3mo",
"6mo",
"1y",
"2y",
"5y",
"10y",
"ytd",
"max"
]
},
"timestamp": [
1787146200,
1787232600
],
"indicators": {
"quote": [
{
"open": [
332.1,
334.77
],
"high": [
335.2,
338.34
],
"low": [
329.9,
330.18
],
"close": [
333.4,
337
],
"volume": [
41230100,
36700200
]
}
],
"adjclose": [
{
"adjclose": [
333.4,
337
]
}
]
}
}
]
}
}Leia a série por colunas: timestamp[i] corresponde a indicators.quote[0].close[i]. O Yahoo deixa null nos intervalos sem negócio, então filtre os nulls antes de montar o gráfico. Com events solicitado, um objeto events indexado por timestamp aparece ao lado de meta; com comparisons definido, cada símbolo extra chega em um array comparisons na mesma grade de timestamps, pronto para uma sobreposição de desempenho relativo.
Cadeias de opções são grandes. optionChain.result[0].expirationDates lista cada vencimento em segundos epoch e options[] contém uma entrada por vencimento com linhas straddles que emparelham a call e a put em cada strike. Holders, transações de insiders e analysis retornam os módulos quoteSummary correspondentes – institutionOwnership, insiderTransactions, recommendationTrend, earningsTrend – com os valores {raw, fmt} de sempre.
Dois limites, com franqueza. Quatro endpoints do catálogo – market-get-watchlist-detail, market-get-watchlist-performance, conversations-count e conversations-v2-list – respondem com HTTP 501 porque o Yahoo desativou seus serviços públicos de watchlist e de conversas (Canvass); as rotas continuam para que os clientes falhem de forma limpa. E estes são os dados de mercado que o Yahoo mostra publicamente: em tempo real ou com atraso, conforme a bolsa, feitos para pesquisa, dashboards e screeners, não como feed licenciado para execução de ordens.
Endpoints relacionados
Gráfico. Séries de gráfico com eventos e comparações.
Opções. Cadeia de opções.
Acionistas. Acionistas institucionais e fundos.
Transações de insiders. Negociações recentes de insiders.
Análise. Tendências de lucros e de recomendações.
Pague por requisição, todas as plataformas incluídas
Uma chamada de gráfico com events e dois índices de comparação continua sendo uma requisição, assim como uma cadeia de opções completa. Dashboards intradiários que atualizam 20 símbolos a cada cinco minutos durante um pregão de 7 horas precisam de cerca de 1.700 requisições por dia – o plano Production (50.000 requisições, € 80, 100 por minuto) cobre isso com folga; o Business (300.000, € 300, 250 por minuto) escala para uma pequena mesa de operações. Requisições que falham do lado do Yahoo com 5xx não são contabilizadas.
- Free
- 100 req. / mês
- Starter
- 5.000 req. · € 30
- Production
- 50.000 req. · € 80
- Business
- 300.000 req. · € 300
API de dados de mercado do Yahoo Finance: perguntas frequentes
Quais combinações de range e interval são válidas?
range aceita 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd e max; interval aceita 1m, 2m, 5m, 15m, 30m, 60m, 1d, 1wk e 1mo. Intervalos de minutos só funcionam com ranges curtos (1m para até 7 dias). meta.validRanges, presente em toda resposta, lista o que o instrumento suporta.
Consigo obter preços de pré-mercado e after-hours?
Sim. Adicione includePrePost=true à requisição de gráfico para símbolos em que meta.hasPrePostMarketData seja true. As barras do horário estendido aparecem nos mesmos arrays, e currentTradingPeriod informa os limites das sessões pre, regular e post.
Como adiciono marcadores de dividendos e desdobramentos a um gráfico?
Passe events=div,split (adicione earn para as datas de resultados). A resposta ganha um objeto events indexado por timestamp, com o valor dos dividendos e o numerator/denominator dos desdobramentos.
Por que alguns endpoints retornam HTTP 501?
market-get-watchlist-detail, market-get-watchlist-performance, conversations-count e conversations-v2-list dependem de serviços do Yahoo que não existem mais publicamente. Eles retornam 501 com uma mensagem explicativa em vez de dados inventados e nunca são cobrados.
Os dados servem para operar ao vivo?
São os dados exibidos publicamente pelo Yahoo Finance, em tempo real para algumas bolsas e com atraso de 15 a 20 minutos para outras. Eles se prestam bem a pesquisa, análises e dashboards; para execução de ordens, use um feed licenciado da bolsa.
Casos de uso relacionados
Desenhe seu primeiro gráfico com dados ao vivo
Cadastre-se gratuitamente e chame GET /yho/stock-v3-get-chart?symbol=AAPL&range=1mo&interval=1d – os arrays completos de meta, timestamp e OHLCV chegam em um único documento JSON.