DApp Open APIs

우리의 기존 dApp인 sofa.org는 중요한 워크플로우 기능이며 사용자가 SOFA 프로토콜과 상호작용하는 주요 방법입니다. 그러나 우리는 다른 개발자들이 자신의 dApp을 통해 SOFA에 접근하고 연결하여 우리의 생태계 성장을 극대화할 것을 권장합니다. 우리는 이들을 '브로커' 파트너로 간주하며, 관심 있는 당사자들은 추가 API 정보에 대해 SOFA 팀에 연락할 것을 권장합니다.

DNT

추천 DNT RFQ 목록 조회

GET /rfq/dnt/recommended-list

입력 매개변수

응답 매개변수

객체

요청 예시

GET rfq/dnt/recommended-list?vault=xxxxxx&chainId=1

응답

{
    "code":0,
    "message":"",
    "value":[
        {
            "rfqId":1233992,
            "riskType":"PROTECTED",
            "forCcy":"BTC",
            "expiry":1672387200,
            "lowerBarrier":18000,
            "upperBarrier":24000,
            "depositCcy":"BTC",
            "depositAmount": 0.05,
            "protectedApy":0.01,
            "deadline":1672279892,
            "recommended":true,
            "quote":
                {
                    "rfqId":1233992,
                    "inRangeApy":0.25,
                    "tenor":7.9,
                    "fundingAmount":0.25,
                    "depositAmount":1,
                    "premiumCoin":"BTC",
                    "premiumAmount":0.05,
                    "bookingQuantity":0.3,
                    "totalAmount":0.05,
                    "payoff":0.3,
                    "deadline":1672279892,
                    "signature":"dsdkksdsksdk"
                }

        }
    ]
}

DNT 문의

• 참고:
  • 순수 문의 요청 시 사용자의 지갑 주소를 전달하지 마십시오.
  • 사용자의 지갑 주소는 구독 시에만 전달되어야 합니다.

GET /rfq/dnt/quote

입력 매개변수

응답 매개변수

객체

DNT 승리 확률

만료까지 경계 내에 머무를 확률

GET rfq/dnt/winning-probabilities

입력 매개변수

응답 매개변수

Object

요청 예시

GET rfq/dnt/winning-probabilities?forCcy=BTC&expiry=xxxx&lowerBarrier=xxx&upperBarrier=xxx

응답

{
    "code":0,
    "message":"",
    "value": {
        "spotPrice": 62121,
        "timestamp": 1727080594,
        "probabilities": {
            "probDntStayInRange": 0.4,
            "probBullTrendItmLowerStrike": null,
            "probBullTrendItmUpperStrike": null,
            "probBearTrendItmLowerStrike": null,
            "probBearTrendItmUpperStrike": null
        }
    }
}

스마트 트렌드

추천 스마트 트렌드 RFQ 목록 조회

GET rfq/smart-trend/recommended-list

입력 매개변수

응답 매개변수

객체

요청 예시

GET rfq/smart-trend/recommended-list?vault=xxxxxx

스마트 트렌드 조회

• 주의 사항:
  • 순수 조회 요청 시 사용자의 지갑 주소를 전달하지 마십시오.
  • 사용자의 지갑 주소는 구독 시에만 전달해야 합니다.

GET /rfq/smart-trend/quote

입력 매개변수

응답 매개변수

객체

스마트 트렌드 승리 확률

만료 시까지 경계 내에 머물 확률

GET rfq/smart-trend/winning-probabilities

입력 매개변수

응답 매개변수

객체

요청 예시

GET rfq/smart-trend/winning-probabilities?forCcy=BTC&expiry=xxxx&lowerStrike=xxx&upperStrike=xxx

응답

{
    "code":0,
    "message":"",
    "value": {
        "spotPrice": 62121,
        "timestamp": 1727080594,
        "probabilities": {
            "probDntStayInRange": null,
            "probBullTrendItmLowerStrike": 0.4,
            "probBullTrendItmUpperStrike": 0.4,
            "probBearTrendItmLowerStrike": 0.6,
            "probBearTrendItmUpperStrike": 0.6,
        }
    }
}

일반 인터페이스

RFQ 삭제

온체인에 있는 RFQ를 삭제합니다.

POST rfq/remove

입력 매개변수

요청 예시

{  
"rfqId":123456  
}

응답 매개변수

거래 알림

POST rfq/trade

입력 매개변수

요청 예시

{
    "quotes": [
        {
            "rfqId": 123456,
            "quoteId": 333,

            "txId": "adsswe"
        }
    ],
    "code": "adsswe"
}

응답 매개변수

스트라이크 목록

GET rfq/strike-list

입력 매개변수

요청 예시

{  
"indexPrice": 3750.8，  
"forCcy": "WBTC",  
}

응답 매개변수

만료 목록

GET rfq/expiry-list

입력 매개변수

요청 예시

{  
"vault": "XXXXXXXXXXXXXX",  
"chainId": 1,  
}

응답 매개변수

Aave apy

GET rfq/aave-apy

입력 매개변수

응답 매개변수

응답 예시

{  
"chainId": 1,  
"ccy":"USDT",  
"avgApy":"0.23442",  
"currentApy":"0.23442",  
"apyUsed":"0.23442",  
"apyDefinition":"AAVE_LENDING_APY"  
}

Apy

GET rfq/apy

입력 매개변수

응답 매개변수

응답 예시

{  
"chainId": 1,  
"ccy":"USDT",  
"avgApy":"0.23442",  
"currentApy":"0.23442",  
"apyUsed":"0.23442",  
"apyDefinition":"AAVE_LENDING_APY"  
}

지갑 포지션 가져오기

POST /rfq/position-list

입력 매개변수

참고: 지정된 startDateTime 및 endDateTime 내에서 결과 수가 300을 초과하면 폴링을 사용할 수 있습니다(이 경우 orderBy는 "createdAt"으로 설정해야 함). n번째 폴링 요청의 endDateTime 매개변수는 (n-1)번째 폴링 결과의 마지막 레코드의 createdAt으로 설정해야 합니다. 모든 데이터를 검색한 후에는 id 필드를 기준으로 중복을 제거해야 합니다.

응답 매개변수

객체

응답 예시

{
    "value": [{
        ...
    }]
}

지갑 거래 내역 가져오기

POST /rfq/transaction-list

입력 매개변수

참고: 테이커, 메이커 및 claimParams 매개변수는 포지션에 해당하는 거래 기록을 찾기 위한 공동 쿼리에 사용될 수 있습니다(포지션은 여러 거래에 해당할 수 있음)(모든 매개변수가 필요하지는 않음). 지정된 startDateTime 및 endDateTime 내에서 결과 수가 300을 초과하는 경우, 폴링을 사용할 수 있습니다(이 경우 orderBy는 "createdAt"으로 설정해야 함) 계속 쿼리합니다. n번째 폴링 요청의 endDateTime 매개변수는 (n-1)번째 폴링 결과의 마지막 기록의 createdAt으로 설정해야 합니다. 모든 데이터를 가져온 후에는 id 필드를 기준으로 중복을 제거해야 합니다.

응답 매개변수

객체

응답 예시

{
    "value": [{
        ...
    }]
}

손실 포지션 숨기기

POST rfq/position/conceal

입력 매개변수

요청 예시

{
    "positionIds": [
        "aaaa","bbbb"
    ],
    "chainId": 1
}

응답 매개변수

보류 중인 거래 가져오기

이는 주로 기본 포지션 데이터 동기화 문제를 해결하기 위한 것입니다. 여기서 검색된 데이터는 사라질 수 있습니다 (블록체인 포크 경쟁으로 인해).

POST rfq/transactions/pending

입력 매개변수

응답 매개변수

객체

RCH 에어드롭 기록 가져오기

GET rfq/airdrop/history

입력 매개변수

응답 매개변수

객체