واجهات برمجة التطبيقات المفتوحة لصانع السوق

المواصفات

البادئة

1. لضمان أمان المعاملات، استخدم HTTPS للإرسال.
2. JSON هو تنسيق تبادل البيانات.
3. يتم تطبيق ترميز الأحرف UTF-8 بشكل عالمي.
4. تستخدم خوارزمية توقيع الواجهة HMAC-SHA256.
5. يتم استخدام طابع زمني بالميلي ثانية من UNIX، يمثل عدد الميلي ثانية منذ 1 يناير 1970، 0:00:00.

المعلمات

الطلب

الاستجابة

توليد التوقيع

تتطلب منصتنا RFQ توقيعات الشركاء للموافقة على الطلبات، تليها إجراء تحقق. ستؤدي فشل التحقق إلى رفض المنصة مع استجابة 401 غير مصرح بها.

بناء سلسلة التوقيع:

تتكون سلسلة التوقيع من خمسة أسطر، يمثل كل سطر معلمة. ينتهي كل سطر بفاصلة منقوطة، بما في ذلك السطر الأخير. يتم أخذ الطابع الزمني الصالح وnonce الطلب من معلمات H-Timestamp و H-Nonce في الرأس، على التوالي.

Timestamp;NonceStr;HTTP_METHOD();URI();RequestBody;

ملء التوقيع

استخدم SecretKey لتشفير StringToSign باستخدام HMAC-SHA256.

StringToSign = Timestamp + ";" + NonceStr + ";" + UPPERCASE(HTTP_METHOD()) + ";" + URI() + ";" + RequestBody + ";";
Signature = BASE64_STRING( HMAC-SHA256( BASE64_DECODE(SecretKey), StringToSign ) );

إعداد رؤوس HTTP

ترسل الطلب التوقيع من خلال رأس HTTP Authorization. يتكون Authorization header من جزئين: نوع المصادقة و معلومات التوقيع.

Authorization: AuthenticationType SignatureInformation

1. نوع المصادقة: [mm_id]-hmac-sha256
2. معلومات التوقيع: Signature

Authorization: [mm_id]-hmac-sha256 Signature

ملاحظة:

• يجب أن تكون طريقة الطلب بأحرف كبيرة.
• يجب أن يتطابق RequestBody المستخدم للتوقيع مع محتوى جسم الطلب.
• بالنسبة لطلبات GET و DELETE، يجب أن يتضمن URI معلمات الطلب (على سبيل المثال، /api/v1/result?orderId=123).
  • إذا لم يكن هناك جسم طلب (شائع لطلبات GET)، يجب أن يكون جسم الطلب سلسلة فارغة ("").
• يتم تحديد الطابع الزمني الصالح (H-Timestamp) من قبل الطالب؛ الطلبات التي تتجاوز الطابع الزمني الصالح سيتم رفضها من قبل خادم RFQ.

RFQ

تقديم عرض RFQ DNT

GET rfq/dnt/quote

المعلمات

الاستجابة

Note:

1. $collateralAtRisk - makerCollateral == premiumAmount$
2. $totalCollateral - makerCollateral == depositAmount$

أمثلة

طلب URL

rfq/dnt/quote

المعلمات

{
    "rfqId":1233992,
    "apy":0.25,
    "tenor":7.9,
    "fundingAmount":0.01,
    "depositAmount":1,
    "premiumCoin":"BTC",
    "premiumAmount":0.05,
    "bookingQuantity":1,
    "totalAmount":0.05,
    "payoff":1,
    "deadline":1672279892000,
    "signature":"dsdkksdsksdk"
}

تقديم اقتباس RFQ لاتجاه الثور/الدب

GET rfq/smart-trend/quote

المعلمات

الاستجابة

ملاحظة:

• $PremiumAmount = BookingQuantity * UnitQuotePrice$
• $MaxPayoutAmount = BookingQuantity * (upperStrike - lowerStrike)$
• $MinAPYAmount == projectedFundingAmount - premiumAmount$
• $MaxAPYAmount == MinAPYAmount + MaxPayoutAmount$
• $makerCollateral = MaxPayoutAmount - premiumAmount$
• $collateralAtRisk = MaxPayoutAmount$
• $totalCollateral = depositAmount + makerCollateral$
• $anchorPrices = [lowerStrike, upperStrike]$

تقديم اقتباس RFQ مزدوج

GET rfq/dual/quote

المعلمات

Response

Appendix

Required Functions：

• $premiumAmount = collateralAtRisk - makerCollateral$
• $depositAmount = totalCollater - makerCollateral$
• $bookingQuantity = collateralAtRisk$
• $projectedFundingAmount = projectedFundingAPY * (expDateTime - refDateTime) / 365$
• $Tenor = (expDateTime - refDateTime) / 365$
• $APYInRange = (projectedFundingAmount - premiumAmount + bookingQuantity) / tenor = makerCollateral / tenor$
• $APY-Protected = (projectedFundingAmount - premiumAmount) / tenor$