マーケットメイカーのオープンAPI

仕様

プレフィックス

1. 取引の安全性を確保するため、通信にはHTTPSを使用してください。
2. データ交換フォーマットはJSONです。
3. UTF-8文字エンコーディングが普遍的に適用されます。
4. インターフェース署名アルゴリズムはHMAC-SHA256を利用します。
5. UNIXミリ秒タイムスタンプが使用され、1970年1月1日0:00:00からのミリ秒数を表します。

パラメータ

リクエスト

レスポンス

署名生成

当社のRFQプラットフォームでは、リクエストを承認するためにパートナー署名が必要で、その後に検証手続きが行われます。 検証に失敗すると、プラットフォームは401 Unauthorizedレスポンスで拒否します。

署名文字列の構築:

署名文字列は5行で構成され、それぞれがパラメータを表します。 各行はセミコロンで終わり、最後の行も含まれます。有効なタイムスタンプとリクエストノンスは、それぞれヘッダーの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

パラメータ

レスポンス

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

パラメータ

レスポンス

| collateralAtRisk | string | E18 | | deadline | long | 見積もりの締切タイムスタンプ | | makerWallet | string | | | signature | string | . |

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

デュアル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$