واجهة بيانات هجرس

ذكاء القيمة العادلة للسوق السعودي كخدمة — نفس فارز تاسي ونمو ومحرّكات التقييم وطبقة موثوقية البيانات التي تشغّل هذا التطبيق، عبر واجهة REST بسيطة.

مجانيكل نقاط الوصول عامة وغير محدودة خلال الإصدار التجريبي.

العنوان الأساسي: https://bj91.odoo.com

نقاط القراءة لا تتطلّب مصادقة. فقط /api/v1/contribute يتطلّب جلسة مسجّلة الدخول. النقاط بالمفتاح تقبل ترويسة X-Api-Key؛ النقاط بدون مفتاح تبقى مفتوحة.

نقاط الوصول

الأسواق والفرز

public

GET/api/companies— الفارز — تصفية حسب القطاع / السوق / الخصم.

GET/api/company/<ticker>— تفاصيل الشركة الكاملة + تفصيل التقييم.

GET/api/company/<ticker>/prices— سجل الأسعار (يومي / أسبوعي).

GET/api/meta— بيانات التصفية (القطاعات، الأسواق، التصنيفات).

GET/api/leaders— الأفضل أداءً حسب العائد الكلي.

محرّكات التقييم اللحظية

public

POST/api/realestate/calc— تقييم عقاري (بدون حالة).

POST/api/privateequity/calc— تقييم ملكية خاصة (بدون حالة).

POST/api/vcstartup/calc— تقييم شركات ناشئة (بدون حالة).

واجهة التقييم (v1)

public

GET/api/v1/companies— فارز بإصدار.

GET/api/v1/company/<ticker>— تفاصيل شركة بإصدار.

GET/api/v1/reviews/<ticker>— آراء المحللين لشركة.

الموثوقية والإجماع (v1)

public

GET/api/v1/consensus/<ticker>— الإجماع والثقة والمصادر لكل رقم.

GET/api/v1/filings/<ticker>— الإفصاحات النظامية (الهيئة / تداول).

POST/api/v1/contribute— إرسال رقم موثّق (يتطلّب جلسة).

واجهة البيانات بالمفتاح (المرحلة 5)

X-Api-Key

GET/api/v1/screener— كتالوج بالمفتاح — يُرجع الخطة والحصة.

نقاط الحساب محدودة بـ 60 طلبًا في الدقيقة لكل عنوان IP (يُرجع 429 عند التجاوز).

مثال على الطلب

curl https://bj91.odoo.com/api/v1/screener \
  -H "X-Api-Key: fc_your_key_here"

مثال على الاستجابة

{ "results": [ { "ticker": "2222", "name": "Saudi Aramco",
                 "sector": "energy", "datapoint_count": 5 } ],
  "total_count": 1, "plan": "free", "quota_remaining": 999 }

الخطط

	مجانية	احترافية	للمؤسسات
نقاط القراءة	✓	✓	✓
حدّ المعدّل	60/min	—	—
الاستخدام التجاري	—	✓	✓
تصدير مجمّع / تاريخي	—	✓	✓
السعر	مجانية	مخطّط له	تواصل معنا

تسعير استرشادي للإصدار العام. خلال الإصدار التجريبي حدود الخطط غير مفعّلة — الواجهة مفتوحة.

اطلب مفتاح واجهة

لا تُصدر المفاتيح تلقائيًا بعد. راسلنا بحالة الاستخدام والحجم المتوقّع وسنهيّئ لك الوصول.

راسلنا

الأرقام تقديرات لأغراض الفرز وليست نصيحة استثمارية. تحقّق قبل الاستثمار.