[ blog · comparison ]9 min read

واجهة أساسيات الشركات: الميزانية العمومية والتدفّق النقدي وصفقات المطّلعين للوكلاء الماليين

Sarah Choyنُشر في 16 يونيو 2026قراءة 9 دقائق
واجهة أساسيات الشركات: الميزانية العمومية والتدفّق النقدي وصفقات المطّلعين للوكلاء الماليين

تخبرك الأسعار بما يظنّه السوق؛ وتخبرك الأساسيات بما إذا كان مُحقًّا. إليك واجهة أساسيات مُشكَّلة لوكلاء الذكاء الاصطناعي — البيانات المالية والأرباح الموزّعة وصفقات المطّلعين في واجهة واحدة — وكيف تقارَن بـ SEC EDGAR الخامّ وبمزوّدي واجهات البيانات المالية.

الخلاصة

  • الأساسيات = طبقة «هل العمل سليم فعلًا»: الميزانية العمومية، قائمة الدخل، التدفّق النقدي، الأرباح الموزّعة، صفقات المطّلعين.
  • يمكنك تحليلها مجانًا من SEC EDGAR (XBRL)، لكن توحيد XBRL عبر المودِعين والفترات هندسةٌ حقيقية مستمرّة — وهو أمريكي فقط ومُتمحوِر حول الإيداع، لا مُشكَّل للاستعلام.
  • تعيد Financials Search من API Pick أساسيات الشركات الأمريكية الخمس جميعًا خلف واجهة POST واحدة — 200 رصيد/نداء، عند النجاح فقط — مُهيّأة مسبقًا لاستدلال نماذج اللغة.
  • صفقات المطّلعين (النموذج 4) وتاريخ الأرباح الموزّعة هما الإشارتان قليلتا الاستخدام: رخيصتا الجلب هنا، مؤلمتا التجميع من EDGAR.
  • اقرن Financials مع SEC Filings (نصّ 10-K/10-Q النوعي) وMarkets (السعر) لرؤية مؤصَّلة كاملة.

السعر رأي؛ الأساسيات دليل

نداء بيانات السوق يخبر وكيلك بكم يكلّف السهم. لا يستطيع إخبارك ما إذا كان العمل وراءه ينمو، أو يغرق في الديون، أو يبيعه تنفيذيّوه أنفسهم بهدوء. تلك طبقة الأساسيات — وهي حيث ينتقل وكيل البحث من "يقتبس الأسعار" إلى "يكوِّن رأيًا".

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

ضريبة EDGAR

كل هذا عامّ ومجاني في SEC EDGAR. الفخّ هو XBRL. ‏JSON الخاصّ بـ company-facts ضخم وغير متّسق: المفهوم نفسه مُوسَّم على نحو مختلف عبر المودِعين، وإعادات البيان تعكّر التاريخ، وعليك ربط تصنيف مترامٍ بمخطّط نظيف قبل أن يستطيع أيّ شيء لاحق استخدامه. بيانات المطّلعين (النموذج 4) والأرباح الموزّعة أنواع إيداع منفصلة تحلّلها على حدة. القيام بهذا مرّة لرمز واحد عطلةُ نهاية أسبوع؛ القيام به بموثوقية لوكيل يستعلم عن أيّ شركة خطٌّ مُصان.

الأساسيات كأداة واحدة

تعيد Financials Search الميزانيات العمومية وقوائم الدخل والتدفّق النقدي والأرباح الموزّعة وصفقات المطّلعين للشركات العامّة الأمريكية خلف واجهة POST واحدة — 200 رصيد للنداء، عند النجاح فقط، مُهيّأة مسبقًا لنموذج لغة.

import httpx, os
API, HEADERS = "https://api.apipick.com/v1", {"x-api-key": os.environ["APIPICK_KEY"]}

def fundamentals(query: str):
    return httpx.post(f"{API}/search/financials", headers=HEADERS,
                      json={"query": query}).json()["results"]

fundamentals("Apple latest balance sheet and cash flow")
fundamentals("recent insider transactions at Meta")
fundamentals("Microsoft revenue and net income trend")

EDGAR مقابل المزوّد مقابل المجموعة

تحليل SEC EDGARمزوّد واجهة بيانات ماليةAPI Pick Financials
التكلفةمجاني + هندسةاشتراك200 رصيد/نداء، عند النجاح فقط
الإعدادخطّ توحيد XBRLدمج واجهات مُنمَّطةواجهة واحدة، شكل واحد
التغطيةأمريكي، منظَّم بالإيداععميق، تاريخ طويلأساسيات أمريكية + مطّلعون + أرباح موزّعة
أسلوب الاستعلامبالإيداع/المفهوممعاملات مُنمَّطةلغة طبيعية
الأنسب لـلمرّة واحدة / تحكّم كاملالأساسيات كمنتجالوكلاء الماليون (أداة من بين كثيرة)

الصورة الكاملة

تتزاوج الأساسيات طبيعيًّا مع SEC Filings Search للجانب النوعي (عوامل المخاطر، MD&A، لغة مكالمات الأرباح) وMarkets Search للسعر. معًا هي العمود الفقري لـ وكيل الأبحاث الاستثمارية. مفتاح واحد، JSON في كل مكان، عند النجاح فقط. ابدأ مجانًا بـ 100 رصيد، دون بطاقة.

الأسئلة الشائعة

ألا أستطيع ببساطة الحصول على الأساسيات مجانًا من SEC EDGAR؟

بإمكانك — بيانات company-facts وXBRL في EDGAR مجانية ومرجعية. التكلفة هندسية: وسوم XBRL تنزاح عبر المودِعين والفترات، وإعادات البيان تعقّد التاريخ، وعليك ربط آلاف المفاهيم التصنيفية بمخطّط نظيف قبل أن يستطيع نموذج (أو رسم بياني) استخدامها. وهو أيضًا أمريكي فقط ومنظَّم حسب الإيداع، لا حسب السؤال. لشركة واحدة بين الحين والآخر، EDGAR لا بأس به. لوكيل يستعلم عن شركات عديدة بلغة طبيعية، توفّر واجهة موحَّدة أسابيع.

ما المغطّى — وهل هو أمريكي فقط؟

الميزانيات العمومية وقوائم الدخل وقوائم التدفّق النقدي وتاريخ الأرباح الموزّعة وصفقات المطّلعين للشركات العامّة المدرَجة أمريكيًا. هي أساسيات أمريكية؛ وللمُصدِرين غير الأمريكيين تستخدم مصدرًا مختلفًا. ولنصّ الإيداع نفسه (عوامل مخاطر 10-K، MD&A في 10-Q، مكالمات الأرباح)، استخدم واجهة SEC Filings Search المنفصلة.

لماذا تستحقّ صفقات المطّلعين والأرباح الموزّعة الإبراز؟

هي عالية الإشارة ومزعِجة التجميع بنفسك. شراء/بيع المطّلعين (النموذج 4 لدى SEC) إشارة سلوكية مراقَبة؛ وتاريخ الأرباح الموزّعة يهمّ لفحوص الدخل والجودة. كلاهما يتطلّب تحليل أنواع إيداع محدّدة من EDGAR. هنا هما حقلان من الدرجة الأولى في الواجهة نفسها مع البيانات المالية.

كيف يقارَن هذا بمزوّدي واجهات البيانات المالية؟

المزوّدون المتخصّصون (مثل واجهات البيانات المالية) يقدّمون واجهات عميقة مُنمَّطة وتاريخًا طويلًا — رائع إن كانت الأساسيات منتجك بالكامل. زاوية API Pick مختلفة: الأساسيات أداةٌ واحدة ضمن مجموعة (الأسواق، SEC، الاقتصاد، الأخبار) خلف مفتاح واحد، مُشكَّلة للاستعلام لوكيل، مُفوتَرة عند النجاح فقط. إن كنت تبني وكيلًا ماليًا لا منتج أساسيات، فالمجموعة-في-شكل-واحد هي المسار الأسرع.

هل هذه نصيحة استثمارية؟

لا. إنها بيانات مالية عامّة مُهيكَلة للبحث وتأصيل الوكلاء. تُنير تحليل شخص مؤهّل أو وكيل خاضع للإشراف؛ وهي ليست نصيحة، ويجب ألّا تقود تداولًا آليًا دون مسؤولية بشرية وضوابط مخاطر.

الواجهات البرمجية المستخدمة في هذا المقال

Sarah Choy
بقلم
Sarah Choy
CEO, API Pick

سارة تشوي هي الرئيسة التنفيذية لشركة API Pick. تكتب عن بناء واجهات برمجية جاهزة للإنتاج لوكلاء الذكاء الاصطناعي وسير عمل نماذج اللغة.