Integre os dados da FMP ao Excel / Google Sheets

O FMP é o suplemento definitivo do Excel e do Google Sheets para investidores. O FMP foi criado com um único objetivo: permitir que qualquer pessoa encontre rapidamente boas oportunidades de investimento. Nosso suplemento oferece muitos recursos e conjuntos de dados, como demonstrações financeiras, principais indicadores, dados de dividendos, preços em tempo real, dados de criptomoedas, commodities e muito mais. Criamos esta documentação para ajudar você a aproveitar o FMP ao máximo.

Informações importantes

1. O suplemento oferece as mesmas funcionalidades no Excel, no Google Sheets e no Excel Online.

2. No momento, não temos nenhuma cota de dados. A única cota é imposta pelo Google Sheets: você pode fazer 20 mil requisições por dia em contas comuns e 100 mil em contas pagas. Esse limite é redefinido automaticamente a cada 24 horas. Ainda assim, pedimos que os usuários evitem fazer requisições simultâneas em excesso. Se identificarmos qualquer tipo de abuso do sistema, poderemos suspender sua conta.

Instalação

Excel

Instalar o FMP no Excel é muito simples. Siga estas etapas:

1. Abra uma nova planilha do Excel.

2. Acesse Suplementos (Add-ins) na guia Página Inicial.

3. Clique em Mais Suplementos (More Add-ins).

4. Pesquise o suplemento FMP.

5. Clique em Adicionar (Add).

Agora você pode abrir o suplemento a qualquer momento pela guia Página Inicial.

Google Sheets

Instalar o FMP no Google Sheets é muito simples. Siga estas etapas:

1. Abra uma nova planilha do Google Sheets.

2. Abra o menu Extensões (Extensions), selecione Complementos (Add-ons) e depois Instalar complementos (Get add-ons). O Google Workspace Marketplace será aberto em uma janela pop-up.

3. Pesquise por FMP.

4. Selecione o complemento FMP e clique em Instalar (Install).

Agora você pode abrir o complemento a qualquer momento pelo menu Extensões.

Suporte

Se você tiver algum comentário ou encontrar algum problema, fique à vontade para nos enviar um e-mail para info@financialmodelingprep.com.

Statement Dump

Se você quer uma visão geral das finanças de uma empresa, uma das melhores formas é usar o Statement Dump. Em poucos cliques, você obtém a demonstração do resultado (DRE), o balanço patrimonial, a demonstração dos fluxos de caixa, os principais indicadores e os indicadores de crescimento, anuais ou trimestrais, diretamente na sua planilha. Você obtém os dados dos últimos 19 anos ou de 72 trimestres, conforme sua preferência.

Por padrão, os dados são ordenados do mais recente para o mais antigo. Com uma conta pro, você pode clicar na opção avançada para inverter a ordem das demonstrações.

Melhor ainda, você pode obter as demonstrações financeiras exatamente como foram reportadas à SEC. Basta selecionar as demonstrações "SEC as reported" e escolher dados anuais ou trimestrais.

Observação: isso se aplica apenas a empresas que reportam à SEC (U.S. Securities and Exchange Commission, a comissão de valores mobiliários dos EUA).

Função FMP

Esta função é a mais indicada para demonstrações financeiras, principais indicadores, receitas por segmento, estimativas de analistas e muito mais (veja os dados disponíveis por função).

A sintaxe da função FMP é =FMP("ticker/s", "parameter/s", "period/s", ["quarter"], [divisor])

• Ticker(s) [obrigatório]: o símbolo ou os símbolos das empresas das quais você quer dados. Pode ser digitado, por exemplo "AAPL", ou uma referência de célula, por exemplo A1.
• Parâmetro(s) [obrigatório]: os dados que você quer que a função retorne. Aceita um ou mais parâmetros. Pode ser digitado, por exemplo "Revenue", ou uma referência de célula, por exemplo B1:D1.
• Período(s) [obrigatório]: o ano ou o período que você quer. Aceita um ou mais períodos. Pode ser digitado, por exemplo 2020, ou uma referência de célula, por exemplo B1:D1.
• Os períodos incluem anos específicos, como 2020, "TTM" (últimos doze meses), "LY", "LY-1" e assim por diante (o último exercício fiscal disponível, o anterior e assim por diante), e "LQ", "LQ-1" e assim por diante (o último trimestre fiscal disponível, o anterior e assim por diante).
• Trimestre [opcional]: o trimestre do qual você quer dados (apenas para dados trimestrais). Pode ser digitado, por exemplo "Q2", ou uma referência de célula, por exemplo B1.
• Divisor [opcional]: use-o para obter o resultado em milhões, bilhões ou qualquer outra unidade. Pode ser digitado, por exemplo 1000000, ou uma referência de célula, por exemplo B1.

Veja alguns exemplos de chamadas de função válidas:

=FMP("AAPL","ROE","TTM")

=FMP("TSLA", "Revenue", "LY",,1000000)

=FMP("AAPL","Free Cash Flow",2019,"Q3")

Grandes volumes de dados

Em vez de fazer muitas chamadas de função de uma vez, você pode obter os dados mais rapidamente usando intervalos nas funções.

Basta inserir um intervalo de tickers em vez de um único ticker, um intervalo de parâmetros em vez de um único parâmetro ou um intervalo de períodos em vez de um único período. Por exemplo, com os tickers em A2:A5, os parâmetros em B1:D1 e os períodos em E1:G1:

=FMP(A2:A5, B1:D1, E1:G1)

Essa única chamada de função retorna todos os indicadores de todas as empresas em todos os períodos. Ela economiza muito tempo e deixa sua planilha mais rápida.

Função FMPPRICE

Esta função é a mais indicada para preços em tempo real, preços históricos, informações sobre pagamentos de dividendos e muito mais (veja os dados disponíveis por função).

A sintaxe da função FMPPRICE é =FMPPRICE("ticker/s", "parameter/s", number of days to end, "start date", "end date")

• Ticker(s) [obrigatório]: o símbolo ou os símbolos das empresas das quais você quer dados. Pode ser digitado, por exemplo "AAPL", ou uma referência de célula, por exemplo A1:A20.
• Parâmetro(s) [obrigatório]: os dados que você quer que a função retorne. Aceita um ou mais parâmetros. Pode ser digitado, por exemplo "Price", ou uma referência de célula, por exemplo B1:D1.
• Número de dias até o fim [opcional]: para preços históricos, o número de dias a retornar. Por exemplo, 5 retorna os preços históricos dos últimos 5 dias. Pode ser digitado, por exemplo 5, ou uma referência de célula, por exemplo B2.
• Data inicial [opcional]: para preços históricos, uma data inicial específica. Deve ser uma célula formatada como data ou seguir o formato "mm/dd/yyyy". Pode ser digitada, por exemplo "01/30/2022", ou uma referência de célula, por exemplo B1. Se você inserir apenas uma data inicial, a função retornará o valor dessa data específica.
• Data final [opcional]: para preços históricos, uma data final específica. Deve ser uma célula formatada como data ou seguir o formato "mm/dd/yyyy". Pode ser digitada, por exemplo "01/30/2022", ou uma referência de célula, por exemplo B1.

Veja alguns exemplos de chamadas de função válidas:

=FMPPRICE("TSLA","Price")

=FMPPRICE("AAPL", "Close",,"01/01/2022", "01/30/2022")

=FMPPRICE("AMZN", "Open", 2)

Grandes volumes de dados

Em vez de fazer muitas chamadas de função de uma vez, você pode obter os dados mais rapidamente usando intervalos nas funções.

Basta inserir um intervalo de tickers em vez de um único ticker ou um intervalo de parâmetros em vez de um único parâmetro. Por exemplo, com os tickers em A2:A10 e os parâmetros em B1:D1:

=FMPPRICE(A2:A10, B1:D1)

Essa única chamada de função retorna todos os valores em tempo real de todas as empresas. Ela economiza muito tempo e deixa sua planilha mais rápida.

Você também pode inserir vários tickers para obter preços históricos de muitos ativos de uma vez, por exemplo =FMPPRICE(A2:A5, "Close", 10).

Função FMPFUNDS

Esta função é a mais indicada para dados de ETFs e fundos, como taxa de administração (expense ratio), valor patrimonial líquido (NAV), patrimônio sob gestão (AUM) e muito mais (veja os dados disponíveis por função).

A sintaxe da função FMPFUNDS é =FMPFUNDS("ticker/s", "parameter/s")

• Ticker(s) [obrigatório]: o símbolo ou os símbolos dos ETFs ou fundos dos quais você quer dados. Pode ser digitado, por exemplo "SPY", ou uma referência de célula, por exemplo A1.
• Parâmetro(s) [obrigatório]: os dados que você quer que a função retorne. Aceita um ou mais parâmetros. Pode ser digitado, por exemplo "expense ratio", ou uma referência de célula, por exemplo B1:D1.

Veja alguns exemplos de chamadas de função válidas:

=FMPFUNDS("SPY","Expense Ratio")

=FMPFUNDS("PICK","Nav")

Grandes volumes de dados

Em vez de fazer muitas chamadas de função de uma vez, você pode obter os dados mais rapidamente usando intervalos nas funções.

Basta inserir um intervalo de parâmetros e/ou tickers em vez de um único valor. Por exemplo, com os tickers dos fundos em A2:A5 e os parâmetros em B1:D1:

=FMPFUNDS(A2:A5, B1:D1)

Essa única chamada de função retorna todos os parâmetros em tempo real de todos os fundos. Ela economiza muito tempo e deixa sua planilha mais rápida.

Refresh Data

A qualquer momento, você pode usar o botão Refresh Data, no canto superior direito do suplemento, para atualizar os dados em tempo real da sua planilha.

Isso inclui:

• Preços em tempo real
• Indicadores TTM
• Dados de ETFs/fundos

Refresh Errors

Ao solicitar grandes volumes de dados de uma vez, você pode ocasionalmente receber um #ERROR! no Google Sheets ou "too many simultaneous requests" (requisições simultâneas em excesso) no Excel.

Em vez de corrigir cada uma dessas células manualmente, pressione o botão Refresh Errors (ícone de chave inglesa) no canto superior direito do suplemento. Ele corrige todas de uma vez.

Ações em alta

Você pode acompanhar as ações em alta e as mais populares diretamente no painel principal. Ele foi projetado para tornar o acompanhamento do mercado mais rápido e fácil.

Top Gainers: descubra quais ações estão disparando.

Top Losers: veja quais ações sofreram quedas.

Most Active: encontre as ações com o maior volume de negociação.

Clique na seta suspensa de uma categoria para exibir mais ações dessa lista, sejam as maiores altas, as maiores baixas ou as mais negociadas.

Clique em qualquer ticker para ver as informações essenciais, como:

• Preço, valor de mercado e volume, todos atualizados em tempo real.
• Indicadores de desempenho, como retorno no ano (YTD) e índice P/L.
• Manchetes de notícias da empresa para você se manter informado.
• Para empresas dos EUA, documentos oficiais arquivados para uma análise mais aprofundada.

Function Builder

Em vez de descobrir qual função usar para cada dado, deixe o Function Builder gerá-la para você.

Veja como funciona:

Símbolos: comece inserindo o(s) ticker(s) das empresas que você quer analisar. Pode ser um único ticker, como "AAPL", ou uma lista, se você estiver analisando várias ações ao mesmo tempo.

Observação: você também pode trocar a pesquisa pela seleção de um intervalo de tickers, por exemplo A2:A5.

Parâmetros (se aplicável): escolha o indicador financeiro ou o parâmetro de dados de que você precisa. As opções incluem indicadores como "Revenue", "Net Income" e outros das demonstrações financeiras da empresa. Assim, você pode criar relatórios personalizados especificando exatamente quais dados extrair.

Observação: alguns parâmetros não podem ser selecionados junto com outros. Nesse caso, eles aparecem esmaecidos.

Períodos (se aplicável): selecione o período, como o ano ou o trimestre, do qual você precisa dos dados. Por exemplo, inserir 2021 busca os dados anuais desse ano.

Datas específicas (se aplicável): insira as datas exatas de início e fim do período de que você precisa. Por exemplo, definir 2024-10-31 como data inicial e final busca os dados apenas desse dia. Isso é ideal para indicadores diários precisos, e você pode incluir uma coluna de data nos resultados para manter seus dados bem documentados. Como alternativa, defina um intervalo maior para capturar tendências históricas dentro do período selecionado.

Observação: como alternativa, use a opção "Number of days" para obter os dados de um período recente, como os últimos 10 dias. Selecione-a e insira o número de dias, e o FMPsheets extrai automaticamente os dados dos últimos 10 dias úteis até hoje. Isso é útil para uma análise rápida de tendências de curto prazo sem precisar inserir intervalos de datas manualmente.

Seleção do trimestre (se aplicável): para dados trimestrais, você pode escolher um trimestre específico para restringir o período, permitindo uma análise direcionada dentro do exercício fiscal.

Fórmula gerada: depois de fazer suas seleções, o FMPsheets gera a fórmula correta. Por exemplo, inserir "AAPL" como símbolo, "Revenue" como parâmetro e "2021" como período produz =FMP("AAPL", "Revenue", 2021), que você pode copiar diretamente.

Análise das demonstrações financeiras

Há 2 formas de analisar as demonstrações financeiras de uma ação. A primeira é o Statement Dump, que obtém todas as demonstrações de uma vez, anuais ou trimestrais, no nosso formato padronizado ou exatamente como reportadas à SEC.

A segunda é usar a função FMP para obter apenas os dados financeiros que interessam a você. Escolha os parâmetros de que precisa entre os dados disponíveis e monte um modelo de planilha em torno deles, por exemplo com o ticker em A1, os parâmetros em A2:A10 e os períodos em B1:D1:

=FMP(A1, A2:A10, B1:D1)

Uma única chamada de função retorna todos os dados financeiros de que você precisa. Você pode usar anos específicos no lugar de LY, LY-1 e assim por diante, ou usar LQ, LQ-1 e assim por diante para obter dados de vários trimestres.

Análise de preços em tempo real

Analisar preços em tempo real de ações, ETFs e outros ativos é fácil com o FMP. Um caso de uso típico é pegar as ações da sua carteira ou lista de acompanhamento e extrair todos os indicadores em tempo real que interessam a você (veja os dados disponíveis).

Para dados em tempo real, use a função FMPPRICE. Por exemplo, com os tickers em A2:A10 e parâmetros em tempo real, como "Price", em B1:D1:

=FMPPRICE(A2:A10, B1:D1)

Essa é a melhor forma de obter dados em tempo real de vários ativos. Você obtém os dados mais rapidamente e pode atualizá-los a qualquer momento com o botão Refresh Data, no canto superior direito do suplemento.

Análise de preços históricos

Há 2 formas principais de obter preços históricos de ações, ETFs e outros ativos cobertos. A primeira é para ativos individuais.

Por exemplo, para obter os preços de fechamento da Apple dos últimos 30 dias, insira:

=FMPPRICE("AAPL", "Close", 30)

Você também pode inserir datas específicas na função, por exemplo =FMPPRICE("AMZN", "close", , "01/01/2019", "01/10/2019")

A segunda é para várias ações: insira um intervalo de tickers na função, por exemplo =FMPPRICE(A2:A5, "Close", 30).

Histórico de pagamentos de dividendos

Com a função FMPPRICE, você pode obter todos os dados de dividendos em uma única chamada de função. Basta inserir =FMPPRICE("AAPL", "dividend")

Isso fornece a data ex-dividendo, o dividendo, o dividendo ajustado, a data de pagamento e a data de declaração.

Você também pode inserir datas específicas na função, por exemplo =FMPPRICE("aapl", "dividend", , "01/01/2017", "01/01/2022")

Dividendos anuais

Obter o pagamento anual de dividendos de uma ação ou ETF é simples. Com a função FMP, insira:

=FMP("AAPL", "Dividend", 2022)

Isso retorna a soma de todos os pagamentos de dividendos feitos durante aquele ano.

Para o valor do dividendo ajustado, insira:

=FMP("AAPL", "Adjusted Dividend", 2022)

Você também pode obter esse número para vários anos de uma vez, por exemplo =FMP("AAPL", "Dividend", {2022, 2021, 2020}).

Dividendos trimestrais

Com a função FMP, é simples obter os pagamentos de dividendos anteriores de ações e ETFs. Obtenha os pagamentos trimestrais individuais de dividendos da seguinte forma:

=FMP("AAPL", "dividend", "LQ")

Isso retorna o último dividendo pago por uma ação ou ETF. O mesmo vale para o dividendo ajustado.

Receitas por segmento e região geográfica

Você pode obter a composição da receita de uma empresa entre seus principais segmentos de negócio e mercados geográficos.

Com a função FMP, você pode obter esses dados em base trimestral e anual.

Para a composição da receita por segmento, use a função da seguinte forma:

=FMP("AAPL", "segment revenues", 2020)

Você também pode substituir o ano por "LY", "LY-1", "LY-2" e assim por diante, o que fornece o último exercício fiscal ou os exercícios fiscais anteriores.

O mesmo vale para as receitas por região geográfica:

=FMP("AAPL", "geographic revenues", "LQ-2")

Devido a limitações técnicas, os dados trimestrais aceitam apenas o sistema de períodos LQ, LQ-1.

*Este recurso está disponível apenas para empresas que reportam à SEC, já que os dados vêm desses relatórios.

Estimativas de analistas

Com o FMP, você pode obter estimativas de analistas para indicadores financeiros como receita, EBITDA, lucro líquido e muito mais (veja os dados disponíveis).

As estimativas vêm de relatórios dos principais analistas de instituições financeiras como Morgan Stanley, Citigroup e JP Morgan, entre outras.

Para obter muitas estimativas de analistas de uma empresa de uma vez, insira um intervalo de parâmetros de estimativa (aqui em B1:D1) e os anos de que você precisa:

=FMP("AAPL", B1:D1, {2027, 2026, 2025})

Observe que as estimativas de analistas vão atualmente até 2029. Dados históricos de anos anteriores também estão disponíveis.

Dados de ETFs/fundos

Além dos preços em tempo real, preços históricos e dados de dividendos obtidos com as funções FMP e FMPPRICE, você pode usar a função FMPFUNDS para obter dados específicos de ETFs, como NAV, taxa de administração (expense ratio), patrimônio sob gestão (AUM) e muito mais (veja os dados disponíveis).

Por exemplo, para obter o NAV, o AUM e a taxa de administração do ETF SPY, coloque esses parâmetros em B1:D1 e insira:

=FMPFUNDS("SPY", B1:D1)

Isso fornece os dados de que você precisa sobre seus fundos em tempo real.

Observação: esta função está em versão beta, e mais fundos e ETFs serão adicionados.

Screener personalizado (Get List)

Assinantes do plano FMP Elite podem encontrar empresas que atendam aos seus critérios específicos. Veja como funciona:

• Abra a guia Screener do suplemento e selecione Get List.
• Insira os filtros pelos quais deseja pesquisar, como valor de mercado, dividend yield, setor, indústria ou bolsa.
• Clique em Get Data quando estiver pronto.

Isso retorna uma lista de empresas, ETFs e/ou fundos que atendem aos seus critérios, com as informações disponíveis, como nome da empresa, setor, indústria, beta e preço.

Em seguida, você pode pegar essa lista de tickers e obter qualquer informação e indicador adicional de uma só vez, usando o método abaixo.

Screener personalizado (Get Data)

Criar um screener de ações personalizado com os dados de que você precisa é simples com o FMP (assinantes Pro e Elite). Veja tudo o que você precisa fazer:

• Tenha uma lista de ações na sua planilha do Excel ou do Google Sheets. Você também pode usar o screener Get List descrito acima.
• Selecione os parâmetros dos quais você quer dados. Eles incluem a demonstração do resultado (DRE), o balanço patrimonial, a demonstração dos fluxos de caixa, os principais indicadores, os indicadores de crescimento e os preços em tempo real. Veja a lista completa de itens.

Depois de ter a lista de ações e de parâmetros, abra a seção FMP Screener do suplemento.

Na seção FMP Screener, use o mouse para selecionar os tickers dos quais você quer dados. Em seguida, clique no ícone de quatro quadrados.

Depois, faça o mesmo com os parâmetros que você escolheu. Não se esqueça de incluir o período no parâmetro. Atualmente, os períodos incluem:

• TTM (últimos doze meses)
• LY (último exercício fiscal)
• LY-1 e assim por diante (exercícios fiscais anteriores), até LY-17
• LQ (último trimestre fiscal)
• LQ-1 e assim por diante (trimestres fiscais anteriores), até LQ-71
• Anos específicos, como 2020
• Ano e trimestre específicos, como 2020 Q4

Se você omitir o período, o padrão será LY (último exercício fiscal). Letras maiúsculas/minúsculas e espaços não fazem diferença. Não é necessário especificar um período para dados em tempo real.

Depois de concluir essas etapas, clique no botão "Get Data" e seu screener será gerado. É criado um bucket que armazena os tickers e os parâmetros que você selecionou.

Você pode atualizar os dados do screener a qualquer momento com o botão de atualização do bucket. Também pode renomear o bucket para consultas futuras ou excluí-lo quando não precisar mais dele.

Lembre-se de que um bucket só pode ser atualizado na aba da planilha que contém seus tickers e parâmetros. Atualizá-lo a partir de outra aba da sua planilha não funcionará.

A vantagem do FMP Screener é que ele retorna e atualiza os dados mais rapidamente do que as funções. Ele também permite aplicar filtros, como ordenar as empresas pela maior receita, sem que as funções sejam atualizadas automaticamente.

Acompanhar/comparar criptomoedas

Comparar ou acompanhar criptomoedas com o FMP é muito simples. Aqui está a lista completa de criptomoedas oferecidas atualmente (mais de 4.700).

Use o ticker sem o "-". Por exemplo, para o preço do Bitcoin em dólares americanos, use BTCUSD em vez de BTC-USD.

Há dois tipos de dados de criptomoedas: dados em tempo real e preços históricos.

Para acompanhar ou comparar criptomoedas com dados em tempo real, use a função FMPPRICE, por exemplo com os tickers das criptomoedas em A2:A5:

=FMPPRICE(A2:A5, "Price")

Isso fornece o preço em tempo real e outras informações relevantes das criptomoedas que você escolheu. Use o botão Refresh Data, no canto superior direito do suplemento, a qualquer momento para atualizar as funções e ver os dados em tempo real mais recentes.

Os preços históricos são igualmente fáceis de obter com a função FMPPRICE.

Por exemplo, para obter o preço de fechamento do Bitcoin em dólares americanos dos últimos 10 dias, insira =FMPPRICE("BTCUSD", "Close", 10)

Ou obtenha os dados de um período específico, por exemplo =FMPPRICE("BTCUSD", "Close", , "01/01/2024", "01/30/2024")

Você pode obter dados históricos de muitas criptomoedas de uma vez, por exemplo =FMPPRICE(A2:A5, "Close", 10).

Taxas de câmbio (Forex)

Comparar ou acompanhar taxas de câmbio com o FMP é muito simples. Aqui está a lista completa de pares de moedas oferecidos atualmente (mais de 1.540).

Use o ticker sem o "=X". Por exemplo, para o dólar canadense em dólares americanos, use CADUSD em vez de CADUSD=X.

Há dois tipos de dados de moedas: dados em tempo real e preços históricos.

Para acompanhar ou comparar taxas de câmbio com dados em tempo real, use a função FMPPRICE, por exemplo com os pares de moedas em A2:A5:

=FMPPRICE(A2:A5, "Price")

Isso fornece a taxa em tempo real e outras informações relevantes dos pares de moedas que você escolheu. Use o botão Refresh Data, no canto superior direito do suplemento, a qualquer momento para atualizar as funções e ver os dados em tempo real mais recentes.

Os preços históricos são igualmente fáceis de obter com a função FMPPRICE.

Por exemplo, para obter a taxa de fechamento do dólar americano em relação ao dólar canadense dos últimos 10 dias, insira =FMPPRICE("USDCAD", "Close", 10)

Ou obtenha os dados de um período específico, por exemplo =FMPPRICE("USDCAD", "Close", , "01/01/2024", "01/30/2024")

Você pode obter dados históricos de muitos pares de moedas de uma vez, por exemplo =FMPPRICE(A2:A5, "Close", 10).

Análise de commodities/futuros

Analisar commodities e contratos futuros com o FMP é muito simples. Aqui está a lista completa de commodities/futuros oferecidos atualmente (mais de 40).

Certifique-se de usar exatamente os símbolos da lista.

Há dois tipos de dados de commodities e futuros: dados em tempo real e preços históricos.

Para acompanhar ou comparar preços com dados em tempo real, use a função FMPPRICE, por exemplo com os símbolos das commodities em A2:A5:

=FMPPRICE(A2:A5, "Price")

Isso fornece o preço em tempo real e outras informações relevantes das commodities que você escolheu. Use o botão Refresh Data, no canto superior direito do suplemento, a qualquer momento para atualizar as funções e ver os dados em tempo real mais recentes.

Os preços históricos são igualmente fáceis de obter com a função FMPPRICE.

Por exemplo, para obter o preço de fechamento dos futuros de farelo de soja dos últimos 10 dias, insira =FMPPRICE("ZMUSD", "Close", 10)

Ou obtenha os dados de um período específico, por exemplo =FMPPRICE("ZMUSD", "Close", , "01/01/2024", "01/30/2024")

Você pode obter dados históricos de muitas commodities de uma vez, por exemplo =FMPPRICE(A2:A5, "Close", 10).

Acompanhamento de índices

Seja para comparar o desempenho dos seus investimentos com um benchmark ou para acompanhar índices como o S&P 500, obter dados de índices com o FMP é muito simples. Aqui está a lista completa de índices oferecidos atualmente (mais de 190).

Certifique-se de usar exatamente os símbolos da lista.

Há dois tipos de dados de índices: dados em tempo real e preços históricos.

Para acompanhar ou comparar cotações de índices com dados em tempo real, use a função FMPPRICE, por exemplo com os símbolos dos índices em A2:A5:

=FMPPRICE(A2:A5, "Price")

Isso fornece o valor em tempo real e outras informações relevantes dos índices que você escolheu. Use o botão Refresh Data, no canto superior direito do suplemento, a qualquer momento para atualizar as funções e ver os dados em tempo real mais recentes.

Os preços históricos são igualmente fáceis de obter com a função FMPPRICE.

Por exemplo, para obter o fechamento do S&P 500 dos últimos 10 dias, insira =FMPPRICE("^GSPC", "Close", 10)

Ou obtenha os dados de um período específico, por exemplo =FMPPRICE("^GSPC", "Close", , "01/01/2024", "01/30/2024")

Você pode obter dados históricos de muitos índices de uma vez, por exemplo =FMPPRICE(A2:A5, "Close", 10).

Problemas comuns

Estes são os problemas mais comuns ao usar o suplemento, junto com suas soluções.

Não encontro o ticker de uma ação internacional

O FMP usa o mesmo sistema de tickers da documentação da API. Use a pesquisa ou, melhor ainda, a pesquisa do Statement Dump para encontrar o ticker correto.

Insira o ticker normal seguido do sufixo da bolsa. Por exemplo, a Telus é uma empresa canadense listada na TSX: seu ticker é "T" e o sufixo é ".TO", então insira "T.TO" para obter seus dados (veja as bolsas disponíveis e seus sufixos).

Não consigo fazer login no Google Sheets

Às vezes, extensões do Chrome ou bloqueadores de anúncios bloqueiam nosso sistema de autenticação, que nos permite reconhecer sua conta.

Há também um problema conhecido do Google que nos impede de autenticar sua conta quando você está conectado a várias contas do Google ao mesmo tempo.

Em qualquer um dos casos, não se preocupe: você pode resolver com uma destas soluções simples.

Solução 1:

• Exclua o complemento
• Atualize a página
• Desative seu bloqueador de anúncios no Google Sheets
• Limpe o cache
• Reinstale o FMP

Solução 2:

• Crie um novo perfil no Google Chrome
• Abra sua planilha no novo perfil
• Use o FMP normalmente

Funções retornam #NAME? no Excel

Depois de instalar o FMP no Excel, talvez você consiga usar o Statement Dump, mas não as funções personalizadas.

Na maioria dos casos, isso acontece porque a Microsoft exige uma conta do Office 365 para usar funções personalizadas em planilhas.

Soluções

• Use o FMP no Excel Online ou no Google Sheets (não é necessária uma assinatura do Office 365).
• Use uma conta do Office 365 do trabalho, da instituição de ensino ou de qualquer outra organização, se tiver acesso a uma.

Células contêm _xldudf_ no Excel

Isso normalmente acontece quando você salva seus arquivos do Excel em um armazenamento em nuvem, como o OneDrive, ou quando outro suplemento interfere nas funções personalizadas.

Não se preocupe. Há uma forma fácil de corrigir todas as chamadas de função de uma vez e uma forma de evitar que isso aconteça.

Soluções

1. Pressione o botão "Refresh Errors" no canto superior direito do suplemento. Ele encontra essas células e limpa todas de uma vez.

2. Use o recurso Localizar e Substituir do Excel (Ctrl+H) para substituir o conteúdo de todas as células de uma aba de uma vez: localize _xldudf_ e substitua tudo por nada. =_xldudf_FMP(...) volta a ser =FMP(...).

Prevenção

Para evitar que isso aconteça, tente o seguinte:

• Acesse Arquivo / Opções
• Selecione Suplementos (Add-ins) (perto da parte inferior, à esquerda), depois Gerenciar (perto da parte inferior) e "Ir"
• Desmarque os suplementos que você não usa e que possam interferir no suplemento FMP
• Salve seus arquivos do Excel localmente em vez de na nuvem

Erro de URL Fetch

URL Fetch é um limite do Google Sheets para solicitação de dados.

Cada chamada de função faz uma chamada URL Fetch para obter os dados.

O Google limita essas chamadas a 20 mil por dia para usuários comuns e 100 mil para contas pagas. O limite é redefinido automaticamente todos os dias.

Soluções

Há duas soluções. A primeira é usar o screener, conforme descrito em Screener personalizado (Get Data).

A segunda é usar intervalos nas funções, para obter mais dados fazendo menos chamadas de função.

Como alternativa, use o FMP no Excel, que não tem limites de URL Fetch, ou faça upgrade da sua conta do Google para uma conta empresarial.

Erro #SPILL!

O erro #SPILL! ocorre no Excel ou no Google Sheets quando uma função retorna uma matriz (vários valores a partir de uma única função) e não há espaço para exibi-los.

Por exemplo, =FMPPRICE("AAPL", "close", 3) retorna uma matriz com a data e o preço de fechamento dos últimos 3 pregões.

Se alguma das células onde essa matriz ficaria já contiver dados, a função retornará #SPILL! em vez dos valores.

Solução

A correção é simples: limpe os dados das células de que a função precisa. O erro desaparece e a função exibe os dados que você quer.