المطورون

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

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

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

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

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

تحصل جميع الخطط على بيانات SEC العامة (الأرقام، التواريخ، الإفصاحات). وتحصل الخطط المدفوعة بالإضافة إلى ذلك على ملخصات واقعية مكتوبة بواسطة الذكاء الاصطناعي. تتضمن الردود رؤوس 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"

واجهة برمجة التطبيقات (OpenAPI)

السطح بأكمله كوثيقة OpenAPI 3.1 قابلة للقراءة آليًا — استوردها إلى Postman أو Insomnia أو مولد SDK بدلاً من كتابتها يدويًا. لا تحتاج إلى مفتاح للقراءة، وحدود المعدل فيها مشتقة من تلك التي يفرضها API فعليًا، لذلك لا يمكن أن تتباعد.

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

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