المطورون

واجهة برمجة تطبيقات بيانات التمويل

بيانات أسهم أمريكية واقعية — بيانات وملفات SEC، ومعاملات الداخلين، وحصص 13F المؤسسية، وأخبار الأرباح — بتنسيق JSON نظيف. آمنة الترخيص، وتشغيل خاصة، ومحدودة المعدل حسب الخطة. معلومات عامة فقط، وليس نصيحة.

إنشاء حساب →تسجيل الدخول بمفتاح

حدود المعدل حسب الخطة

خطة	المطلوب/الدقيقة	المطلوب/اليوم	الحد الأقصى للصفحات	نص سرد ذكاء اصطناعي
Pulse	10	200	10	فقط الحقائق
Signal	60	5000	50	✓
Insider	180	50000	100	✓
Founders	300	200000	200	✓

تحتوي كل خطة على الحقائق العامة من SEC (الأرقام، التواريخ، المستندات). توفر الخطط المدفوعة أيضًا ملخصات واقعية مكتوبة بواسطة الذكاء الاصطناعي. تحمل الاستجابات رؤوس HTTP X-RateLimit؛ تتسبب المكالمات التي تتجاوز الحد في إرجاع HTTP 429 مع Retry-After.

نقطة النهاية

عنوان URL الأساسي: https://investwhen.com/api/v1 · المصادقة باستخدام رأس: Authorization: Bearer <key>

GET /api/v1/metaخطةك، وحدودك، واستخدامك الحالي.

GET /api/v1/finance/reports?ticker=AAPLملفات تعريف الشركات الواقعية (قائمة، أو رمزًا واحدًا).

GET /api/v1/finance/insiders?ticker=TSLAإشارات شراء/بيع داخل السوق (نموذج 4) + صفقات بارزة.

GET /api/v1/finance/whales?cik=1067983حيازات مؤسسية من نموذج 13F وتحركات الربعية.

GET /api/v1/finance/earnings?ticker=NVDAملخصات أرباح واقعية من بيانات 8-K الصادرة عن الشركات نفسها.

GET /api/v1/finance/filings?ticker=MSFTملفات SEC الأخيرة مع ملخصات واقعية.

معلمات الاستعلام الشائعة: limit (محدود بحد أقصى للصفحات المسموح بها في خطتك.), ticker / cik.

مثال

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

يتم استخلاص البيانات من SEC EDGAR (المنطقة العامة الأمريكية) و ملخصات InvestWhen الواقعية الخاصة بها. هذه معلومات سوقية عامة وشاملة — وليست نصيحة استثمارية، وليست توصية شخصية، وليست دعوة لشراء أو بيع أي أوراق مالية. يرجى الاطلاع على الشروط و اتفاقية معالجة البيانات (DPA).