Deweloperzy

API Danych Finansowych

Rzetelne dane dotyczące akcji USA — zgłoszenia SEC, transakcje związane z informacją wewnętrzną, informacje z formularzy 13F instytucjonalnych i podsumowania zysków — w czystym formacie JSON. Bezpieczne licencją, prowadzony prywatnie, ograniczony w poziomie taryfy. Informacje ogólne, nigdy nie doradztwo.

Utwórz konto →Zaloguj się, aby uzyskać klucz

Limit szybkości zależny od planu

Plan	Req/min	Req/dzień	Maks. liczba stron	Narracja AI
Pulse	10	200	10	tylko fakty
Signal	60	5000	50	✓
Insider	180	50000	100	✓
Founders	300	200000	200	✓

Każdy plan obejmuje publiczne dane SEC (liczby, daty, raporty). Plany płatne otrzymują dodatkowo faktyczne podsumowania generowane przez AI. Odpowiedzi zawierają nagłówki X-RateLimit, a żądania przekraczające limit zwracają błąd HTTP 429 z parametrem Retry-After.

Punkty końcowe

Podstawowa URL: https://investwhen.com/api/v1 · Zautentykuj się za pomocą nagłówka: Authorization: Bearer <key>

GET /api/v1/metaTwój plan, limity i aktualne zużycie.

GET /api/v1/finance/reports?ticker=AAPLFaktyczny profil spółki (lista, lub jeden ticker).

GET /api/v1/finance/insiders?ticker=TSLAWykrywanie transakcji wewnętrznych (Form 4) + istotne transakcje.

GET /api/v1/finance/whales?cik=106798313F posiadania instytucji i ruchy kwartalnie-do-kwartalnie.

GET /api/v1/finance/earnings?ticker=NVDAFaktyczne podsumowania zysków z własnych raportów 8-K spółek.

GET /api/v1/finance/filings?ticker=MSFTOstatnie zgłoszenia SEC z fakturalnymi podsumowaniami.

Często używane parametry zapytania: limit (ograniczone do maksymalnej liczby stron w Twoim planie), ticker / cik.

Przykład

curl -s https://investwhen.com/api/v1/finance/insiders?ticker=TSLA \
  -H "Authorization: Bearer iw_live_your_key_here"

Specyfikacja OpenAPI

Cała powierzchnia jako czytelny maszynowo dokument OpenAPI 3.1 — importuj go do Postman, Insomnia lub generatora SDK zamiast pisać klienta ręcznie. Nie wymaga klucza do odczytu, a limity szybkości są generowane na podstawie tych, które faktycznie narzuca API, więc nie mogą się od nich odchylać.

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

Dane pochodzą z SEC EDGAR (amerykański publiczny dostęp) i własnych fakturalnych podsumowań InvestWhen. Jest to ogólna, szerokopowska informacja rynkowa — nie jest to porada inwestycyjna, nie jest to rekomendacja personalna, ani nie jest to zachęta do zakupu lub sprzedaży jakiejkolwiek akcji. Zobacz Regulamin i DPA.