APIs ouvertes pour le Market Maker

Spécification

Préfixe

1. Pour garantir la sécurité des transactions, utilisez HTTPS pour la transmission.
2. JSON est le format d'échange de données.
3. L'encodage des caractères UTF-8 est appliqué universellement.
4. L'algorithme de signature de l'interface utilise HMAC-SHA256.
5. Un horodatage en millisecondes UNIX est utilisé, représentant le nombre de millisecondes depuis le 1er janvier 1970, 0:00:00.

Paramètres

Demande

Réponse

Génération de la signature

Notre plateforme RFQ nécessite des signatures de partenaires pour approuver les demandes, suivies d'une procédure de vérification. Un échec de vérification entraînera un rejet de la plateforme avec une réponse 401 Non autorisé.

Construction de la chaîne de signature :

La chaîne de signature se compose de cinq lignes, chacune représentant un paramètre. Chaque ligne se termine par un point-virgule, y compris la dernière ligne. L'horodatage valide et le nonce de la demande sont pris respectivement des paramètres H-Timestamp et H-Nonce dans l'en-tête.

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

Remplissage de la signature

Utilisez la SecretKey pour chiffrer StringToSign en utilisant HMAC-SHA256.

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

Définition des en-têtes HTTP

La requête transmet la signature via l'en-tête HTTP Authorization. L'Authorization header se compose de deux parties : type d'authentification et informations de signature.

Authorization: AuthenticationType SignatureInformation

1. Type d'authentification : [mm_id]-hmac-sha256
2. Informations de signature : Signature

Authorization: [mm_id]-hmac-sha256 Signature

Remarque :

• La méthode de requête doit être en MAJUSCULES.
• Le RequestBody utilisé pour la signature doit correspondre au contenu du corps de la requête.
• Pour les requêtes GET et DELETE, le URI doit inclure les paramètres de la requête (par exemple, /api/v1/result?orderId=123).
  • S'il n'y a pas de corps de requête (courant pour les requêtes GET), le corps de la requête doit être une chaîne vide ("").
• Le timestamp valide (H-Timestamp) est déterminé par le demandeur ; les requêtes dépassant le timestamp valide seront rejetées par le serveur RFQ.

RFQ

Fournir un devis RFQ DNT

GET rfq/dnt/quote

Paramètres

Réponse

Note :

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

Exemples

URL de la demande

rfq/dnt/quote

Paramètres

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

Fournir une citation RFQ de tendance haussière/baissière

GET rfq/smart-trend/quote

Paramètres

Réponse

Note:

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

Fournir un devis RFQ double

GET rfq/dual/quote

Paramètres

Response

Annexe

Fonctions requises：

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