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 forfait inclut les données SEC du domaine public (chiffres, dates, documents). Les forfaits payants reçoivent également des résumés factuels rédigés par l'IA. Les réponses incluent des en-têtes X-RateLimit, et 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"

Spécification OpenAPI

La surface entière sous forme de document OpenAPI 3.1 lisible par machine — importez-la dans Postman, Insomnia ou un générateur de SDK au lieu de la taper à la main. Elle n’a pas besoin de clé pour être lue, et les limites de débit qu’elle impose sont basées sur celles que l’API applique réellement, elles ne peuvent donc pas varier.

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

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.