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 abonnement bevat de publieke SEC-gegevens (cijfers, datums, filings). Betaalde abonnementen ontvangen daarnaast door AI geschreven feitelijke samenvattingen. Antwoorden bevatten X-RateLimit headers, en overschrijding van de limiet resulteert in 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"
OpenAPI specificatie
Het volledige oppervlak als een machine-leesbare OpenAPI 3.1 document — importeer het in Postman, Insomnia of een SDK generator in plaats van het handmatig te schrijven. Het vereist geen sleutel om te lezen, en de rate limits daarin worden gegenereerd op basis van de limieten die de API daadwerkelijk afdwingt, zodat ze niet kunnen afwijken.
# 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"}]
}]
}
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.