Sviluppatori

L'API per i Dati Finanziari

Dati azionari statunitensi oggettivi — comunicazioni SEC, transazioni di insider, partecipazioni istituzionali 13F e riepiloghi degli utili — in formato JSON pulito. Sicuro per licenza, gestito privatamente, limitato per piano. Informazioni generali solo, mai consigli.

Crea un account →Accedi con una chiave

Limiti di utilizzo in base al piano

Piano	Rich/min	Rich/giorno	Max pagina	narrazione AI
Pulse	10	200	10	solo fatti
Signal	60	5000	50	✓
Insider	180	50000	100	✓
Founders	300	200000	200	✓

Ogni piano include i fatti SEC di dominio pubblico (numeri, date, documenti). I piani a pagamento ricevono inoltre riepiloghi fattuali scritti dall'IA. Le risposte includono intestazioni X-RateLimit; le chiamate oltre il limite restituiscono HTTP 429 con Retry-After.

Endpoint

URL di base: https://investwhen.com/api/v1 · Autentica con un header: Authorization: Bearer <key>

GET /api/v1/metaIl tuo piano, limiti e utilizzo attuale.

GET /api/v1/finance/reports?ticker=AAPLProfili aziendali fattuali (elenco, o un ticker).

GET /api/v1/finance/insiders?ticker=TSLASegnali di acquisto/vendita insider di mercato aperto (Form 4) + operazioni notevoli.

GET /api/v1/finance/whales?cik=1067983Posizioni istituzionali 13F e movimenti trimestrali.

GET /api/v1/finance/earnings?ticker=NVDARiepiloghi fattuali degli utili dalle comunicazioni 8-K delle società.

GET /api/v1/finance/filings?ticker=MSFTUltimi documenti SEC con riepiloghi fattuali.

Parametri di query comuni: limit (limitato al numero massimo di pagine del tuo piano), ticker / cik.

Esempio

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"}]
  }]
}

I dati provengono dal database SEC EDGAR (dominio pubblico statunitense) e dai riepiloghi fattuali propri di InvestWhen. Si tratta di informazioni di mercato generali, rivolte a tutti gli utenti, e non costituiscono consulenza di investimento, raccomandazione personale o sollecitazione all'acquisto o alla vendita di qualsiasi titolo. Si prega di consultare la... Termini e DPA.