A função HISTÓRICODEAÇÕES() do Excel exibe informações do histórico do preço de ações e taxas de câmbio em intervalos diários, semanais ou mensais. As informações são exibidas em formato de tabela, que pode ser composta por data, preço de fechamento, abertura, alta, baixa e volume, dependendo do que está disponível para a ação ou taxa pesquisada.

Nesse tutorial vou mostrar como usar a função HISTÓRICODEAÇÕES para obter o histórico do preço das ações da Petrobrás e a taxa cambial do dólar. Além de obter as informações em formato de tabela, vou mostrar também um exemplo de como obter cotação do dólar de um único dia e exibir em uma célula do Excel.

Uma observação importante é que a função HISTÓRICODEAÇÕES está disponível somente para assinantes do pacote Microsoft 365.

Como usar a função HISTÓRICODEAÇÕES

A função HISTÓRICODEAÇÕES possui a seguinte sintaxe:

=HISTÓRICODEAÇÕES(ações, data_início, [data_final], [intervalo], [cabeçalhos], [propriedade0], [propriedade1], [propriedade2], [propriedade3], [propriedade4], [propriedade5])

Segue a descrição de cada parâmetro da função:

ações: Preencha com a sigla da ação ou código da taxa cambial.
data_início: Preencha com a data de início para obter as informações do preço da ação ou taxa cambial.
data_final (opcional): Preencha com a data de término para obter as informações do preço da ação ou taxa cambial.
intervalo (opcional): Preencha com o intervalo para obter os dados, que pode ser 0 para diário, 1 para semanal e 2 para mensal.
cabeçalhos (opcional): Preencha com a opção desejada de cabeçalho, que pode ser 0 para não exibir cabeçalhos, 1 para mostrar cabeçalhos e 2 para exibir identificador e cabeçalhos do instrumento ou seja, exibe a sigla da bolsa de valores e da ação, separados por dois pontos. Por exemplo, para a ação da Petrobrás se usar o valor 2 para cabeçalho, o Excel exibe na primeira linha BVMF:PETR4 e na segunda linha o cabeçalho normal da tabela.
propriedade0 (opcional): Preencha com o valor 0 para exibir a coluna Data.
propriedade1 (opcional): Preencha com o valor 1 para exibir a coluna Fechamento.
propriedade2 (opcional): Preencha com o valor 2 para exibir a coluna Abertura.
propriedade3 (opcional): Preencha com o valor 3 para exibir a coluna Alto.
propriedade4 (opcional): Preencha com o valor 4 para exibir a coluna Baixo
propriedade5 (opcional): Preencha com o valor 5 para exibir a coluna Volume.

Os parâmetros propriedade0 até propriedade5 exibem as colunas Data, Fechamento, Abertura, Alto, Baixo e Volume. A ordem de exibição das colunas é determinada pela ordem que definimos os parâmetros propriedade. No exemplo abaixo o Excel exibe a tabela com as informações sobre os preços de ações da Microsoft. Observe que a coluna Abertura aparece antes da coluna Fechamento, porque alterei a ordem da propriedade1 com a propriedade 2.

Usando a função HISTÓRICODEAÇÕES

Apesar do nome da função indicar que o uso é para obter informações sobre o histórico de ações, a função também pode obter o histórico de taxas de câmbio de moedas.

Vou mostrar um exemplo de uso para cada um dos históricos, com o gráfico que criei para visualizar melhor a evolução dos valores

Exemplo de uso da função para obter o histórico de preço de ação da Petrobrás, com as informações do sigla da ação, data de início em janeiro e término na data atual e com o valor de fechamento semanal.

=HISTÓRICODEAÇÕES("PETR4";"01/01/2023";HOJE();1;1)

Exemplo de uso da função para obter taxa de câmbio do Dólar comparado com o Real, com as informações da sigla da taxa, data de início em janeiro e término em meados de janeiro e com o valor do fechamento diário.

=HISTÓRICODEAÇÕES("USD/BRL";"01/01/2023";"15/01/2023";0;1)

Usando a função HISTÓRICODEAÇÕES em uma célula

A função HISTÓRICODEAÇÕES retorna uma tabela com as informações de um histórico, mas e se quisermos somente o valor do fechamento de uma ação ou taxa de câmbio do dia anterior?

Podemos usar a mesma função com uma configuração específica dos parâmetros para obter a informação em uma célula.

=HISTÓRICODEAÇÕES("USD/BRL";HOJE()-1;;0;0;1)

A função acima exibe o valor da cotação do dólar no dia anterior. A função está configurada com a data de início como sendo do dia anterior, HOJE() -1, sem data de término, com intervalo do histórico diário, sem cabeçalho e somente com a coluna Fechamento.

Nesse caso tenha cuidado com o uso da função HOJE(). O problema do uso da função HOJE() para obter o valor de fechamento da ação é que pode apresentar o resultado #VALOR! ou seja, não retorna o valor no momento da requisição da informação pelo Excel. Isso acontece porque as bolsas de valores operam em horários diferentes pelo mundo.

Devido ao fuso horário entre os países e o momento em que você solicita a informação, pode acontecer da bolsa ainda não ter fechado e não possuir o valor de fechamento da ação ou câmbio. Se receber como resultado a informação #VALOR, tente fazer a chamada da função em outro horário.