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 ہیڈر میں بھیجیں۔ مفت: صرف 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 دن سے پرانی قطاریں ہر کلید کے روزانہ کوٹے میں شمار ہوتی ہیں (مفت: 1,000، Pro: 3,000 قطاریں فی UTC دن)؛ مکمل ایکسپورٹ Enterprise معاہدے کے تحت دستیاب ہیں۔ کلیدیں ذاتی ہوتی ہیں؛ خودکار بلک ڈاؤن لوڈ سے کلید منجمد کر دی جاتی ہے۔ دیکھیے شرائط۔
اسٹریٹ ریٹ سرکاری یا انٹربینک ریٹ نہیں ہوتے؛ جن سیریز کا confidence limited ہو ان میں اتار چڑھاؤ اور خلا ہو سکتے ہیں۔ یہ ڈیٹا سرمایہ کاری کا مشورہ نہیں ہے۔