Complemento do Google Sheets
O complemento do Google Sheets do Stock Events traz os dados da sua carteira diretamente para o Sheets. Acesse preços de ações em tempo real, métricas de dividendos, participações da carteira e detalhes de posições individuais — tudo atualizado automaticamente na sua planilha.
Instalando o Complemento
- Abra o app no Marketplace
- Clique em Adicionar para instalar.
- Depois de instalado, um botão do Stock Events aparecerá na guia Extensões da faixa de opções nos seus arquivos do Google Sheets.
Fazendo Login
O complemento usa um fluxo de login baseado em dispositivo. Você faz a autenticação no navegador, e o complemento reconhece a sessão automaticamente.
- Clique no botão Stock Events na guia Início para abrir o painel lateral.
- Clique em Login. Uma janela do navegador será aberta.
- Entre com sua conta do Stock Events no navegador. Se você já estiver logado, a conexão será concluída automaticamente.
- Volte para o Sheets. O painel lateral será atualizado para mostrar seu nome de usuário e a lista das suas carteiras.
Você só precisa fazer login uma vez. A sessão permanece ativa até que você saia manualmente ou sua assinatura Pro expire.
Saindo
Clique em Sair na parte inferior do painel lateral. Todas as funções pararão de retornar dados e mostrarão #LOGIN! até que você faça login novamente.
Usando Funções
Todas as funções usam o namespace STOCKEVENTS. Digite =STOCKEVENTS. em qualquer célula e o Sheets mostrará a lista completa de funções disponíveis.
Dados de Mercado
Essas funções usam o símbolo do ticker da ação como entrada.
=STOCKEVENTS_STOCK_PRICE("AAPL")
Retorna o preço de mercado atual de uma ação.
=STOCKEVENTS_STOCK_CHANGE("AAPL")
Retorna a variação de preço em 24 horas como porcentagem.
=STOCKEVENTS_STOCK_DIVIDEND_YIELD("AAPL")
Retorna o rendimento anual de dividendos.
=STOCKEVENTS_STOCK_NAME("AAPL")
Retorna o nome completo da empresa (ex.: "Apple Inc.").
Dividendos
Essas funções usam o nome de uma carteira como entrada e retornam métricas de dividendos dessa carteira.
=STOCKEVENTS_DIVIDENDS_INCOME("Watchlist")
Retorna a renda anual projetada de dividendos.
=STOCKEVENTS_DIVIDENDS_YIELD("Watchlist")
Retorna o rendimento atual ponderado de dividendos de todas as posições.
=STOCKEVENTS_DIVIDENDS_YIELD_ON_COST("Watchlist")
Retorna o rendimento de dividendos com base no preço médio ponderado de compra.
Posições
Essas funções usam o nome de uma carteira como entrada e retornam dados agregados da carteira.
=STOCKEVENTS_HOLDINGS_VALUE("Watchlist")
Retorna o valor total de mercado atual de todas as posições.
=STOCKEVENTS_HOLDINGS_GAIN("Watchlisto")
Retorna o lucro ou prejuízo não realizado total de todas as posições.
=STOCKEVENTS_HOLDINGS_LIST("Watchlist")
Retorna uma lista vertical de todos os símbolos de ticker na carteira. É uma matriz dinâmica — ela se expande automaticamente para as células abaixo.
Posições Específicas
Essas funções usam tanto o símbolo do ticker quanto o nome da carteira, e retornam dados dessa posição específica.
=STOCKEVENTS_POSITION_VALUE("AAPL"; "Watchlist")
Retorna o valor de mercado atual da posição.
=STOCKEVENTS_POSITION_SHARES("AAPL"; "Watchlist")
Retorna o número total de ações mantidas.
=STOCKEVENTS_POSITION_GAIN("AAPL"; "Watchlist")
Retorna o ganho ou perda não realizado da posição.
=STOCKEVENTS_POSITION_AVG_COST("AAPL"; "Watchlist")
Retorna o preço médio de compra (custo base) por ação.
Nomes das Carteiras
Use o nome exato da carteira como aparece no app Stock Events. Depois de fazer login, o painel lateral lista todas as suas carteiras — use esses nomes nas suas fórmulas.
Para fazer referência a todas as suas carteiras combinadas, use "Combined" como nome da carteira:
=STOCKEVENTS_HOLDINGS_VALUE("Combined")
Erros
Se uma função não conseguir retornar dados, ela mostrará um dos seguintes valores de erro:
LOGIN!
Você não está logado. Abra o painel lateral e clique em Login.
INVALID_TICKER
O símbolo do ticker não foi reconhecido. Verifique a ortografia e se está usando o símbolo correto da bolsa.
PORTFOLIO_NOT_FOUND
Nenhuma carteira corresponde ao nome informado. Abra o painel lateral para ver os nomes exatos das suas carteiras.
ERROR!
Ocorreu um problema temporário. A função tentará novamente automaticamente no próximo ciclo de atualização.
Dicas
- Você pode usar valores de células em vez de digitar textos diretamente. Por exemplo, se a célula A1 contém "AAPL", use =STOCKEVENTS_STOCK_PRICE(A1).
- Use HOLDINGS_LIST para listar todos os seus tickers em uma coluna e, ao lado, use STOCK_PRICE ou POSITION_VALUE para montar um painel dinâmico.
Precisa de Ajuda?
Se tiver qualquer problema, entre em contato com a gente em support@stockevents.app.