Live-Rates.com عبارة عن خدمة ويب JSON / XML وواجهة برمجة تطبيقات Rest في الوقت الفعلي للعملات الأجنبية والسلع والمؤشرات. تتوفر أيضًا واجهة برمجة التطبيقات للبث المباشر للمشتركين، بدءًا من عام 2019.
يتم تحديث الأسعار كل ثانية .
احصل على أحدث الأسعار المرجعية لصرف العملات الأجنبية بتنسيق JSON.
GET /rates
Host: live-rates.comاحصل على أحدث الأسعار المرجعية لصرف العملات الأجنبية بتنسيق XML.
GET /rates?rate_format=xml
Host: live-rates.com (يتطلب المصادقة)
احصل على أزواج العملات والسلع والمؤشرات المتوفرة وأيضًا متى تم تحديثها آخر مرة
GET /api/rates?key=YOUR_KEY
Host: live-rates.comاحصل على أحدث الأسعار المرجعية لصرف العملات الأجنبية للمعلمات المطلوبة، بتنسيق JSON.
GET /api/price?rate=EUR_USD,EUR_GBP&key=YOUR_KEY
Host: live-rates.com (يتطلب المصادقة)
مع واجهة برمجة التطبيقات المتدفقة، لم يعد من الضروري طلب بيانات جديدة كل ثانية. عندما يتم استرداد البيانات المحدثة بواسطة الخادم الرئيسي، يتم دفعها تلقائيًا إلى العميل عبر تقنية Web-socket (socket.io).
يوصلك خادم DNS المركزي (wss.live-rates.com) بمركز البيانات المفضل بناءً على موقعك ومدى توفر الخادم. الخوادم المحلية المتاحة هي:
| موقع | عنوان المقبس | (*) عنوان المقبس V3 |
|---|---|---|
| خادم جهاز التوجيه | wss.live-rates.com | wss3.live-rates.com |
| أوروبا | eu-wss.live-rates.com | eu-wss3.live-rates.com |
| نحن | us-wss.live-rates.com | us-wss3.live-rates.com |
| آسيا | as-wss.live-rates.com | as-wss3.live-rates.com |
(*) مطلوب لإصدار العميل الجديد من المقبس (3.xx)
تحقق من أمثلة Web-socket API لفهم كيفية دمجها واستخدامها:
جميع واجهات برمجة التطبيقات - خدمة الويب / واجهة برمجة تطبيقات الراحة / واجهة برمجة التطبيقات المتدفقة - إخراج البيانات بنفس البنية. يتم إرسال جميع الحقول بتنسيق سلسلة:
{
Currency: "EUR/USD" //Description of the Instrument
Rate: "1.13625" //Same as BID (Deprecated)
Bid: "1.13625" //Bid Value of the Currency / Instrument
Ask: "1.13638" //Ask Value of the Currency / Instrument
High: "1.14081" //24H High of the Currency / Instrument
Low: "1.13527" //24H Low of the Currency / Instrument
Open: "1.13725" //Opening Value of the Daily Session / Previous Day if Market is Active
Close: "1.13625" //Closing Value of the Daily Session / Previous Day if Market is Active
Timestamp: "1551477238763" //Timestamp of the Last Update
}
...(يتطلب المصادقة)
توفر الأسعار الحية بيانات تاريخية لعدد محدود من الأدوات (+-170). في الوقت الحالي، لا تتوفر سوى عملات الفوركس والمعادن والعملات المشفرة. تتطلب جميع نقاط النهاية المصادقة.
سيؤدي هذا إلى إخراج جميع الأدوات المتاحة
GET /historical/list?key=YOUR_KEY
Host: live-rates.com ستوفر نقطة النهاية هذه سعر الإغلاق لليوم المطلوب (23:59:59 بتوقيت UTC).
يمكنك توفير رموز المعلمات الاختيارية إذا كنت تحتاج فقط إلى أزواج محددة.
GET /historical?base=EUR&date=YYYY-MM-DD&symbols=USD&key=YOUR_KEY
Host: live-rates.com ستوفر نقطة النهاية هذه الأسعار لفترة زمنية سابقة معينة لا يمكن أن تزيد عن 30 يومًا .
يمكنك توفير رموز المعلمات الاختيارية إذا كنت تحتاج فقط إلى أزواج محددة.
GET /historical/series?base=EUR&start=YYYY-MM-DD&end=YYYY-MM-DD&symbols=USD&key=YOUR_KEY
Host: live-rates.comلأسباب واضحة، لا توفر الأسعار المباشرة جميع الآلاف من مجموعات الأسعار المتقاطعة المحتملة بشكل مباشر. جميع الأسعار المتاحة لدينا تأتي مباشرة من مقدمي الخدمات الذين لديهم سيولة حقيقية. إذا كنت بحاجة إلى الحصول على/حساب سعر غير متاح مباشرة، فيمكنك تحويله وتغيير العملة الأساسية.
على سبيل المثال: لا يتم توفير MYR/CNY أو MYR/GBP أو أي أسعار متقاطعة أخرى مع العملة الأساسية MYR. لكن هذا لا يعني أنه لا يمكنك الحصول عليها. في هذه الحالة/المثال، يمكنك استخدام USD/MYR مباشرة، ثم USD/XXX الذي تريده.
{
"currency" : "USD/MYR" , "rate" : "4.14611" ,
"currency" : "USD/CNY" , "rate" : "6.8421"
}
// 6.84/4.15 = 1.65 MYR/CNYلدى Live-Rates حاليًا خوادم متعددة في 3 مراكز بيانات:
تتم إعادة توجيه الطلبات المقدمة إلى موقع Live-rates.com وحلها بواسطة خادم DNS المركزي الخاص بنا في أوروبا.
إذا تجاوزت خادم DNS واتصلت مباشرةً بمركز بيانات محدد، فسيكون الاتصال أسرع، ولكن في حالة وجود مشكلة بالخادم، ستتلقى 502 أو 521 بدلاً من استجابة النجاح من الخادم البديل.
نحن نسمح بما يصل إلى 3 زيارات/ساعة/عنوان IP للطلبات غير المصادق عليها، إذا كنت بحاجة إلى تقديم طلبات واجهة برمجة التطبيقات (API) أو الحصول على تحديث الأسعار المباشرة كل ثانية، فستحتاج إلى الاشتراك في ترخيص وتضمين المعلمة التالية في طلباتك:
GET /rates?key=Your key
Host: live-rates.com نحن نقيد الوصول إلى المسيئين. إذا كان الترخيص الخاص بك يصل إلى أكثر من مرة واحدة في الثانية بمعدل 10 دقائق، فسيتم قفله مؤقتًا لمدة 10 دقائق. سوف تتلقى 503 Service Unavailable خلال تلك الفترة.
