طلب بيانات أو تحليل

متى ترسل طلباً

أرسل طلباً عندما تكون مجموعة بيانات أو حقل أو شركة أو تحليل تحتاج إليه غير متاح، أو عندما تبدو الإجابة خاطئة. يستخدم الأشخاص النموذج، وتستخدم الوكلاء API أو خادم MCP. يصل كلاهما إلى قائمة الانتظار نفسها، وبالحدود نفسها.

تنتهي كل حالة في المنصة تشير إلى بيانات فارغة أو غير مشمولة بالتغطية أو شركة غير معروفة برابط «اطلبها» يملأ النموذج نيابةً عنك. وتعرض لوحة الأوامر أيضاً خيار «طلب بيانات أو تحليل».

الأنواع

استخدم النموذج

يطلب نموذج طلب بيانات أو تحليل تحديد النوع وما تحتاج إليه والسبب (اختياري) والشركة (اختياري). لا تُدرج بيانات شخصية في النص.

تحصل على معرّف الطلب فوراً. احتفظ به للاستعلام عن الحالة لاحقاً.

أرسل طلباً عبر API

يقبل POST /v1/request-data الحقلين kind وwant، واختيارياً why وcompany وendpoint_or_tool. لا يحتاج إلى مفتاح ولا تُفرض عليه أي رسوم أبداً.

curl -X POST "https://api.financial.md/v1/request-data" -H "content-type: application/json" \
  -d '{"kind":"dataset","want":"Segment operating margin by quarter","why":"Comparing business lines","company":"ticker:AAPL"}'

تكون الاستجابة 201 مع معرّف الطلب، وبند الطلبات المجمّعة الذي انضم إليه، وحالته، وعدد من طلبوه حتى الآن:

{
  "data": {
    "request_id": "0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11",
    "item_id": "7c2e0d4b-31a9-4f57-9a3e-5d0b8c1f2a64",
    "status": "new",
    "requests": 3,
    "requesters": 2,
    "status_url": "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11",
    "served_by": null
  },
  "meta": { ... }
}

ما يصل إلى 10 طلبات لكل عنوان في كل يوم بتوقيت UTC، و500 إجمالاً. عند تجاوز أي من الحدّين، تكون الاستجابة 429 مع Retry-After (راجع rate_limited). يصف GET /v1/request-data محتوى جسم الطلب.

أرسل طلباً عبر وكيل

يوفّر خادم MCP أداتين لهذا الغرض: ترسل request_data طلباً بالحقول نفسها، وتستعلم request_status عن طلب باستخدام معرّفه. تتضمن إجابات API التي لا تلبّي المطلوب إجراءً لمعالجة ذلك من النوع request_data، فلا يبقى الوكيل عالقاً أبداً.

https://mcp.financial.md/mcp

تابع حالة الطلب

تُدمج الطلبات المشابهة في بند طلبات مجمّعة واحد، يُحدَّد بالنوع والشركة والمفهوم؛ ويضيف الطلب المتكرر صوتاً. استعلم عن طلب في صفحة الحالة أو باستخدام GET /v1/request-data/{id}:

curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"

ما طُلب وما أُتيح

تسرد صفحة ما طُلب وما أُتيح البنود التي راجعها شخص من فريقنا ووضع لها عناوين، مع عدد طلباتها ونتيجتها. لا يُدرج أي بند تلقائياً أبداً. تعرض الصفحة بيانات مجمّعة فقط: دون هوية مقدّم الطلب أو النص المقدَّم. وتتوفر البيانات نفسها عبر موجز JSON:

curl "https://api.financial.md/v1/requested"

يتضمن سجل التغييرات رابطاً إلى لوحة الطلبات، ويحدّد كل بند أُتيح ما يوفّره.

ما يمكننا تطويره

نطوّر اعتماداً على مصادر عامة مجانية وتحليلاتنا المشتقة الخاصة:

• الإيداع لدى SEC (المستند المودَع) ومجموعات البيانات في SEC EDGAR (القوائم المالية، الملكية، الأحداث، الصناديق)
• FRED والإحصاءات العامة الأخرى
• عمليات حسابية على البيانات التي نوفّرها بالفعل (النسب، التصفية، المقارنات)

تُوسم البيانات التي تتطلب ترخيصًا أو تمنع شروطها إعادة استخدامها، مثل تقديرات إجماع المحللين أو تقييماتهم أو تدفقات بيانات البورصات الآنية، بالوسم wontfix مع ملاحظة تشير إلى GET /v1/coverage. وتظل الطلبات اللاحقة لهذه البيانات تُحتسب أصواتًا، حتى نعرف ما هو مطلوب.

الخصوصية

لا يطلب تقديم الطلب أي بيانات شخصية. ولا يُحتفظ بالعنوان الذي ترسل منه إلا في صورة بصمة تجزئة مضاف إليها ملح تشفيري، لتطبيق الحدود.

لا يطلب النموذج عنوان بريد إلكتروني حاليًا: يمكنك متابعة الطلب باستخدام معرّفه. وإذا أُتيح لاحقًا تقديم بريد إلكتروني لتلقي الرد، فسيكون اختياريًا، ولن تُرسل الرسائل إلا عند تحديد مربع الاختيار، وسيُحتفظ به منفصلًا عن الطلب، ولن يُستخدم إلا لإبلاغك عند تنفيذ الطلب أو إغلاقه، وسيُحذف عند إغلاق الطلب أو بعد 365 يومًا، ولن يُشارك مطلقًا. راجع الخصوصية.