De Finance Data API
Feitelijke Amerikaanse aandeleninformatie — SEC-indieningen, insider transacties, 13F-beheersing van institutionele beleggers en winstoverzichten — in schone JSON-vorm. Licentiesaf, privé beheerd, gebruikslimiet per abonnement. Alleen algemene informatie, nooit advies.
Snelheidslimieten per plan
| Plan | Req/min | Req/dag | Max pagina's | AI narratief |
|---|---|---|---|---|
| Pulse | 10 | 200 | 10 | alleen feiten |
| Signal | 60 | 5000 | 50 | ✓ |
| Insider | 180 | 50000 | 100 | ✓ |
| Founders | 300 | 200000 | 200 | ✓ |
Elk plan krijgt de openbare SEC-feiten (cijfers, data, indieningsformulieren). Betaalde plannen ontvangen bovendien de AI-gegenereerde feitelijke samenvattingen. Reacties bevatten X-RateLimit headers; overschrijding van de limiet leidt tot HTTP 429 met Retry-After.
Endpoints
Basis URL: https://investwhen.com/api/v1 · Authenticeer met een header: Authorization: Bearer <key>
GET /api/v1/metaUw plan, limieten en huidige gebruik.GET /api/v1/finance/reports?ticker=AAPLFactual bedrijfsprofielen (lijst, of één aandeel).GET /api/v1/finance/insiders?ticker=TSLAOpenbare insider (Form 4) koop-/verkoopsignaal + opmerkelijke transacties.GET /api/v1/finance/whales?cik=106798313F institutionele beleggingen en kwartaalwijzigingen.GET /api/v1/finance/earnings?ticker=NVDAFeitelijke winstoverzichten van de eigen 8-K rapporten van bedrijven.GET /api/v1/finance/filings?ticker=MSFTRecente SEC-indieningen met feitelijke samenvattingen.Veelvoorkomende query parameters: limit (Beperkt tot de maximale pagina van uw abonnement), ticker / cik.
Voorbeeld
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"}]
}]
}
De data is afkomstig uit SEC EDGAR (U.S. openbare bron) en InvestWhen's eigen feitelijke samenvattingen. Het is algemene, breed georiënteerde marktinformatie – geen beleggingsadvies, geen persoonlijke aanbeveling en geen verzoek tot aankoop of verkoop van een aandeel. Zie de Voorwaarden en DPA.