للمطوّرين

واجهة 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.