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

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

ما تقدمه واجهة برمجة التطبيقات (API) المجانية

تجيب كل مفتاح على سؤال يطرحه قارئ السوق. القائمة المتاحة وقت كتابة هذا التقرير:

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

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

كيفية الاستدعاء

طلب GET واحد، ولا يلزم وجود أي ترويسات (headers):

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

تدرج نقطة نهاية الفهرس (catalog endpoint) كل مفتاح متاح مع رابط جاهز للاستدعاء، ووصف واضح لكل استعلام، وملاحظات حول الاستخدام. يفضل استدعاء الفهرس أولاً إذا كنت تقوم باكتشاف واجهة برمجة التطبيقات (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 بدلاً من حدوث خطأ. تعامل مع هذا الحقل كإشعار بوجود خطأ إملائي، واعتمد الفهرس كمصدر موثوق للمفاتيح الصحيحة.

مُصمم للوكلاء والنماذج اللغوية الكبيرة (LLMs)

صُممت النسخة التجريبية ليتم استدعاؤها بواسطة برمجيات لم تضطر لكتابتها اليوم. تُعد استجابات access-control-allow-origin: * وطلبات CORS preflights مرنة وتسمح بالوصول من أي مصدر، مما يتيح لتطبيقات المتصفح، ودفاتر الملاحظات (notebooks)، ووكلاء 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 يومًا. خلال 30 من جلسات النافذة الحالية، يقيس التحرك التراكمي لـ SPY نسبة -1.6% بينما يقيس لـ QQQ نسبة -5.69%.

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% مع قيمة سوقية تزيد عن 2 مليار دولار. يزيل الحد الأدنى الضجيج، بينما يزيل الحد الأعلى الآثار الناتجة عن التوزيعات النقدية الخاصة التي تظهر كعوائد لا يمكن للشركة الاستمرار عليها. اعتبارًا من Jul 17، تبلغ أعلى قيمة في التصفية STRC بنسبة 13.45%. لمعرفة كيفية قراءة سجل توزيعات شركة واحدة على مدى عقود، راجع تاريخ توزيعات مايكروسوفت.

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 بحساب متوسط التقلب الضمني عند نهاية اليوم لكل أصل أساسي عبر جميع أسعار التنفيذ وتواريخ الاستحقاق المدرجة، ويحتفظ بالأسهم ذات حجم التداول الهام في الخيارات، ثم يرتبها. المتصدر الحالي هو SNXX بمتوسط تقلب ضمني قدره 299.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 data)، ومفاتيح واجهة برمجة التطبيقات (API) البرمجية. عندما لا تعود الشاشة الثابتة كافية، فإن فئة SQL المجانية هي الخطوة التالية.

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

هل واجهة برمجة تطبيقات (API) بيانات Strasmore مجانية حقاً؟

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

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

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

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

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

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

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

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

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

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