استفاده از SQL API رایگان برای داده‌های سهام

یک API رایگان برای دسترسی به داده‌های بازار سهام در دسترس است و این صفحه مستندات آن را ارائه می‌دهد. APIهای رایگان برای داده‌های بازار بسیار زیاد هستند؛ اما رابطی که دستورات SQL شما را بپذیرد، آن‌ها را بر روی 22 سال تاریخچه سهام ایالات متحده اجرا کند و نتیجه را در قالب JSON بازگرداند، مورد متفاوتی است. سطح رایگان Strasmore دقیقاً همین ویژگی را دارد: 100 پرس‌وجو در روز، با قابلیت نوشتن دستورات توسط کاربر و بدون نیاز به کارت اعتباری.

APIهای رایگان داده رایج هستند، اما SQL رایگان نیست.

یک API رایگانِ معمولی، نقاط اتصال (endpoints) ثابتی را در اختیار شما قرار می‌دهد. برای هر مجموعه داده تنها یک URL وجود دارد و پارامترها توسط فروشنده تعیین می‌شوند؛ بنابراین هر سوالی که می‌پرسید باید با یکی از نقاط اتصال از پیش ساخته شده مطابقت داشته باشد. به محض اینکه سوال شما از دو مجموعه داده فراتر رود (مانند «رشد سود نقدی برای شرکت‌هایی که میزان فروش استقراضی آن‌ها کاهش یافته است»)، مجبور خواهید بود فایل‌های CSV را دانلود و خودتان آن‌ها را با هم ترکیب کنید.

SQL این محدودیت را از بین می‌برد. در اینجا، خودِ پرس‌وجو (query) همان نقطه اتصال است. عملیات‌هایی نظیر Joinها، توابع پنجره‌ای (window functions)، تجمیع‌ها (aggregations) و محاسبات تاریخ، دقیقاً در محل ذخیره‌سازی داده‌ها اجرا می‌شوند و شما به جای مواد خام، مستقیماً پاسخ را دانلود می‌کنید. تمام نمودارهای این وبلاگ به همین صورت عمل می‌کنند و کد SQL تنها با یک کلیک در زیر هر نمودار در دسترس است.

محتوای انبار داده

سطح قابل پرس‌وجو، یک انبار داده ClickHouse شامل داده‌های بازار ایالات متحده است: مجموع قیمت‌های روزانه و دقیقه‌ای از سال 2003، سود نقدی و تجزیه سهام، داده‌های بنیادی فصلی، نسبت‌های ارزش‌گذاری، میزان و حجم فروش استقراضی، IPOها، اخبار بازار، و یک مجموعه داده آپشن شامل greeks و نوسان‌پذیری ضمنی پایان روز از سال 2014. پنل‌های زیر سه پرس‌وجوی واقعی را روی آن اجرا می‌کنند که هر کدام ساختاری پیچیده دارند که APIهای با نقطه پایانی ثابت در مواجهه با آن‌ها دچار مشکل می‌شوند.

یک سابقه بیست‌ساله سود نقدی در قالب یک دستور GROUP BY. شرکت Coca-Cola در بازه‌های 2004 و 2.04 به ازای هر سهم مبلغ 1 پرداخت کرده است و سطرهای سالانه در بازه 2025 تا 22، کل تاریخچه را استخراج می‌کنند. برای بررسی دقیق‌تر یک نماد خاص، سابقه سود نقدی Microsoft را ببینید.

SELECT toYear(ex_dividend_date) AS year,
       round(sum(cash_amount), 2) AS total_cash_per_share
FROM global_markets.stocks_dividends
WHERE ticker = 'KO'
  AND cash_amount IS NOT NULL
  AND ex_dividend_date >= '2004-01-01'
  AND toYear(ex_dividend_date) < toYear(today())
GROUP BY year
ORDER BY year

ساختار زمانی نوسان‌پذیری آپشن، که در یک مرحله محاسبه می‌شود. میانگین نوسان‌پذیری ضمنی پایان روز برای SPY بر اساس دسته‌بندی تاریخ انقضا، شامل 9 دسته از ابتدای منحنی تا بیش از یک سال. دسته اول در آخرین جلسه معاملاتی، مقدار 26.4% را نشان می‌دهد. این مجموعه داده (greeks و نوسان‌پذیری ضمنی) در سطوح پولی قرار دارد و نسخه آزمایشی هفت‌روزه که همراه با حساب رایگان ارائه می‌شود، شامل آن به طور کامل می‌شود.

SELECT least(floor(days_to_expiry / 30) * 30, 360) AS dte_bucket_days,
       round(avg(implied_volatility) * 100, 1) AS avg_iv_pct
FROM global_markets.options_greeks
WHERE underlying_symbol = 'SPY'
  AND date = (SELECT max(date) FROM global_markets.options_greeks)
  AND iv_converged
  AND days_to_expiry BETWEEN 1 AND 400
GROUP BY dte_bucket_days
ORDER BY dte_bucket_days

فیلتر ارزش‌گذاری برای بزرگ‌ترین نمادها. تمام شرکت‌هایی با ارزش بازار بیش از 500 میلیارد دلار و P/E مثبت، که بر اساس اندازه رتبه‌بندی شده‌اند. بزرگ‌ترین شرکت، یعنی NVDA، در آخرین جلسه معاملاتی با ضریب 30.8 نسبت به سود معامله می‌شود.

SELECT ticker,
       round(price_to_earnings, 1) AS pe_ratio
FROM global_markets.stocks_ratios
WHERE date = (SELECT max(date) FROM global_markets.stocks_ratios)
  AND market_cap > 5e11
  AND price_to_earnings > 0
  AND ticker NOT IN ('SPCX')
ORDER BY market_cap DESC
LIMIT 12

ویژگی‌های طرح رایگان

حساب کاربری رایگان یک سطح واقعی SQL با محدودیت‌های مشخص است که دقیقاً به شرح زیر می‌باشد:

• 100 پرس‌وجو در روز، به زبان SQL یا انگلیسی ساده (ترمینال زبان انگلیسی را به SQL ترجمه می‌کند و پیش از اجرا، پرس‌وجو را به شما نمایش می‌دهد).
• دو سال تاریخچه قیمت در طرح رایگان؛ دسترسی به تمام 22 سال در طرح‌های پولی فراهم است.
• داده‌های تجمیعی روزانه و دقیقه‌ای، سود نقدی، تجزیه سهام، داده‌های بنیادی، نسبت‌ها، میزان فروش استقراضی، IPOها و اخبار همگی در طرح رایگان قابل پرس‌وجو هستند. معاملات و قیمت‌های سطح Tick، به همراه مجموعه داده‌های greeks/IV، از ویژگی‌های طرح‌های پولی هستند.
• هر حساب کاربری جدید با یک دوره آزمایشی هفت‌روزه از طرح Quotes آغاز می‌شود؛ بدون نیاز به ثبت کارت بانکی، که دسترسی به تمام تاریخچه و مجموعه‌داده‌های محدود شده را در طول دوره ارزیابی فراهم می‌کند.
• تمام دسترسی‌ها از طریق یک دروازه SQL و به صورت فقط-خواندنی است. دستورات SELECT و WITH اجرا می‌شوند؛ هیچ دستور دیگری قابل اجرا نیست.

هیچ ترفندی برای دور زدن محدودیت‌ها وجود ندارد: محدودیت‌های ذکر شده در بالا، پیکربندی واقعی محصول هستند و این محدودیت‌ها برای نشست‌های مرورگر و فراخوانی‌های API به یک شکل اعمال می‌شوند.

پیش از ثبت‌نام، آن را امتحان کنید

مکمل بدون نیاز به رمز عبور برای سطح SQL، نسخه آزمایشی رایگان API است: فهرستی از پرس‌وجوهای ثابت که بدون نیاز به هیچ حسابی در دسترس هستند و هر پاسخ شامل کد SQL تولیدکننده آن است. این قابلیت برای این طراحی شده است که شما (یا عامل هوش مصنوعی شما) بتوانید تنها با یک دستور curl، ساختار داده‌ها را مشاهده کنید و سپس تصمیم بگیرید که آیا استفاده از سطح SQL ارزش ارائه آدرس ایمیل را دارد یا خیر. فهرست موجود در https://ai.strasmore.com/api/demo/catalog شامل تمام کلیدها است.

سوالات متداول

آیا واقعاً یک API رایگان وجود دارد که SQL را بپذیرد؟

بله. یک حساب کاربری رایگان Strasmore اجازه اجرای تا 100 پرس‌وجوی SQL اختصاصی را در روز را برای دسترسی به انبار داده‌های سهام ایالات متحده (فقط خواندنی) با دو سال تاریخچه می‌دهد. هیچ اطلاعات پرداختی مورد نیاز نیست.

از چه گویش SQL استفاده می‌کند؟

ClickHouse SQL. سینتکس استاندارد SELECT به همراه توابع پنجره‌ای (window functions) و همچنین ترکیبات تجمیعی (aggregate combinators) در ClickHouse. پنل‌های وبلاگ به عنوان مثال‌های عملی عمل می‌کنند و کد SQL دقیق هر نمودار در بخش قابل گسترش در زیر آن قرار دارد.

آیا می‌توانم بدون نوشتن SQL از آن استفاده کنم؟

بله. ترمینال پرسش‌های ساده به زبان انگلیسی را می‌پذیرد، کد SQL را برای شما می‌نویسد و پیش از اجرا، پرس‌وجو را نمایش می‌دهد. SQL تولید شده قابل ویرایش است که روشی سریع برای یادگیری ساختار داده‌ها (schema) محسوب می‌شود.

محدودیت‌های دقیق سطح رایگان چیست؟

100 پرس‌وجو در روز، 2 سال تاریخچه، دسترسی فقط خواندنی، و محدودیت دسترسی به مجموعه‌داده‌های tick-level و greeks برای سطوح پولی. یک دوره آزمایشی کامل 7 روزه بدون نیاز به کارت بانکی بلافاصله پس از ثبت‌نام آغاز می‌شود.

آیا گزینه‌ای بدون نیاز به ثبت‌نام وجود دارد؟

API دمو. مجموعه‌ای از پرس‌وجوهای ثابت روی همان انبار داده با قابلیت CORS باز و بدون نیاز به کلید. این بخش پرس‌وجوهای SQL سفارشی را نمی‌پذیرد و صرفاً برای ارزیابی فوری و استفاده توسط عامل‌های هوش مصنوعی طراحی شده است.

پنل‌های بالا شامل پرس‌وجوهای ذخیره‌شده‌ای هستند که هر کسی می‌تواند آن‌ها را بخواند؛ همان انبار داده، پرسش‌های شخصی شما را در ترمینال Strasmore نیز می‌پذیرد.