DApp Open APIs

私たちの既存のdAppであるsofa.orgは、重要なワークフローフィーチャーであり、ユーザーがSOFAプロトコルと対話する主な方法です。しかし、私たちは他の開発者が自分のdAppを通じてSOFAにアクセスし、接続することを奨励し、エコシステムの成長を最大化することを目指しています。これらの開発者を私たちの「ブローカー」パートナーと見なし、興味のある方はSOFAチームにAPIに関するさらなる情報を問い合わせることをお勧めします。

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

入力パラメータ

| vault | true | string | 契約情報 | | chainId | true | int | チェーンID | | expiry | true | number | 有効期限の日付の秒単位のタイムスタンプ、例：1672387200 | | lowerBarrier | true | number | 下限価格 | | upperBarrier | true | number | 上限価格 | | depositAmount | true | number | RFQ購入額 | | inputApyDefinition | true | string | 入力APYがどのように計算されるかを示すEnum：OptimusDefaultAPY、BinanceDntAPY、AaveLendingAPY | | protectedApy | false | number | 保護された年利（RISKYの場合は空、保護された場合は必須） | | fundingApy | false | number | AAVE年利（RISKYの場合は空、保護された場合は必須） | | takerWallet | false | string | 問い合わせ者のウォレットの公開アドレス情報 |

レスポンスパラメータ

オブジェクト

DNT 勝率

期限までに境界内に留まる確率

GET rfq/dnt/winning-probabilities

入力パラメータ

レスポンスパラメータ

オブジェクト

リクエスト例

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

入力パラメータ

レスポンスパラメータ

オブジェクト