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	✓

Todos os planos incluem dados públicos da SEC (números, datas, filings). Planos pagos recebem adicionalmente resumos factuais gerados por IA. As respostas contêm cabeçalhos X-RateLimit, e 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"

OpenAPI spec

A superfície completa como um documento OpenAPI 3.1 legível por máquina — importe-o para o Postman, Insomnia ou um gerador de SDK em vez de escrever um cliente manualmente. Não precisa de chave para ler, e os limites de taxa são gerados a partir dos que o API realmente impõe, portanto, não podem se desviar.

/api/v1/openapi.json

# import into any OpenAPI tool
curl -s https://investwhen.com/api/v1/openapi.json -o investwhen.json

# or generate a typed client (example: Python)
openapi-python-client generate --url https://investwhen.com/api/v1/openapi.json

{
  "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.