마켓 메이커를 위한 오픈 API

사양

접두사

1. 거래 보안을 보장하기 위해 전송에 HTTPS를 사용합니다.
2. JSON은 데이터 교환 형식입니다.
3. UTF-8 문자 인코딩이 보편적으로 적용됩니다.
4. 인터페이스 서명 알고리즘은 HMAC-SHA256을 사용합니다.
5. UNIX 밀리초 타임스탬프가 사용되며, 1970년 1월 1일 0:00:00 이후의 밀리초 수를 나타냅니다.

매개변수

요청

응답

서명 생성

우리의 RFQ 플랫폼은 요청을 승인하기 위해 파트너 서명이 필요하며, 그 뒤에 검증 절차가 이어집니다. 검증 실패 시 플랫폼은 401 Unauthorized 응답으로 거부됩니다.

서명 문자열 구성:

서명 문자열은 다섯 개의 줄로 구성되며, 각 줄은 하나의 매개변수를 나타냅니다. 각 줄은 세미콜론으로 끝나며, 마지막 줄도 포함됩니다. 유효한 타임스탬프와 요청 논스는 각각 헤더의 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

매개변수

응답

| collateralAtRisk | string | E18 | | makerBalanceThreshold | string | | | deadline | long | 견적 마감 타임스탬프 | | makerWallet | string | | | signature | string | . |

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

매개변수

응답

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$