EMpulse Street FX Index API
উদীয়মান বাজারের মুদ্রাগুলোর দৈনিক খোলাবাজারের বিনিময় হার, প্রতি 1 USDT-এর বিপরীতে ফিয়াট মুদ্রায় উদ্ধৃত (USDT-কে 1 USD ধরা হয়): মানুষ প্রকৃতপক্ষে যে হারে পরিশোধ করে সেটি, সরকারি হার নয়। প্রতিটি সিরিজে একটি কনফিডেন্স শ্রেণি থাকে। পূর্ণ পদ্ধতি পদ্ধতিবিবরণীতে রয়েছে।
ইনডেক্স সারির ক্ষেত্রসমূহ
| ক্ষেত্র | অর্থ | কখন null হয় | প্ল্যান |
|---|---|---|---|
buy | দিনের ভারিত গড় হার, যে হারে ক্লায়েন্ট ফিয়াটের বিনিময়ে USDT কেনেন। | ওই দিনের জন্য ক্রয়পক্ষে ডেটা পয়েন্ট খুব কম। | সব প্ল্যান |
sell | একই হিসাব সেই পক্ষের জন্য, যেখানে ক্লায়েন্ট USDT বিক্রি করেন। | ওই দিনের জন্য বিক্রয়পক্ষে ডেটা পয়েন্ট খুব কম। | সব প্ল্যান |
mid | (buy + sell) / 2, যখন দুই পক্ষই থাকে; যখন একটি পক্ষই থাকে, তখন সেই পক্ষের হার। | কোনো পক্ষেই পর্যাপ্ত ডেটা পয়েন্ট নেই। | সব প্ল্যান |
side | মিড কোন পক্ষ থেকে তৈরি: both, buy বা sell। একপক্ষীয় মিড দ্বিপক্ষীয় মিডের তুলনায় প্রায় অর্ধেক স্প্রেড সরে থাকে। | কোনো মিড নেই। | সব প্ল্যান |
spread_pct | (buy − sell) / mid × 100। | পক্ষটি both নয়। | সব প্ল্যান |
confidence | high, medium বা limited: কভারেজের ভিত্তিতে মুদ্রার শ্রেণি; যে দিনে ডেটা পয়েন্ট স্বাভাবিকের চেয়ে কম, সেদিন এক শ্রেণি নিচে। limited মানে উৎস বা ডেটা পয়েন্ট কম: নয়েজ বেশি, ফাঁক থাকার সম্ভাবনা। | কখনও নয়। | সব প্ল্যান |
flag | outlier সেই দিনের জন্য, যেদিন ডেটা পয়েন্ট কম এবং যার মিড আশপাশের ±15 দিনের মিডিয়ান মিড থেকে 10%-এর বেশি সরে যায়। এমন দিন নিজের মান ধরে রাখে, তবে mid_7d ও chg_* ক্ষেত্র থেকে বাদ যায়। | দিনটি আউটলাইয়ার নয়। | সব প্ল্যান |
in_progress | true মুদ্রার সর্বশেষ দিনের জন্য, যতক্ষণ দিনটির ডেটা সংগ্রহ চলছে এবং তার ডেটা পয়েন্ট আগের 7 দিনের স্বাভাবিক মাত্রার চেয়ে স্পষ্টতই কম। | কখনও নয়। | সব প্ল্যান |
mid_7d | গত 7 ক্যালেন্ডার দিনে (সীমাসহ) বৈধ মিডগুলোর গড়। | উইন্ডোতে কোনো বৈধ মিড নেই। | সব প্ল্যান |
chg_1d_pct | ঠিক 1 ক্যালেন্ডার দিন আগের তুলনায় মিডের পরিবর্তন, শতাংশে। | দুই দিনের যেকোনোটিতে বৈধ মিড নেই। | সব প্ল্যান |
chg_7d_pct | ঠিক 7 ক্যালেন্ডার দিন আগের তুলনায় মিডের পরিবর্তন, শতাংশে। | দুই দিনের যেকোনোটিতে বৈধ মিড নেই। | সব প্ল্যান |
chg_30d_pct | ঠিক 30 ক্যালেন্ডার দিন আগের তুলনায় মিডের পরিবর্তন, শতাংশে। | দুই দিনের যেকোনোটিতে বৈধ মিড নেই। | সব প্ল্যান |
exchange_spread_pct | ওই দিন যেসব এক্সচেঞ্জ মুদ্রাটির দর দেয়, তাদের মধ্যে ব্যবধান কতটা: (সর্বোচ্চ − সর্বনিম্ন এক্সচেঞ্জ মিড) / মিডিয়ান × 100। ব্যবধান বাড়তে থাকা FX Stress Signals-এর একটি ইনপুট। | দুটির কম এক্সচেঞ্জ মুদ্রাটির দর দেয়, অথবা কীটি ফ্রি কী। | Pro, Enterprise |
তারিখ হলো UTC ক্যালেন্ডার দিন। সর্বশেষ দিনটি শেষ না হওয়া পর্যন্ত অসম্পূর্ণ থাকে এবং সংশোধিত হতে পারে; নতুন ডেটা এলে শেষ 15 দিনের ফ্ল্যাগ বদলাতে পারে।
ঘণ্টাভিত্তিক হার (Pro ও Enterprise)। GET /v1/rates/CUR/hourly?from=&to= প্রতি UTC ঘণ্টার ইনডেক্স দেয় (প্রতি অনুরোধে সর্বোচ্চ 31 দিন), /v1/rates/CUR/hourly/latest একটি সিরিজের সর্বশেষ 24 ঘণ্টা, /v1/rates/hourly/latest প্রতিটি মুদ্রার সর্বশেষ সম্পূর্ণ ঘণ্টা। ঘণ্টার সারিতে একই buy, sell, mid, side, spread_pct, confidence ও in_progress থাকে; প্রতি মুদ্রার রেসপন্সে প্রতিটি দিনের জন্য একটি summary যোগ হয়। ফ্রি কী পায় 403 tier_not_in_plan।
বহু-উৎসভিত্তিক স্ট্রিট ইনডেক্স। /v1/street-index/*: আস্থার স্কোরসহ, বহু স্বতন্ত্র পাবলিক বাজার-উৎস থেকে সংকলিত খোলাবাজারের হার, উৎসগুলো যে প্রতিটি মুদ্রা কভার করে তার জন্য (একই কী)।
আপনার কী X-API-Key হেডারে পাঠান। Free: শুধু RUB, UAH, EGP, দিনে 100টি অনুরোধ, সর্বশেষ সম্পূর্ণ দিন পর্যন্ত। Pro: সব মুদ্রা, দিনে 10,000টি অনুরোধ, চলমান (অসম্পূর্ণ) বর্তমান দিনসহ। Enterprise: চুক্তি অনুযায়ী। সীমা 00:00 UTC-তে নতুন করে শুরু হয়।
ডিফল্ট ফরম্যাট JSON; CSV পেতে Accept: text/csv পাঠান অথবা ?format=csv যোগ করুন। ত্রুটি JSON আকারে আসে, যাতে একটি error অবজেক্টে code ও message থাকে। স্ট্যাটাস হতে পারে 400 (ভুল প্যারামিটার), 401 (কী নেই বা অবৈধ), 403 (সময়কাল, মুদ্রা বা পণ্য প্ল্যানের অন্তর্ভুক্ত নয়: tier_delay, currency_not_in_plan, tier_not_in_plan, key_frozen), 404 (অজানা মুদ্রা বা রুট), 429 (rate_limit_exceeded, history_quota_exceeded) অথবা 503।
90 দিনের চেয়ে পুরোনো সারি প্রতিটি কী-র দৈনিক কোটার আওতায় গণনা হয় (Free 1,000, Pro 3,000 সারি প্রতি UTC দিনে); সম্পূর্ণ এক্সপোর্ট Enterprise চুক্তির আওতায় পাওয়া যায়। কী ব্যক্তিগত; স্বয়ংক্রিয় বাল্ক ডাউনলোড করলে কী ফ্রিজ করা হয়। দেখুন শর্তাবলি।
স্ট্রিট রেট সরকারি বা ইন্টারব্যাংক রেট নয়; confidence limited থাকা সিরিজে অস্থিরতা ও ফাঁক থাকতে পারে। এই ডেটা বিনিয়োগ পরামর্শ নয়।