Développeurs

L'API de données financières

Données boursières américaines factuelles — déclarations SEC, transactions d'initiés, avoirs institutionnels 13F et récapitulatifs des bénéfices — au format JSON propre. Licence conforme, gérée en interne, débit limité selon le plan. Informations générales uniquement, jamais de conseils.

Créer un compte →Se connecter avec une clé

Limites d'utilisation par plan

Plan	Req/min	Req/jour	Max page	Narration IA
Pulse	10	200	10	uniquement les faits
Signal	60	5000	50	✓
Insider	180	50000	100	✓
Founders	300	200000	200	✓

Chaque plan reçoit les faits du domaine public de la SEC (chiffres, dates, publications). Les plans payants reçoivent également des résumés factuels rédigés par l'IA. Les réponses comportent des en-têtes X-RateLimit ; les appels dépassant la limite renvoient une erreur HTTP 429 avec Retry-After.

Points d'extrémité

URL de base: https://investwhen.com/api/v1 · Authentifier avec un en-tête: Authorization: Bearer <key>

GET /api/v1/metaVotre plan, vos limites et votre utilisation actuelle.

GET /api/v1/finance/reports?ticker=AAPLProfils d'entreprises factuels (liste, ou un ticker).

GET /api/v1/finance/insiders?ticker=TSLASignaux d'achat/vente sur le marché ouvert (Formulaire 4) + transactions notables.

GET /api/v1/finance/whales?cik=1067983Périphériques 13F des institutions et mouvements trimestriels.

GET /api/v1/finance/earnings?ticker=NVDARécapitulatifs factuels des bénéfices provenant des propres communiqués 8-K des entreprises.

GET /api/v1/finance/filings?ticker=MSFTDépôts récents de la SEC avec des résumés factuels.

Paramètres de requête courants: limit (Limité à la page maximale de votre plan), ticker / cik.

Exemple

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

Les données proviennent de la SEC EDGAR (domaine public américain) et des propres résumés factuels d'InvestWhen. Il s'agit d'informations générales et accessibles à tous les participants au marché — et non de conseils d'investissement, de recommandations personnelles ou de sollicitations d'achat ou de vente de titres. Veuillez consulter le Conditions et DPA.