Painel de Mercados
Dashboard com câmbio (dólar e euro em reais), juros e inflação (Selic, CDI, IPCA), as principais
bolsas (Ibovespa, S&P 500, Nasdaq, Dow Jones, FTSE 100, Nikkei 225, Hang Seng) e commodities
(petróleo Brent e ouro).
Como rodar
Requer Node.js 20.6 ou superior. Não há dependências para instalar.
cp .env.example .env # preencha as chaves
npm start # http://localhost:3000
Para ver o painel sem chaves nem internet: npm run demo (dados fictícios, sinalizados na tela).
Sem DEMO=1, o painel mostra apenas dados reais.
Publicar com link fixo (para o painel de BI)
A forma mais simples é a Vercel, plano grátis:
- Suba este projeto para um repositório no GitHub.
- Na Vercel: Add New → Project, escolha o repositório e clique em Deploy
(não precisa mudar nenhuma configuração; o
vercel.json já cuida disso).
- Em Settings → Environment Variables, cadastre
BRAPI_TOKEN, FMP_API_KEY e
AWESOME_API_KEY. Depois, em Deployments, clique em Redeploy.
- Use o link gerado (ex.:
https://dashboard-bolsas.vercel.app) no seu painel de BI.
As cotações ficam em cache na CDN da Vercel: não importa quantas telas estejam abertas,
cada fonte é consultada no máximo no ritmo descrito em "Frequência de atualização".
Opções no link (podem ser combinadas: ?modo=tv&tema=escuro)
?tema=escuro ou ?tema=claro força o tema (por padrão segue o sistema).- Em telas largas e deitadas (a partir de 1280 px, proporção 3:2 ou mais larga, como TVs 1920×1080),
o painel encaixa tudo numa tela só, sem rolagem, automaticamente.
?modo=tv força esse layout em qualquer tela; ?modo=normal força o layout com rolagem.
Armazenamento (recomendado): ligue um Upstash Redis grátis ao projeto na Vercel
(Storage → Create Database → Upstash for Redis → Connect Project) e faça um Redeploy.
Com ele, as cotações ficam guardadas entre execuções, a última cotação boa cobre falhas das fontes
e a FMP tem um teto rígido de 200 consultas por dia (DAILY_BUDGET em src/config.js).
Confira em /api/status: "armazenamento": "redis" e o total de consultas do dia.
Embutindo no BI
- Power BI: em um dashboard (serviço), use Adicionar bloco → Conteúdo da Web com
<iframe src="https://SEU-LINK.vercel.app/?tema=claro" width="100%" height="100%"></iframe>.
Em relatórios, use um visual de conteúdo HTML/Web da AppSource que aceite URL.
- Metabase, Grafana, Looker Studio, Superset: use o bloco/painel de "iframe", "texto/HTML" ou
"incorporar URL" com o mesmo link.
Fontes de dados
Cada ativo tem uma lista de fontes em src/config.js, tentadas em ordem até uma responder.
| Dados | Fontes (em ordem) | Chave |
|---|
| Ibovespa e ativos da B3 | brapi.dev | BRAPI_TOKEN (plano grátis) |
| S&P 500, Nasdaq, Dow Jones, FTSE 100, Nikkei, Hang Seng | Financial Modeling Prep | FMP_API_KEY (plano grátis) |
| Selic, CDI, IPCA 12 meses | Banco Central (SGS) | Não precisa |
| Petróleo Brent, ouro | Financial Modeling Prep | FMP_API_KEY |
| Dólar e euro | brapi → AwesomeAPI → PTAX do Banco Central → Frankfurter/BCE | AWESOME_API_KEY recomendada (sem ela, na Vercel, o câmbio cai para as cotações diárias) |
| DAX, CAC 40 | Desativados (enabled: false): fora do plano grátis da FMP, e a Stooq bloqueia a Vercel | — |
Na Vercel, a AwesomeAPI devolve 429, a Stooq devolve 403 e a FMP grátis não cobre câmbio com real.
A API do Banco Central também costuma não responder a servidores fora do Brasil. Por isso o
vercel.json fixa a função na região gru1 (São Paulo). PTAX e Frankfurter são cotações diárias;
o card mostra qual fonte está em uso.
Se todas as fontes de um ativo falharem, o card mostra Indisponível com o motivo. O painel
nunca exibe números fictícios fora do modo demo (npm run demo).
Frequência de atualização
A tela pergunta ao servidor a cada minuto, mas cada cotação só é buscada de novo na fonte quando
seu prazo vence (valores em REFRESH_MINUTES, em src/config.js):
| Ativo | Pregão aberto | Pregão fechado |
|---|
| Dólar e euro (AwesomeAPI) | a cada 2 min (09h–18h, horário de Brasília) | guarda a última até a abertura |
| Ibovespa (brapi) | a cada 5 min | guarda a última até a abertura |
| Bolsas globais (FMP) | a cada 30 min | guarda a última até a abertura |
| Brent e ouro (FMP) | a cada 1 h (09h–18h, horário de Brasília) | guarda a última até as 9h |
| Selic, CDI, IPCA (Banco Central) | a cada 6 h | a cada 6 h |
| Gráficos de 30 dias | a cada 12 h | a cada 12 h |
Isso mantém a FMP em torno de 140 consultas por dia, abaixo do limite grátis de 250. Cada card
mostra a fonte e o horário da cotação.
Como funciona
navegador ──/api/assets, /api/quote?id=…, /api/history?id=…──▶ api/*.js (Vercel) ou src/server.js
▲ (cotações a cada 1 min, gráficos a cada 30 min) │ cache da CDN com prazo por ativo
└──────────────── public/ (HTML, CSS, JS) ◀────────────────── src/markets.js → src/providers.js
- A página principal é montada no servidor (
src/page.js, api/page.js) já com os números, e se
recarrega a cada 5 min. Assim funciona em painéis de BI que não rodam JavaScript. Onde ele roda,
public/app.js atualiza os números a cada minuto sem recarregar.
- O HTML de cada parte fica em
public/render.js, usado pelo servidor e pelo navegador.
- As chamadas às APIs ficam no servidor: as chaves não vão para o navegador e não há problema de CORS.
- O status "Aberta/Fechada" usa o fuso de cada bolsa. Feriados não são considerados.
Personalizar
- Adicionar/remover bolsas ou moedas: edite
src/config.js. Ex.: { provider: 'brapi', symbol: 'PETR4', ... }
para uma ação da B3, ou { pair: 'BTC-BRL', name: 'Bitcoin' } em CURRENCIES.
- Trocar de provedor: crie em
src/providers.js um objeto com quote(símbolo) e history(símbolo),
exporte-o e use o nome dele em sources no src/config.js.
Estrutura
src/config.js ativos, fusos e horários de pregão
src/providers.js integração com cada API + dados demo
src/markets.js escolhe a fonte, define o prazo de cada cotação e as rotas /api/*
src/store.js armazenamento compartilhado (Upstash Redis na Vercel; memória sem ele)
src/server.js servidor HTTP local (npm start), com cache em memória
api/*.js as mesmas rotas como funções serverless da Vercel
public/ estilos, render.js (HTML das partes) e app.js (atualização no navegador)
src/page.js página completa montada no servidor
