DApp Open APIs

Наш существующий dApp на sofa.org является критически важной функцией рабочего процесса и основным способом взаимодействия пользователей с протоколами SOFA. Однако мы призываем других разработчиков предоставить доступ и подключиться к SOFA через свои собственные dApps, чтобы максимизировать рост нашей экосистемы. Мы считаем их нашими партнерами «Брокерами» и призываем заинтересованные стороны связаться с командой SOFA для получения дополнительной информации о API.

DNT

Рекомендуемый список запросов на котировку DNT

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

Параметры ввода

Параметры ответа

Объект

Пример запроса

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

Запрос Smart Trend

• Примечания:
  • Пожалуйста, не передавайте адрес кошелька пользователя в чистом запросе.
  • Адрес кошелька пользователя должен передаваться только при подписке.

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

Параметры ввода

Примечание: Если количество результатов превышает 300 в указанных startDateTime и endDateTime, можно использовать опрос (в этом случае orderBy должен быть установлен на "createdAt"), чтобы продолжить запрос. Параметр endDateTime для n-го запроса на опрос должен быть установлен на createdAt последней записи из (n-1)-го результата опроса. После получения всех данных дубликаты должны быть удалены на основе поля id.

Параметры ответа

Объект

Пример ответа

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

Получить транзакции кошелька

POST /rfq/transaction-list

Параметры ввода

Примечание: Параметры taker, maker и claimParams могут быть использованы для совместного запроса для поиска торговых записей, соответствующих позиции (позиция может соответствовать нескольким сделкам) (не все параметры обязательны). Если количество результатов превышает 300 в указанных startDateTime и endDateTime, можно использовать опрос (в этом случае orderBy должен быть установлен на "createdAt"), чтобы продолжить запрос. Параметр endDateTime для n-го запроса опроса должен быть установлен на createdAt последней записи из (n-1)-го результата опроса. После получения всех данных дубликаты должны быть удалены на основе поля id.

Параметры ответа

Объект

Пример ответа

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

Скрыть позиции убытков

POST rfq/position/conceal

Входные параметры

Пример запроса

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

Параметры ответа

Получить ожидающие транзакции

Это в основном направлено на решение проблемы синхронизации данных о позициях. Данные, полученные здесь, могут исчезнуть (из-за конкуренции форков блокчейна).

POST rfq/transactions/pending

Параметры ввода

Параметры ответа

Объект

Получить историю аирдропа RCH

GET rfq/airdrop/history

Параметры ввода

Параметры ответа

Объект