市场做市商的开放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 通过 HMAC-SHA256 加密 StringToSign。

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

参数

响应

| collateralAtRisk | string | E18 | | deadline | long | 报价截止时间戳 | | makerWallet | string | | | signature | string | . |

注意：

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

附录

必需的功能：

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