Desenvolvedores

A API de Dados Financeiros

Dados de ações dos EUA factuais — arquivos da SEC, transações de insiders, participações institucionais 13F e resumos de resultados financeiros — em JSON limpo. Seguro por licença, operado em privado, com limites de taxa por plano. Informações gerais apenas, nunca aconselhamento.

Criar uma conta →Fazer login com uma chave

Limites de taxa por plano

Plano	Req/min	Req/dia	Máx. páginas	Narrativa de IA
Pulse	10	200	10	apenas fatos
Signal	60	5000	50	✓
Insider	180	50000	100	✓
Founders	300	200000	200	✓

Todo plano recebe os fatos do domínio público da SEC (números, datas, arquivos). Planos pagos também recebem resumos factuais escritos por IA. As respostas carregam os cabeçalhos X-RateLimit; chamadas acima do limite retornam HTTP 429 com Retry-After.

Pontos de extremidade

URL base: https://investwhen.com/api/v1 · Autenticar com um cabeçalho: Authorization: Bearer <key>

GET /api/v1/metaSeu plano, limites e uso atual.

GET /api/v1/finance/reports?ticker=AAPLPerfis de empresas factuais (lista, ou um ticker).

GET /api/v1/finance/insiders?ticker=TSLASinais de compra/venda de insider no mercado aberto (Form 4) + negociações notáveis.

GET /api/v1/finance/whales?cik=1067983Posições institucionais do 13F e movimentos de trimestre a trimestre.

GET /api/v1/finance/earnings?ticker=NVDAResumos factuais de resultados (earnings) diretamente das divulgações 8-K das próprias empresas.

GET /api/v1/finance/filings?ticker=MSFTArquivos recentes da SEC com resumos factuais.

Parâmetros de consulta comuns: limit (Limitado ao máximo de páginas do seu plano), ticker / cik.

Exemplo

curl -s https://investwhen.com/api/v1/finance/insiders?ticker=TSLA \
  -H "Authorization: Bearer iw_live_your_key_here"

{
  "ok": true,
  "api_version": "v1",
  "license": "SEC EDGAR (U.S. government, public domain) + InvestWhen factual summaries…",
  "count": 1,
  "data": [{
    "type": "insider", "ticker": "TSLA", "window_days": 90,
    "net_usd": -4200000, "n_buys": 0, "n_sells": 3, "cluster_buying": false,
    "notable": [{"insider": "…", "role": "Director", "code": "S", "value_usd": 1800000, "date": "2026-06-14"}]
  }]
}

Os dados são provenientes do SEC EDGAR (domínio público dos EUA) e dos resumos factuais próprios da InvestWhen. É informação de mercado geral, para toda a audiência — não aconselhamento de investimento, não uma recomendação pessoal e não uma solicitação para comprar ou vender qualquer ativo. Consulte o Termos e DPA.