واجهة API مجانية لبيانات الأسهم بلا مفتاح

تدير Strasmore واجهة API مجانية لبيانات سوق الأسهم، ولا تتطلب مفتاحاً أو تسجيلاً. وتوفر مجموعة متنامية من الاستعلامات المنسّقة للقراءة فقط حول بيانات الأسهم والخيارات الأمريكية، بصيغة JSON عادية عبر HTTPS. وقد صُممت عمداً لتكون مفتوحة لوكلاء الذكاء الاصطناعي وكذلك للأشخاص. وهي أيضاً العرض التجريبي من دون مفتاح لفكرة أكثر ندرة: واجهة SQL API مجانية يكتب فيها الحساب المجاني استعلاماته بنفسه. توثّق هذه الصفحة كل نقطة نهاية، وتعرض استدعاءات عاملة، وترسم البيانات نفسها التي تعيدها واجهة API.

ما الذي تتيحه واجهة API المجانية

يجيب كل مفتاح عن سؤال يطرحه قارئ بيانات السوق فعلياً. وفيما يلي الكتالوج حتى تاريخ إعداد هذا النص:

• spy_qqq: العوائد المطبَّعة لسهمي SPY وQQQ خلال آخر 45 جلسة
• dividend_yield_leaders: أعلى عوائد توزيعات أرباح لأسهم الشركات الكبرى في أحدث جلسة
• upcoming_ex_dividends: تواريخ ex-dividend المقبلة في الولايات المتحدة، مع المبالغ النقدية وتواريخ الدفع
• short_interest_watch: الأسهم الأعلى من حيث نسبة أيام تغطية المراكز القصيرة في أحدث تسوية لبيانات الفائدة القصيرة
• iv_leaders: الأسهم الأساسية لعقود الخيارات ذات أعلى تقلب ضمني في نهاية اليوم، بين الأوراق المالية السائلة
• recent_ipos: الإدراجات الأمريكية خلال آخر 180 يوماً، مع سعر الطرح وحجمه
• latest_market_news: أحدث عناوين أخبار السوق وtickers التي تذكرها
• biggest_movers: أكبر التحركات في أحدث جلسة اعتيادية بين الأسهم السائلة
• revenue_leaders: أكبر الشركات الأمريكية من حيث أحدث إيرادات سنوية وصافي دخل
• most_active_options: الأسهم الأساسية التي تتركز فيها أحجام تداول الخيارات، مع متوسط التقلب الضمني
• put_call_ratio: نسب أحجام تداول خيارات put/call للأسهم الأساسية الأكثر نشاطاً
• upcoming_splits: عمليات تجزئة الأسهم الأخيرة والمجدولة
• market_holidays: الإغلاقات المقبلة لبورصة NYSE والإغلاقات المبكرة

أسعار الأسهم متأخرة. أما Greeks الخيارات والتقلب الضمني فهي قيم لنهاية اليوم. وتتضمن كل حزمة البيانات استعلام SQL الدقيق الذي أنتجها، ولذلك يمكن تتبع أي رقم إلى الاستعلام الخاص به.

طريقة استدعائه

يتطلب الأمر طلب GET واحداً فقط، ولا يحتاج إلى ترويسات:

curl "https://ai.strasmore.com/api/demo?q=dividend_yield_leaders"

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

curl "https://ai.strasmore.com/api/demo/catalog"

تتضمن الاستجابة المفتاح المحلَّل، والسؤال الذي يجيب عنه، وSQL، وأسماء الأعمدة، والصفوف، وحقلين إرشاديين. ويكون الهيكل على النحو الآتي، مع حجب القيم:

{
  "key": "dividend_yield_leaders",
  "label": "Highest dividend yields, large caps, latest session",
  "nl": "Which large-cap US stocks currently have the highest dividend yields?",
  "sql": "SELECT ...",
  "columns": ["as_of", "ticker", "dividend_yield_pct", "..."],
  "rows": ["..."],
  "source": "Strasmore Research",
  "more": "Get more at https://www.strasmore.com ..."
}

عند تمرير مفتاح غير موجود، تُرجع الواجهة الاستعلام الافتراضي وتضع علامة عليه في حقل fallback_from بدلاً من إرجاع خطأ. تعامل مع هذا الحقل باعتباره تنبيهاً إلى وجود خطأ إملائي، وتعامل مع الكتالوج باعتباره المرجع المعتمد للمفاتيح الصحيحة.

مصمَّم للوكلاء وLLM

صُمِّم العرض التجريبي بحيث تستدعيه برمجيات لم تكن بحاجة إلى كتابتها اليوم. يضبط access-control-allow-origin: *، وتستجيب طلبات CORS التمهيدية بسياسة تسمح بأي مصدر، لذلك يمكن لتطبيقات المتصفح ودفاتر الملاحظات ووكلاء LLM جلب البيانات منه مباشرة. في الخلفية، يُعاد احتساب كل استعلام مرة واحدة على الأكثر كل عشر دقائق، وتُقدَّم النتائج من الذاكرة خلال بضعة أجزاء من الألف من الثانية.

نقاط الدخول القابلة للقراءة آلياً، بالترتيب الذي ينبغي للوكلاء قراءتها به:

1. يعرّف https://www.strasmore.com/llms.txt فهرس المحتوى وواجهة API التجريبية في ملف موجز واحد.
2. يسرد https://ai.strasmore.com/api/demo/catalog كل استعلام مع عنوان URL الخاص به.
3. يشير الحقل more في كل استجابة إلى الكتالوج والمنتج الكامل.

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

البيانات وراء العرض التوضيحي

تأتي إجابات API من المستودع نفسه الذي يقرأ منه هذا المدوّنة. تنفّذ اللوحات أدناه استعلامات العرض التوضيحي عبر مسار المدونة، مع إظهار SQL أسفل كل لوحة.

يحوّل المفتاح spy_qqq أسعار الإغلاق لـ SPY وQQQ إلى عوائد مئوية محسوبة من بداية نافذة مدتها 45 يوماً. وخلال جلسات 33 في النافذة الحالية، يقيس التحرك التراكمي لـ SPY نسبة 3.05%، فيما تبلغ نسبة التحرك التراكمي لـ QQQ 1.79%.

SELECT day,
       round((spy / first_value(spy) OVER (ORDER BY day ASC) - 1) * 100, 2) AS spy_return_pct,
       round((qqq / first_value(qqq) OVER (ORDER BY day ASC) - 1) * 100, 2) AS qqq_return_pct
FROM (
    SELECT toDate(window_start) AS day,
           argMaxIf(close, window_start, ticker = 'SPY') AS spy,
           argMaxIf(close, window_start, ticker = 'QQQ') AS qqq
    FROM global_markets.delayed_stocks_minute_aggs
    WHERE ticker IN ('SPY', 'QQQ') AND window_start >= now() - INTERVAL 45 DAY
    GROUP BY day
)
ORDER BY day

يفحص المفتاح dividend_yield_leaders العوائد التي تتراوح بين 2% و15%، مع اشتراط أن تتجاوز القيمة السوقية ملياري دولار. يزيل الحد الأدنى الضوضاء، بينما يستبعد الحد الأقصى الحالات الاستثنائية لتوزيعات الأرباح التي تظهر كعوائد لا تستطيع أي شركة الحفاظ عليها. اعتباراً من Sep 3، يتصدر نتائج الفحص ARR عند 14.75%. وللاطلاع على كيفية ظهور سجل توزيعات شركة واحدة عبر عقود، راجع سجل توزيعات أرباح Microsoft.

SELECT ticker,
       round(dividend_yield * 100, 2) AS dividend_yield_pct,
       formatDateTime(date, '%b %e') AS as_of_label
FROM global_markets.stocks_ratios
WHERE date = (SELECT max(date) FROM global_markets.stocks_ratios)
  AND dividend_yield BETWEEN 0.02 AND 0.15
  AND market_cap > 2e9
  AND ticker NOT IN ('SPCX')
ORDER BY dividend_yield DESC
LIMIT 12

يحسب المفتاح iv_leaders متوسط التقلب الضمني في نهاية اليوم لكل سهم أساسي عبر جميع أسعار التنفيذ وتواريخ الانقضاء المدرجة، ويُبقي على الأسهم ذات حجم الخيارات المؤثر ثم يرتبها. يتصدر القائمة حالياً EYPT بمتوسط تقلب ضمني يبلغ 199.1%. وتشير القراءات المرتفعة في هذا الفحص إلى أسهم يسعّر فيها سوق الخيارات تحركات كبيرة؛ ويعرض الفحص المستوى ويترك تفسيره لك.

SELECT underlying_symbol AS ticker,
       round(avg(implied_volatility) * 100, 1) AS avg_iv_pct
FROM global_markets.options_greeks
WHERE date = (SELECT max(date) FROM global_markets.options_greeks)
  AND iv_converged
  AND underlying_symbol NOT IN ('SPCX')
GROUP BY underlying_symbol
HAVING sum(volume) > 10000
ORDER BY avg_iv_pct DESC
LIMIT 12

يرتب المفتاح short_interest_watch عدد الأيام اللازمة لتغطية مراكز البيع على المكشوف، باستخدام مجموعة بيانات FINRA نفسها المشروحة في دليلنا لبيانات الفائدة على المكشوف، بينما يقرأ upcoming_ex_dividends تقويم إجراءات الشركات. ويتبع كلاهما النمط الوارد أعلاه: فحص ثابت، ونتيجة محددة النطاق، وSQL ضمن الحمولة.

من العرض التجريبي إلى مستودع البيانات الكامل

استعلامات العرض التجريبي ثابتة عن قصد. فهي تظل منخفضة التكلفة وقابلة للتخزين المؤقت وآمنة لإتاحتها للجميع. يضم مستودع البيانات الذي يقف وراءها 22 عاماً من بيانات الأسهم الأمريكية و12 عاماً من السجل التاريخي للخيارات. ويتيح الحساب المجاني، من دون بطاقة، كتابة استعلامات SQL خاصة بك على هذه البيانات، بواقع 100 استعلام يومياً. تتيح الفئات المدفوعة السجل التاريخي الكامل، وبيانات tick، ومفاتيح API للاستخدام البرمجي. وعندما لا تعود الشاشة الثابتة كافية، تكون فئة SQL المجانية هي الخطوة التالية.

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

هل واجهة برمجة تطبيقات بيانات السوق من Strasmore مجانية فعلاً؟

نعم. لا تتطلب نقاط النهاية التجريبية مفتاحاً أو تسجيل حساب أو بيانات دفع. وهي تنفّذ استعلامات ثابتة فقط؛ أما الاستعلامات المخصصة فتتطلب المنتج الكامل.

هل أحتاج إلى مفتاح API أو مصادقة؟

لا. تستجيب كل نقطة نهاية تجريبية لطلبات GET عادية من دون مصادقة. وتُستخدم المفاتيح فقط مع API البرمجية المدفوعة، التي تنفّذ استعلامات مخصصة.

ما مدى حداثة البيانات التجريبية؟

أسعار الأسهم متأخرة وليست فورية. وتتحدث النسب، ومراكز البيع على المكشوف، وإجراءات الشركات وفق دورات التحديث لدى مصادرها. أما Greeks والتقلب الضمني فهما في نهاية اليوم. ولا يتجدد ناتج أي استعلام أكثر من مرة كل عشر دقائق.

هل يستطيع وكيل LLM أو تطبيق المتصفح لدي استدعاءها مباشرة؟

نعم. تستجيب الواجهة بطلبات CORS مفتوحة من أي مصدر، وتنجح طلبات preflight في جميع الحالات، كما يصف الكتالوج في /api/demo/catalog كل استعلام بصيغة JSON يستطيع الوكيل قراءتها من دون وثائق.

ماذا يحدث إذا طلبت مفتاحاً غير موجود؟

تعرض الواجهة الاستعلام الافتراضي spy_qqq، وتضيف حقل fallback_from يوضح ما طلبته. راجع الكتالوج للاطلاع على قائمة المفاتيح الصالحة.

كل لوحة في هذه الصفحة هي استعلام مخزَّن مباشر، ويجيب مستودع البيانات نفسه عن الأسئلة التي تكتبها بنفسك باستخدام SQL أو باللغة الإنجليزية العادية على محطة Strasmore.