市場做市商開放 API

規範

前綴

1. 為確保交易安全，使用 HTTPS 傳輸。
2. JSON 是數據交換格式。
3. 普遍使用 UTF-8 字符編碼。
4. 接口簽名算法使用 HMAC-SHA256。
5. 使用 UNIX 毫秒時間戳，表示自 1970 年 1 月 1 日 0:00:00 起的毫秒數。

參數

請求

響應

簽名生成

我們的 RFQ 平台要求合作夥伴簽名以批准請求，隨後進行驗證程序。驗證失敗將導致平台拒絕，並返回 401 未授權響應。

構建簽名字符串：

簽名字符串由五行組成，每行代表一個參數。每行以分號結束，包括最後一行。有效時間戳和請求隨機數分別取自標頭中的 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

提供 DNT RFQ 報價

GET rfq/dnt/quote

參數

響應

注意：

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

參數

響應

附錄

所需功能：

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