Offene APIs für Market Maker

Spezifikation

Präfix

1. Um die Transaktionssicherheit zu gewährleisten, verwenden Sie HTTPS für die Übertragung.
2. JSON ist das Datenformat für den Austausch.
3. UTF-8-Zeichencodierung wird universell angewendet.
4. Der Signaturalgorithmus der Schnittstelle verwendet HMAC-SHA256.
5. Der UNIX-Millisekundenzeitstempel wird verwendet und stellt die Anzahl der Millisekunden seit dem 1. Januar 1970, 0:00:00 dar.

Parameter

Anfrage

Antwort

Signaturerstellung

Unsere RFQ-Plattform erfordert Partner-Signaturen zur Genehmigung von Anfragen, gefolgt von einem Verifizierungsverfahren. Ein Verifizierungsfehler führt zu einer Ablehnung der Plattform mit einer 401 Unauthorized-Antwort.

Aufbau des Signaturstrings:

Der Signaturstring besteht aus fünf Zeilen, von denen jede einen Parameter darstellt. Jede Zeile endet mit einem Semikolon, einschließlich der letzten Zeile. Der gültige Zeitstempel und der Anfrage-Nonce werden aus den Parametern H-Timestamp und H-Nonce im Header entnommen.

Zeitstempel;NonceStr;HTTP_METHOD();URI();RequestBody;

Ausfüllen der Signatur

Verwenden Sie den SecretKey, um StringToSign mit HMAC-SHA256 zu verschlüsseln.

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

Einstellen der HTTP-Header

Die Anfrage überträgt die Signatur über den HTTP Authorization-Header. Der Authorization-Header besteht aus zwei Teilen: Authentifizierungstyp und Signaturinformationen.

Authorization: Authentifizierungstyp Signaturinformationen

1. Authentifizierungstyp: [mm_id]-hmac-sha256
2. Signaturinformationen: Signature

Authorization: [mm_id]-hmac-sha256 Signature

Hinweis:

• Die Anfragemethode sollte in GROSSBUCHSTABEN sein.
• Der RequestBody, der für die Signatur verwendet wird, muss mit dem Inhalt des Anfragekörpers übereinstimmen.
• Bei GET- und DELETE-Anfragen sollte die URI die Anfrageparameter enthalten (z. B. /api/v1/result?orderId=123).
  • Wenn es keinen Anfragekörper gibt (häufig bei GET-Anfragen), sollte der Anfragekörper ein leerer String ("") sein.
• Der gültige Zeitstempel (H-Zeitstempel) wird vom Anforderer bestimmt; Anfragen, die über den gültigen Zeitstempel hinausgehen, werden vom RFQ-Server abgelehnt.

RFQ

DNT RFQ-Angebot bereitstellen

GET rfq/dnt/quote

Parameter

Antwort

Hinweis:

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

Beispiele

Anforderungs-URL

rfq/dnt/quote

Parameter

{
    "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"
}

Bereitstellung des Bull/Bear Trend RFQ Angebots

GET rfq/smart-trend/quote

Parameter

Antwort

Hinweis:

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

Bereitstellen eines Dual RFQ Angebots

GET rfq/dual/quote

Parameter

Antwort

Anhang

Erforderliche Funktionen：

• $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$