ফ্রি স্টক মার্কেট ডেটা API কোনো কী ছাড়াই

Strasmore একটি বিনামূল্যে স্টক মার্কেট ডেটা API পরিচালনা করে, যার জন্য কোনো কী (key) বা সাইনআপের প্রয়োজন হয় না। এটি US equities এবং options ডেটার ওপর ভিত্তি করে একটি ক্রমবর্ধমান কিউরেটেড, রিড-অনলি কুয়েরি প্রদান করে। এই ডেটা HTTPS-এর মাধ্যমে plain JSON ফরম্যাটে পাওয়া যায়। এটি মানুষ এবং AI এজেন্ট উভয়ের জন্যই উন্মুক্ত রাখা হয়েছে। এটি একটি বিরল বিষয়ের কী-লেস ডেমো: একটি free SQL API যেখানে একটি ফ্রি অ্যাকাউন্ট ব্যবহারকারী নিজেই নিজের কুয়েরি লিখতে পারেন। এই পৃষ্ঠাটি প্রতিটি endpoint ডকুমেন্ট করে, কার্যকর কলসমূহ দেখায় এবং API যে ডেটা প্রদান করে সেই একই ডেটার চার্ট প্রদর্শন করে।

ফ্রি API কী কী তথ্য প্রদান করে

প্রতিটি কী (key) বাজারের পাঠকদের একটি নির্দিষ্ট প্রশ্নের উত্তর দেয়। এই নিবন্ধটি লেখার সময় ক্যাটালগটি নিম্নরূপ:

• spy_qqq: গত ৪৫টি সেশনের ভিত্তিতে SPY এবং QQQ-এর নরমালাইজড রিটার্ন
• dividend_yield_leaders: সর্বশেষ সেশনে সবচেয়ে বেশি লার্জ-ক্যাপ ডিভিডেন্ড ইল্ড (dividend yields)
• upcoming_ex_dividends: আগামীদিনের US ex-dividend তারিখ, নগদ পরিমাণ এবং প্রদানের তারিখসহ
• short_interest_watch: সর্বশেষ শর্ট-ইন্টারেস্ট সেটেলমেন্ট অনুযায়ী days-to-cover লিডারসমূহ
• iv_leaders: লিকুইড অপশন আন্ডারলাইংয়ের মধ্যে ইমপ্লাইড-ভোলাটিলিটি লিডারসমূহ (end-of-day)
• recent_ipos: গত ১৮০ দিনের US লিস্টিং, অফার প্রাইস এবং সাইজসহ
• latest_market_news: সাম্প্রতিক বাজার সংবাদের শিরোনাম এবং সংশ্লিষ্ট টিকারসমূহ
• biggest_movers: সর্বশেষ রেগুলার সেশনে লিকুইড স্টকের মধ্যে সবচেয়ে বড় মুভমেন্টসমূহ
• revenue_leaders: সর্বশেষ বার্ষিক রাজস্ব এবং নিট ইনকাম অনুযায়ী বৃহত্তম US কোম্পানিসমূহ
• most_active_options: অপশন ভলিউম যেখানে কেন্দ্রীভূত এবং গড় ইমপ্লাইড ভোলাটিলিটি
• put_call_ratio: সবচেয়ে সক্রিয় আন্ডারলাইংয়ের put/call ভলিউম রেশিও
• upcoming_splits: সাম্প্রতিক এবং নির্ধারিত স্টক স্প্লিট
• market_holidays: আসন্ন NYSE বন্ধ এবং আগাম বন্ধের সময়সূচী

ইকুইটি প্রাইস বা শেয়ারের দাম বিলম্বিত (delayed)। অপশন গ্রিকস এবং ইমপ্লাইড ভোলাটিলিটি হলো দিনের শেষে প্রাপ্ত মান (end-of-day values)। প্রতিটি পেলোড-এর সাথে সঠিক SQL অন্তর্ভুক্ত থাকে, যার ফলে যেকোনো সংখ্যা সরাসরি তার কুয়েরি (query) দিয়ে যাচাই করা সম্ভব।

এটি যেভাবে কল করবেন

কোনো হেডার ছাড়াই একটি GET রিকোয়েস্ট ব্যবহার করুন:

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

ক্যাটালগ এন্ডপয়েন্টটি প্রতিটি উপলব্ধ কী (key), একটি প্রস্তুতকৃত URL, প্রতিটি কুয়েরির সহজবোধ্য বর্ণনা এবং ব্যবহারের নোট প্রদান করে। আপনি যদি প্রোগ্রামিংয়ের মাধ্যমে API অন্বেষণ করতে চান, তবে প্রথমে এটি কল করুন:

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

একটি রেসপন্সের মধ্যে থাকবে সমাধানকৃত কী, এর মাধ্যমে যে প্রশ্নটির উত্তর পাওয়া যায় তা, SQL, কলামের নাম, রো (rows) এবং দুটি পয়েন্টার ফিল্ড। এর গঠন (মানগুলো বাদ দেওয়া হয়েছে):

{
  "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 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 কী (key) SPY এবং QQQ-এর ক্লোজিং প্রাইসকে ৪৫ দিনের উইন্ডোর শুরুর সময়ের সাপেক্ষে পার্সেন্টেজ রিটার্ন হিসেবে নরমালাইজ করে। বর্তমান উইন্ডোর 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 কী ২% থেকে ১৫% এর মধ্যে ইল্ড (yield) এবং ২ বিলিয়ন ডলারের বেশি মার্কেট ক্যাপ বিশিষ্ট স্টকগুলো বাছাই করে। নিচের সীমাটি অপ্রয়োজনীয় ডেটা (noise) দূর করে এবং উপরের সীমাটি বিশেষ ডিভিডেন্ডের প্রভাব দূর করে, যা এমন ইল্ড হিসেবে দেখায় যা কোনো কোম্পানি দীর্ঘস্থায়ী করতে পারে না। Jul 17 অনুযায়ী, স্ক্রিনের শীর্ষে থাকা কোম্পানিটি হলো STRC, যার ইল্ড 13.45%। কোনো নির্দিষ্ট কোম্পানির কয়েক দশকের ডিভিডেন্ড হিস্ট্রি সম্পর্কে জানতে 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 কী সমস্ত লিস্টেড স্ট্রাইক এবং এক্সপায়রি অনুযায়ী প্রতিটি আন্ডারলাইয়িং অ্যাসেটের এন্ড-অফ-ডে ইমপ্লাইড ভলাটিলিটি (implied volatility) এর গড় নির্ণয় করে। এটি অর্থবহ অপশন ভলিউম আছে এমন নামগুলো রাখে এবং সেগুলোকে র‍্যাঙ্ক করে। বর্তমানে শীর্ষস্থানে রয়েছে 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 ডেটাসেট থেকে 'days-to-cover' র‍্যাঙ্ক করে এবং upcoming_ex_dividends কর্পোরেট-অ্যাকশন ক্যালেন্ডার থেকে ডেটা সংগ্রহ করে। উভয় ক্ষেত্রেই উপরের নিয়ম অনুসরণ করা হয়েছে: একটি নির্দিষ্ট ফিল্টার, একটি নির্দিষ্ট ফলাফল এবং পেলোড হিসেবে SQL কোড।

ডেমো থেকে পূর্ণাঙ্গ ওয়্যারহাউস পর্যন্ত

ডেমোর কুয়েরিগুলো উদ্দেশ্যমূলকভাবে নির্দিষ্ট করা হয়েছে: এগুলো সাশ্রয়ী, ক্যাশেযোগ্য এবং সবার জন্য উন্মুক্ত রাখা নিরাপদ। এর পেছনের ওয়্যারহাউসে ২২ বছরের US equities এবং ১২ বছরের options history রয়েছে। একটি ফ্রি অ্যাকাউন্ট (কোনো কার্ড ছাড়াই) দিনে ১০০টি কুয়েরি পর্যন্ত এর বিপরীতে নিজস্ব SQL লিখতে পারে। পেইড টায়ারগুলো পূর্ণাঙ্গ ইতিহাস, tick data এবং programmatic API keys ব্যবহারের সুবিধা দেয়। যখন একটি নির্দিষ্ট স্ক্রিন যথেষ্ট হয় না, তখন free SQL tier হলো পরবর্তী ধাপ।

FAQ

Strasmore market data API কি সত্যিই বিনামূল্যে?

হ্যাঁ। ডেমো এন্ডপয়েন্টগুলোর জন্য কোনো কী (key), সাইনআপ বা পেমেন্ট ডিটেইলসের প্রয়োজন নেই। এগুলো শুধুমাত্র নির্দিষ্ট কুয়েরি প্রদান করে; যেকোনো ধরণের সাধারণ কুয়েরির জন্য পূর্ণাঙ্গ প্রোডাক্ট ব্যবহার করতে হয়।

আমার কি কোনো API key বা অথেন্টিকেশন প্রয়োজন?

না। প্রতিটি ডেমো এন্ডপয়েন্ট কোনো অথেন্টিকেশন ছাড়াই সাধারণ GET রিকোয়েস্টের উত্তর দেয়। কী (key) শুধুমাত্র পেইড প্রোগ্রামmatic API-এর জন্য প্রয়োজন, যা কাস্টম কুয়েরি চালাতে ব্যবহৃত হয়।

ডেমো ডেটা কতটা সাম্প্রতিক?

ইকুইটি প্রাইস রিয়েল-টাইম নয়, বরং কিছুটা বিলম্বিত। রেশিও, শর্ট ইন্টারেস্ট এবং কর্পোরেট অ্যাকশন তাদের নিজস্ব উৎস অনুযায়ী আপডেট হয়। গ্রিকস (Greeks) এবং ইমপ্লাইড ভলাটিলিটি হলো দিনের শেষে (end-of-day) আপডেট করা ডেটা। প্রতিটি কুয়েরির ফলাফল প্রতি দশ মিনিটে একবারের বেশি রিফ্রেশ হয় না।

আমার LLM এজেন্ট বা ব্রাউজার অ্যাপ কি সরাসরি এটি কল করতে পারে?

হ্যাঁ। রেসপন্সগুলো যেকোনো অরিজিন থেকে ওপেন CORS সমর্থন করে, প্রিফ্লাইট সবখানেই সফল হয়, এবং /api/demo/catalog-এ থাকা ক্যাটালগটি প্রতিটি কুয়েরি JSON ফরম্যাটে বর্ণনা করে যা কোনো ডকুমেন্টেশন ছাড়াই একটি এজেন্ট পড়তে পারে।

আমি যদি এমন কোনো কী (key) রিকোয়েস্ট করি যা বিদ্যমান নেই তবে কী হবে?

API তখন ডিফল্ট spy_qqq কুয়েরি প্রদান করবে এবং আপনার অনুরোধ করা কী (key)-টির নাম দিয়ে একটি fallback_from ফিল্ড যোগ করবে। বৈধ কী (key)-এর তালিকা দেখতে ক্যাটালগটি দেখুন।

এই পেজের প্রতিটি প্যানেল একটি লাইভ স্টোরড কুয়েরি, এবং একই ডেটা ওয়্যারহাউস Strasmore terminal-এ SQL বা সাধারণ ইংরেজিতে আপনার লেখা কুয়েরির উত্তর দেয়।