واجهة API العامة لبيانات السوق
الأسعار والشموع ودفتر الأوامر وقائمة الأزواج. بدون تسجيل، بدون مفتاح، ومجانًا.
بداية سريعة
عنوان URL الأساسي: https://yubbit.com/api/v1
المصادقة: غير مطلوبة
curl https://yubbit.com/api/v1/ticker?symbol=BTC_USDTبيانات السوق
تنسيق Yubbit الخاص: الأسعار المباشرة والشموع ودفتر الأوامر لزوج واحد أو لجميع الأزواج.
GET /api/v1/ping
فحص سلامة الخدمة.
GET /api/v1/time
ساعة الخادم، للتوقيع أو التحقق من فرق التوقيت.
GET /api/v1/markets
السعر المباشر وإحصاءات 24 ساعة لكل زوج.
GET /api/v1/ticker?symbol=
السعر المباشر لزوج واحد. بدون تحديد الرمز، يعرض هذا المسار جميع أزواج التداول الفوري بتنسيق CoinMarketCap (راجع قسم التداول الفوري).
GET /api/v1/klines
شموع OHLCV، من الأقدم إلى الأحدث. open_time هو وقت افتتاح الشمعة بوحدة ثواني Unix، وليس بالمللي ثانية.
GET /api/v1/orderbook?symbol=
لقطة من دفتر الأوامر. تُرتب عروض الشراء من أفضل سعر (الأعلى) إلى الأدنى، وعروض البيع من أفضل سعر (الأدنى) إلى الأعلى؛ كل مستوى هو [السعر، الكمية]. best_ask / best_bid هما السعران اللذان تُنفذ عندهما أوامر الشراء / البيع بسعر السوق.
التداول الفوري: تنسيق CoinMarketCap
مسارات السوق الفوري المتوافقة مع مواصفات إدراج منصات CoinMarketCap: الملخص والأصول والسعر ودفتر الأوامر والصفقات.
GET /api/v1/summary
نظرة عامة على مدار 24 ساعة لجميع أزواج التداول الفوري (ملخص CoinMarketCap). lowest_ask وhighest_bid هما أفضل سعرين في دفتر الأوامر، وهما السعران اللذان تُنفّذ عندهما أوامر الشراء أو البيع بسعر السوق.
GET /api/v1/assets
جميع العملات المتداولة في السوق الفوري، مرتبة حسب الرمز (CoinMarketCap A1). لا تظهر الحقول الاختيارية إلا إذا توفرت لدى Yubbit: name وcan_withdraw (تكون false أثناء الصيانة) وmin_withdraw (لـ USDT فقط) وmaker_fee وtaker_fee وcontractAddress.
GET /api/v1/ticker
آخر سعر وحجم التداول خلال 24 ساعة لجميع أزواج التداول الفوري، مرتبة حسب BASE_QUOTE (CoinMarketCap A2). تكون isFrozen بقيمة 1 عند إيقاف التداول للصيانة، وإلا فقيمتها 0.
GET /api/v1/orderbook/{market_pair}
دفتر أوامر المستوى 2 لزوج واحد (CoinMarketCap A3). يتكون كل مستوى من [السعر، الكمية].
GET /api/v1/trades/{market_pair}
صفقات التداول الفوري الأخيرة لزوج واحد خلال آخر 24 ساعة.
المشتقات: تنسيق CoinMarketCap
العقود الدائمة بتنسيق المشتقات لدى CoinMarketCap: العقود ومواصفاتها ودفتر الأوامر.
GET /api/v1/contracts
جميع العقود الدائمة مع السعر وحجم التداول خلال 24 ساعة وأفضل سعري عرض وطلب والفائدة المفتوحة والرسوم ومواصفات العقد (CoinMarketCap B1، مع تضمين حقول B2).
GET /api/v1/contract_specs
مواصفات العقد لكل ticker_id (CoinMarketCap B2). العقود خطية (Vanilla): كل عقد يساوي وحدة واحدة من العملة الأساسية، ويُسعّر ويُسوّى بالعملة المقابلة.
GET /api/v1/orderbook/{ticker_id}
دفتر أوامر لعقد دائم واحد (CoinMarketCap B3). يقبل معاملات العمق والمستوى نفسها التي يقبلها دفتر أوامر السوق الفوري.
ما يجب أن تعرفه
- قد يخفّض Yubbit.com سرعة نقل البيانات عند الضرورة.
- واجهة API هذه للقراءة فقط. لا تعرض بيانات الحساب أو الرصيد أو الأوامر، ولا يمكنها تنفيذ الصفقات.
- يُطبَّق حدّ الطلبات لكل عنوان IP. يؤدي تجاوزه إلى إرجاع الرمز 429 مع ترويسة Retry-After.
- تظل نقاط النهاية متوافقة مع الإصدارات السابقة؛ وسيُطرح أي تغيير غير متوافق بإصدار جديد مثل /api/v2.
