Quantic para desenvolvedores

Sua carteira e os dados de dividendos do Quantic, para seus próprios scripts e ferramentas: uma API JSON hoje, e um cliente de linha de comando e um widget de desktop a caminho.

Disponível

A API JSON

Leia sua carteira e os dados públicos de dividendos via HTTPS.

Em desenvolvimento

A linha de comando

Suas posições, dividendos e renda no terminal.

Planejado

Um widget de desktop

Seu próximo dividendo na barra superior do seu desktop.

Usa um assistente de IA? Conecte-o ao Quantic

A API JSON

Disponível

Uma API JSON somente leitura e versionada, via HTTPS. Sua própria carteira precisa de um token; os dados públicos de dividendos respondem sem ele.

https://quantic.finance/api/v1

Obtenha um token

Entre e abra as Configurações. Em “Acesso para IA e API”, procure “Tokens de acesso pessoal”.
Dê ao token o nome do lugar onde ele vai ficar, como “notebook” ou “script de backup”, e crie-o. Ele só aparece uma vez, então copie-o na hora.
Envie-o no cabeçalho Authorization. Guarde-o numa variável de ambiente ou no seu chaveiro, nunca em código que você compartilha.

Os tokens são somente leitura: nada nesta API pode alterar seus dados. Revogar um token nas Configurações o desativa na hora. O mesmo token também funciona no conector de IA.

Sua primeira requisição

export QUANTIC_TOKEN=qtc_…
curl -H "Authorization: Bearer $QUANTIC_TOKEN" \
  https://quantic.finance/api/v1/me

Os dados públicos não precisam de token:

curl "https://quantic.finance/api/v1/calendar?days=30"

Endpoints

Todos são GET. Quando um endpoint aceita portfolio, é o nome de uma das suas carteiras; sem ele, a resposta cobre todas as suas carteiras.

Endpoint	Token	Retorna
/api/v1/me	Obrigatório	De quem é o token. O jeito mais barato de verificar um.
/api/v1/portfolios	Obrigatório	Suas carteiras, a padrão primeiro.
/api/v1/holdings	Obrigatório	Suas posições: ações e custo médio. Opcional: portfolio.
/api/v1/dividends	Obrigatório	Os dividendos pagos a você, os mais recentes primeiro: bruto, retenção e líquido. Opcional: symbol, from, to, portfolio.
/api/v1/income	Obrigatório	Sua renda anual prevista, bruta e líquida, e uma projeção ano a ano. Opcional: years (1–50), drip, portfolio.
/api/v1/calendar	Não precisa	Ações com data ex-dividendo em breve, as mais próximas primeiro. Opcional: days (1–120).
/api/v1/stocks	Não precisa	Busca por ticker ou nome. Obrigatório: q. Com um token, também busca além das ações que o Quantic acompanha.
/api/v1/stocks/{symbol}	Opcional	Uma ação: preço, perfil de dividendos, segurança e pontuações. Com um token, o preço é ao vivo.

Convenções

Erros: Todo erro tem o mesmo formato e o status HTTP correspondente. Decida pelo code; a message é para pessoas e pode mudar.; {"error": {"code": "not_found", "message": "…"}}
Valores: Os valores são strings decimais, nunca floats, e sempre vêm com sua moeda.; {"amount": "1234.56", "currency": "EUR"}
Taxas: Números simples, com nomes que dizem sua unidade: um nome terminado em _pct é uma porcentagem; qualquer outra taxa é uma fração (0.05 é 5%).; yield_pct: 3.1 · growth_rate: 0.05
Datas: ISO 8601. Os timestamps estão em UTC.; 2026-10-08
Parâmetros inválidos: Um parâmetro malformado é um erro, nunca ignorado em silêncio. Um número fora do intervalo é ajustado ao valor permitido mais próximo.; 422 invalid_params
Cache: Toda resposta traz um ETag. Envie-o de volta como If-None-Match e uma resposta sem mudanças volta como 304, sem corpo.; If-None-Match → 304
Limites: Sem token, 60 requisições por minuto por endereço IP. Com um, não há limite fixo: consulte a cada poucos minutos, não a cada segundo.; 429 rate_limited
Versionamento: A v1 só cresce: novos endpoints, parâmetros e campos. Ignore os campos que você não conhece. Tudo o que quebraria um cliente vai para uma nova versão.; /api/v1 → /api/v2

O documento OpenAPI

Cada parâmetro e cada campo de resposta, descritos em OpenAPI 3. Gere um cliente a partir dele em vez de escrever um à mão.

/api/v1/openapi.json

A linha de comando

Em desenvolvimento

quantic, um cliente de linha de comando feito sobre esta API: suas posições, dividendos e renda como tabelas no terminal, ou como JSON para scripts. Um único arquivo para instalar e, como a API, só lê.

quantic auth login          # stores your token in the system keyring
quantic holdings
quantic income --years 5
quantic calendar --days 30  # no account needed
quantic status --json       # one document for status bars and scripts

Ainda não pode ser instalado, e os comandos podem mudar antes da primeira versão. Ele é desenvolvido em aberto: github.com/fleveque/quantic-cli

Um widget de desktop

Planejado

Um widget para a barra superior do Omarchy, o desktop Linux: sua próxima data ex-dividendo num relance, e um painel com os dividendos das próximas duas semanas e a renda do mês até agora.

Os valores ficam ocultos na barra a menos que você os ative, já que a barra aparece quando você compartilha a tela. Ele roda sobre o cliente de linha de comando, então vem depois dele.