مفت اسٹاک مارکیٹ ڈیٹا API بغیر کلید

Strasmore ایک مفت اسٹاک مارکیٹ ڈیٹا API چلاتا ہے جس کے لیے نہ کلید درکار ہے اور نہ سائن اپ۔ یہ امریکی حصص اور آپشنز ڈیٹا پر متعدد منتخب، صرف پڑھنے کے قابل استفسارات کو HTTPS کے ذریعے سادہ JSON میں پیش کرتا ہے، اور یہ جان بوجھ کر AI ایجنٹس کے ساتھ ساتھ افراد کے لیے بھی کھلا ہے۔ یہ ایک زیادہ نایاب چیز کا بغیر کلید کا نمونہ بھی ہے: ایک مفت SQL API جہاں ایک مفت اکاؤنٹ اپنے استفسارات خود لکھتا ہے۔ یہ صفحہ ہر اینڈ پوائنٹ کی دستاویز کرتا ہے، کام کرتے ہوئے کالز دکھاتا ہے، اور وہی ڈیٹا چارٹ پر پیش کرتا ہے جو API واپس کرتا ہے۔

مفت API کیا فراہم کرتا ہے

ہر کلید ایک ایسے سوال کا جواب دیتی ہے جو کسی مارکیٹ قاری کے ذہن میں واقعی آتا ہے۔ اس تحریر کے وقت تک کیٹلاگ یہ ہے:

• spy_qqq: پچھلے 45 سیشنز میں SPY اور QQQ کے معیار بنائے گئے منافعے
• dividend_yield_leaders: تازہ ترین سیشن میں سب سے زیادہ بڑی کمپنیوں کے ڈیویڈنڈ ییلڈز
• upcoming_ex_dividends: آگے آنے والی امریکی ex-dividend تاریخیں، نقد رقم اور ادائیگی کی تاریخیں کے ساتھ
• short_interest_watch: تازہ ترین short-interest سیٹلمنٹ پر days-to-cover میں سرِفہرست نام
• iv_leaders: مائع آپشن انڈرلائنگز میں دن کے اختتام کیimplied-volatility کے سرِفہرست نام
• recent_ipos: پچھلے 180 دنوں میں امریکی لسٹنگز، آفر قیمت اور سائز کے ساتھ
• latest_market_news: تازہ ترین مارکیٹ ہیڈلائنز اور وہ ٹکرز جن کا ان میں ذکر ہے
• biggest_movers: تازہ ترین باقاعدہ سیشن میں مائع ناموں میں سب سے بڑی حرکتیں
• revenue_leaders: تازہ ترین سالانہ آمدنی اور خالص منافعے کے لحاظ سے سب سے بڑی امریکی کمپنیاں
• most_active_options: آپشن والیوم کہاں مرتکز ہے، اوسط implied volatility کے ساتھ
• put_call_ratio: سب سے زیادہ فعال انڈرلائنگز کے put/call والیوم ریوشوز
• upcoming_splits: حالیہ اور طے شدہ اسٹاک اسپلٹس
• market_holidays: آنے والی NYSE بندشوں اور جلد بندشوں کی تاریخیں

ایکویٹی قیمتوں میں تاخیر ہے۔ آپشنز گریکس اور implied volatility دن کے اختتام کی قدریں ہیں۔ ہر پے لوڈ میں وہ درست SQL شامل ہوتا ہے جس نے اسے پیدا کیا، لہذا کسی بھی عدد کو اس کی کوری تک پیچھا کیا جا سکتا ہے۔

اسے کیسے کال کریں

ایک GET درخواست، کوئی ہیڈر درکار نہیں:

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

کیٹلاگ اینڈ پوائنٹ ہر دستیاب کلید کو ایک تیار-fetch URL، ہر query کی سادہ انگریزی وضاحت، اور استعمال کے نوٹس کے ساتھ فہرست کرتا ہے۔ اگر آپ API کو پروگرامی طور پر دریافت کر رہے ہیں تو پہلے اسے fetch کریں:

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

جواب میں resolved کلید، وہ سوال جس کا وہ جواب دیتا ہے، SQL، کالم کے نام، صفیں، اور دو pointer فیلڈز شامل ہوتے ہیں۔ اس کا خاکہ (قدریں ہٹا دی گئی ہیں):

{
  "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 ..."
}

ایک ایسی کلید پاس کرنا جو موجود نہیں ہے وہ default query پیش کرتا ہے اور ناکام ہونے کے بجائے اسے ایک fallback_from فیلڈ کے ساتھ flag کرتا ہے۔ اس فیلڈ کو ہجے کی ایک وارننگ سمجھیں، اور کیٹلاگ کو درست کلیدز کے لیے حتمی ذریعہ سمجھیں۔

ایجنٹس اور LLMs کے لیے بنایا گیا

یہ ڈیمو اس سافٹ ویئر کے بلائے جانے کے لیے ڈیزائن کیا گیا ہے جسے آپ کو آج لکھنے کی ضرورت نہیں۔ جوابات access-control-allow-origin: * سیٹ کرتے ہیں اور CORS preflights کسی بھی ماخذ سے اجازت دینے کے طور پر جواب دیتے ہیں، اس لیے براؤزر ایپس، نوٹ بکس، اور 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۔

ڈیمو سے مکمل گودام تک

ڈیمو کے سوالات جان بوجھ کر مقفل ہیں۔ یہ سستے رہتے ہیں۔ یہ کیشے میں محفوظ ہو سکتے ہیں۔ ہر کسی کے لیے کھلے ہونے میں محفوظ ہیں۔ ان کے پیچھے موجود گودام میں امریکی اسٹاک کی بائیس سالہ اور آپشنز کی بارہ سالہ تاریخ موجود ہے۔ ایک مفت اکاؤنٹ (کارڈ نہیں) اس کے خلاف اپنا SQL لکھتا ہے، دن میں سو سوالات۔ ادائیگی والے درجات مکمل تاریخ، ٹک ڈیٹا، اور پروگرامیٹک API کلیدز کھولتے ہیں۔ جب مقفل اسکرین کافی نہ رہے، تو مفت SQL درجہ اگلا درجہ ہے۔

سوالات

کیا Strasmore کی مارکیٹ ڈیٹا API واقعی مفت ہے؟

ہاں۔ ڈیمو اینڈ پوائنٹس کے لیے نہ کلید درکار ہے، نہ سائن اپ، اور نہ ادائیگی کی تفصیلات۔ یہ صرف مقررہ queries پیش کرتے ہیں۔ مکمل پروڈکٹ پر غیر معمولی سوالات چلتے ہیں۔

کیا مجھے API کلید یا تصدیق درکار ہے؟

نہیں۔ ہر ڈیمو اینڈ پوائنٹ سادہ غیر تصدیق شدہ GET درخواستوں کا جواب دیتا ہے۔ کلید صرف ادا شدہ پروگرامی API کے لیے موجود ہے، جو مخصوص queries چلاتا ہے۔

ڈیمو ڈیٹا کتنی تازہ ہے؟

ایکویٹی قیمتز حقیقی وقت کی بجائے تاخیری ہیں۔ تناسب، شارٹ انٹرسٹ، اور کارپوریٹ ایکشنز اپنے ماخذ کی کیڈینس پر اپڈیٹ ہوتے ہیں۔ Greeks اور مضمر اتارپزن دن کے اختتام کی ہیں۔ ہر query کا نتیجہ زیادہ سے زیادہ دس منٹ بعد ریفریش ہوتا ہے۔

کیا میرا LLM ایجنٹ یا براؤزر ایپ اسے براہ راست کال کر سکتا ہے؟

ہاں۔ جوابات کسی بھی اصل سے open CORS کے ساتھ آتے ہیں، preflights ہر جگہ کامیاب ہوتے ہیں، اور /api/demo/catalog پر کیٹلاگ ہر query کو JSON میں بیان کرتا ہے جسے ایجنٹ بغیر دستاویز کے پڑھ سکتا ہے۔

اگر میں ایسی کلید درخواست کروں جو موجود نہیں ہے تو کیا ہوتا ہے؟

API پہلے سے طے شدہ spy_qqq query پیش کرتا ہے اور fallback_from فیلڈ شامل کرتا ہے جس میں آپ نے جس چیز کی درخواست کی تھی اس کا نام ہوتا ہے۔ درست کلیدز کی فہرست کے لیے کیٹلاگ دیکھیں۔

اس صفحے پر ہر پینل ایک لائیو اسٹورڈ query ہے، اور اسی گودام آپ کے خود لکھے گئے سوالات کا جواب دیتا ہے، چاہے وہ SQL میں ہو یا سادہ انگریزی میں، Strasmore terminal پر۔