পরীক্ষার জন্য উন্মুক্ত ডেটা দিয়ে শুরু করুন
আপনার DB সংযুক্ত করেছেন কিন্তু রাখার মতো ডেটা নেই? নিচের তিনটির একটি দিয়ে শুরু করুন। সবগুলো বিনামূল্যে, API কী ছাড়াই পাওয়া যায়, আর লোডার স্ক্রিপ্ট থেকে স্ক্রিনে বাছাইয়ের মান (টেবিল·কলাম) পর্যন্ত হুবহু অনুসরণ করলেই হবে। স্ক্রিপ্টটি পার্সার যোগ করার কাঠামোয় তৈরি, তাই কাঙ্ক্ষিত উৎস থাকলে কেবল একটি এন্ট্রি যোগ করলেই হবে।
সংগ্রাহক নিন
ফেচার রিপোটি VPS-এ (যে সার্ভারে এজেন্ট আছে) ক্লোন করুন। নির্ভরতা কেবল pg একটি। ★ .env-এর DATABASE_URL লেখার অ্যাকাউন্ট দিয়ে দিন। কেবল-পঠন অ্যাকাউন্টে INSERT প্রত্যাখ্যাত হওয়াই স্বাভাবিক, আর সেই অ্যাকাউন্ট কেবল SoriTrading সংযোগের জন্য।
git clone https://github.com/Value-Connect-Global-Inc/soritrading-fetchers ~/soritrading-fetchers cd ~/soritrading-fetchers && npm install cp .env.example .env # DATABASE_URL
https://github.com/Value-Connect-Global-Inc/soritrading-fetchers · ওপেন সোর্স · একটি ফোল্ডার = একটি ফেচার · cron স্বয়ংক্রিয় নিবন্ধন
নিচের তিনটি **শুরুর উদাহরণ**। রিপোতে আরও আছে VIX·ক্রিপ্টো ইমপ্লায়েড ভোলাটিলিটি (DVOL)·দীর্ঘ-স্বল্প মেয়াদি সুদের ব্যবধান·ডলার সূচক·স্টেবলকয়েন মার্কেট ক্যাপ·DeFi TVL ইত্যাদি, সবই বিনামূল্যে·কী ছাড়া — পুরো তালিকা দেখতে `node run.mjs list` চালান। বাজারের ডেটায় মার্কিন ছুটির দিনে মান থাকে না (০ নয়, অনুপস্থিত), আর DVOL শুরু ২০২১ সালের মার্চ থেকে।
ডেটা সেটিংস স্ক্রিন কীভাবে পড়বেন
এজেন্ট ব্যবস্থাপনা → এজেন্ট নির্বাচন → ডেটা সেটিংস ট্যাব। নিবন্ধন·মুছে ফেলা এই স্ক্রিনে কেবল আপনি নিজে করেন — AI কেবল ডেটাসেট পড়ে, আর সংযোগ স্ট্রিং কখনোই চ্যাটে পেস্ট করা হয় না। স্ক্রিনটি উপর থেকে এই ক্রমে সাজানো।
- বাহ্যিক DB সংযোগ — সংযোগের নাম (যেমন main) ও সংযোগ স্ট্রিং দিন। এটি কেবল এজেন্ট ডিভাইসে এনক্রিপ্ট করে সংরক্ষিত হয় এবং সার্ভারে যায় না। স্ক্রিন খুললে এজেন্ট স্বয়ংক্রিয়ভাবে টেবিল তালিকা পড়ে আনে ([সংযোগ যাচাই] আবার পড়তে চাইলে)।
- টেবিল ও ডেটাসেট — DB-র প্রতিটি টেবিলের জন্য এক সারি। টেবিলের নাম · আনুমানিক সারির সংখ্যা · টেবিলের মন্তব্য, আর সেই টেবিল পড়া ডেটাসেটগুলো তার নিচে যুক্ত থাকে।
- AI প্রকাশের স্তর (টেবিল সারির ডান দিকে) — অপ্রকাশিত (ডিফল্ট — টেবিল আছে কি না AI তাও জানে না) · কেবল নাম · কলাম পর্যন্ত · নমুনা পর্যন্ত · কোয়েরি অনুমোদিত। বাছাইয়ের পরে [প্রকাশের সেটিংস সংরক্ষণ]। কলাম·নমুনা·কোয়েরি স্তরে আসল ডেটা AI-এর কাছে যায়, তাই ব্যক্তিগত তথ্যযুক্ত টেবিল খুলবেন না। কেবল public স্কিমার টেবিল খোলা যায়।
- ডেটাসেটের নাম (টেবিল সারির নিচে) — কৌশল যে মানকে ctx.data(নাম) দিয়ে ডাকে। [+ এই টেবিল দিয়ে ডেটাসেট যোগ করুন] → নাম·সময় কলাম·মান কলাম বাছলে বিবরণ টেবিলের মন্তব্য দিয়ে পূরণ হয়, আর [পরীক্ষা] পাস করলে তবেই [সংরক্ষণ] খোলে। এক টেবিলে একাধিক নাম দেওয়া যায় (ফিল্টার দিয়ে এক্সচেঞ্জ·সিম্বলভিত্তিক সিরিজ ভাগ করার সময়, বা পুরোনো কৌশল ভিন্ন নাম ব্যবহার করলে)। অবস্থা ব্যাজ: ব্যবহারযোগ্য · যাচাইয়ের আগে · সংযোগ নেই। ব্যাজের পাশের রিয়েল-টাইম ব্যাজে চাপলে জাগানোর সেটিং (poll·notify·redis) খোলে — বেশিরভাগ ক্ষেত্রে ডিফল্টই যথেষ্ট।
- গণনাকৃত ডেটাসেট (SQL) — মুভিং অ্যাভারেজ·বিলম্বিত মান·একাধিক টেবিলের সমন্বয়ের মতো গণনা দরকার এমন মান। SQL একাধিক টেবিল পড়তে পারে, তাই নির্দিষ্ট টেবিলের নিচে না রেখে আলাদাভাবে একত্র করা হয়। বেশিরভাগ গণনা কৌশলের কোডে দুটি ctx.data দিয়েও করা যায়, তাই SQL কেবল তখনই ব্যবহার করুন যখন অতীতের পুরো সময়কাল লাগে এমন গণনা (মুভিং অ্যাভারেজ·র্যাঙ্ক)। আগের পদ্ধতিতে নিবন্ধিত SQL এখানে [SQL যাচাই করেছি] · [মুছুন] করুন, অথবা সরল গঠনের হলে টেবিল নির্বাচন পদ্ধতিতে একসঙ্গে রূপান্তর করুন।
- যে ডেটাসেটের টেবিল পাওয়া যায়নি — ঘোষিত টেবিল এখন তালিকায় না থাকলে ডেটাসেট মুছে যায় না, কারণসহ এখানে থেকে যায় — টেবিল তালিকা এখনো পাওয়া যায়নি (মানে নেই এমন নয়) · সেই DB-তে টেবিলটি নেই (নাম পরিবর্তন·মুছে ফেলা) · এই ডিভাইসে সেই সংযোগের নাম নেই।
- পরিসর দুটি — AI প্রকাশের স্তর কেবল এখন খোলা সেই ডিভাইসেই সংরক্ষিত হয়। ডেটাসেট একই সংযোগ নামের সব ডিভাইসে প্রযোজ্য। একাধিক ডিভাইস থাকলে প্রকাশের স্তর প্রতিটি ডিভাইসে আলাদাভাবে বাছুন।
1. ভয় ও লোভ সূচক
alternative.me০ (চরম ভয়) থেকে ১০০ (চরম লোভ), দিনে একবার। ২০১৮-০২ থেকে পুরো সময়কাল। শুধু দাম দিয়ে যে মনস্তাত্ত্বিক অক্ষ দেখা যায় না — তাই প্রথম পরীক্ষার জন্য সবচেয়ে ভালো।
node run.mjs fear-greed
সংযোগ: main · টেবিল: fear_greed নাম: fg · সময় কলাম: ts · মান কলাম: v
2. বিটকয়েন হ্যাশরেট
blockchain.comচেইনের নিজস্ব সূচক (TH/s)। দামের থেকে ভিন্ন অক্ষ, তাই পরিস্থিতি ফিল্টার হিসেবে কাজের। মান বড় এবং প্রবণতা ধীর, তাই মূল মানের চেয়ে মুভিং অ্যাভারেজের তুলনায় অনুপাত ব্যবহার করা ভালো।
node run.mjs btc-hashrate
সংযোগ: main · টেবিল: btc_hashrate নাম: hashrate · সময় কলাম: ts · মান কলাম: v
3. মার্কিন ফেডারেল ফান্ড রেট (অনুশীলন)
FRED (DFF)দৈনিক কার্যকর ফেডারেল ফান্ড রেট। ম্যাক্রো পরিস্থিতি ফিল্টারের প্রতিনিধি মান। ★ সতর্কতা: একই মান ইতিমধ্যে মৌলিক সূচক base_fedfunds হিসেবে আসে (ctx.data('base_fedfunds') — এজেন্ট FRED থেকে সংগ্রহ করে)। একই মান দুই পথে দিলে ফলাফলে কোনটি ব্যবহৃত হয়েছে তা আলাদা করা যায় না, তাই এটি কেবল সংযোগ অনুশীলনের জন্য ব্যবহার করুন।
node run.mjs fed-funds
সংযোগ: main · টেবিল: macro_fed_funds নাম: dff · সময় কলাম: ts · মান কলাম: v
নিয়মিত সংগ্রহ (cron)
প্রতিটি ফেচারের ঘোষিত সময়সূচি অনুযায়ী crontab-এ নিবন্ধন করে। আবার চালালেও লাইন জমে না, এবং আপনার নিজে বসানো cron-এ হাত দেয় না। লগ logs ফোল্ডারে ফেচারভিত্তিক লগ ফাইলে থাকে।
node run.mjs --install-cron
- সময় কলামে সেকেন্ড-এককের epoch সুপারিশ করা হয় (মিলিসেকেন্ড ও ISO-ও স্বয়ংক্রিয়ভাবে চেনা যায়, আর কোনভাবে পড়া হয়েছে তা যাচাই রিপোর্টের tsUnit-এ থাকে)।
- স্ক্রিপ্ট আবার চালানো নিরাপদ — ডুপ্লিকেট ছাড়াই কেবল নতুন মান হালনাগাদ হয় (upsert)। নতুন ডেটার জন্য নিয়মিত আবার চালালেই হবে।
- ব্যাকটেস্টের ফলাফলে ডেটার ফিঙ্গারপ্রিন্ট (সারির সংখ্যা·হ্যাশ) থাকে — DB-র বিষয়বস্তু বদলালে ফিঙ্গারপ্রিন্ট বদলায়, আর ভিন্ন ফিঙ্গারপ্রিন্টের দুটি ফলাফল একই শর্তে চালানো নয়।
- বাহ্যিক ডেটা ব্যবহারকারী ব্যাকটেস্টও এজেন্টে চলে — সব ব্যাকটেস্ট কেবল এজেন্টে (আমার স্টোরে) চলে।
- যে টেবিলকে প্রকাশের স্তর দেওয়া হয়েছে তা AI-এর কাছে দৃশ্যমান হয় (কলাম·নমুনা·কোয়েরি স্তরে আসল ডেটা যায়) — ব্যক্তিগত তথ্যযুক্ত টেবিল প্রকাশ করবেন না।
পূর্ণ ডকুমেন্টেশন এখানে — ব্যবহার নির্দেশিকা