DApp Open APIs

Notre dApp existante sur sofa.org est une fonctionnalité critique de flux de travail et est le principal moyen pour les utilisateurs d'interagir avec les protocoles SOFA. Cependant, nous encourageons d'autres développeurs à permettre l'accès et à se connecter à SOFA via leurs propres dApps afin de maximiser la croissance de notre écosystème. Nous considérons ces derniers comme nos partenaires 'Broker' et encourageons les parties intéressées à contacter l'équipe SOFA pour plus d'informations sur l'API.

DNT

Demande de liste RFQ DNT recommandée

GET /rfq/dnt/recommended-list

Paramètres d'entrée

Paramètres de réponse

Objet

Exemple de demande

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

Réponse

{
    "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"
                }

        }
    ]
}

Demande DNT

• Remarques :
  • Veuillez ne pas transmettre l'adresse du portefeuille de l'utilisateur lors d'une demande de simple enquête.
  • L'adresse du portefeuille d'un utilisateur ne doit être transmise qu'après abonnement.

GET /rfq/dnt/quote

Paramètres d'entrée

Paramètres de réponse

Objet

Probabilité de Gain DNT

Probabilité de rester dans les limites jusqu'à l'expiration

GET rfq/dnt/winning-probabilities

Paramètres d'Entrée

Paramètres de Réponse

Objet

Exemple de demande

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

Réponse

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

Tendance Intelligente

Demande de liste RFQ de Tendance Intelligente recommandée

GET rfq/smart-trend/recommended-list

Paramètres d'entrée

Paramètres de réponse

Objet

Exemple de demande

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

Enquête sur la tendance intelligente

• Remarques :
  • Veuillez ne pas transmettre l'adresse du portefeuille de l'utilisateur lors d'une demande d'enquête pure.
  • L'adresse du portefeuille d'un utilisateur ne doit être transmise qu'après abonnement.

GET /rfq/smart-trend/quote

Paramètres d'entrée

Paramètres de réponse

Objet

Probabilité de Gain de Smart Trend

Probabilité de rester dans les limites jusqu'à l'expiration

GET rfq/smart-trend/winning-probabilities

Paramètres d'Entrée

Paramètres de Réponse

Objet

Exemple de Demande

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

Réponse

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

Interface Générique

Supprimer RFQ

Supprimez le RFQ qui a été enregistré sur la chaîne

POST rfq/remove

Paramètres d'entrée

Exemple de demande

{  
"rfqId":123456  
}

Paramètres de réponse

Notification de transaction

POST rfq/trade

Paramètres d'entrée

Exemple de demande

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

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

Paramètres de réponse

Liste des strikes

GET rfq/strike-list

Paramètres d'entrée

Exemple de demande

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

Paramètres de réponse

Liste des expirations

GET rfq/expiry-list

Paramètres d'entrée

Exemple de requête

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

Paramètres de réponse

Aave apy

GET rfq/aave-apy

Paramètres d'entrée

Paramètres de réponse

Exemple de réponse

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

Apy

GET rfq/apy

Paramètres d'entrée

Paramètres de réponse

Exemple de réponse

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

Obtenir les positions de portefeuille

POST /rfq/position-list

Paramètres d'entrée

| Nom du champ | Requis | Type | Description |

| --- | --- | --- | --- | | chainId | true | Int | | | vaults | false | list[string] | Ensemble d'adresses de contrats ; si non fourni, tous les contrats seront interrogés. | | claimed | false | boolean | Indique s'il a été échangé ; si non fourni, les positions de tous les statuts seront interrogées. | | expired | false | boolean | Indique s'il a expiré ; si non fourni, les positions de tous les statuts seront interrogées. | | concealed | false | boolean | Indique s'il est caché ; si non fourni, les positions de tous les statuts seront interrogées. | | positiveReturn | false | boolean | Indique si le montant de rachat est supérieur à 0 ; si non fourni, toutes les positions seront interrogées. | | positiveProfit | false | boolean | Indique si le retour dépasse le principal ; si non fourni, toutes les positions seront interrogées. | | limit | false | Int | Nombre de requêtes ; par défaut 100, maximum 300. | | startDateTime | false | number | Horodatage correspondant en secondes (inclus), par exemple, 1672387200. | | endDateTime | false | number | Horodatage correspondant en secondes (inclus), par exemple, 1672387200. | | orderBy | false | string | "createdAt" ou "return", méthode de tri : "createdAt" (heure de mise à jour, par défaut) ou "return" (retours). | | orderDirection | false | string | "desc" ou "asc", par défaut "desc" (ordre décroissant). | | wallet | false | string | Adresse de portefeuille (si vide, toutes les adresses de portefeuille sont interrogées). |

Note : Si le nombre de résultats dépasse 300 dans la plage de startDateTime et endDateTime spécifiée, le sondage peut être utilisé (dans ce cas, orderBy doit être défini sur "createdAt") pour continuer à interroger. Le paramètre endDateTime pour la n-ième requête de sondage doit être défini sur le createdAt du dernier enregistrement du résultat de sondage (n-1). Après avoir récupéré toutes les données, les doublons doivent être supprimés en fonction du champ id.

Paramètres de réponse

Objet

Exemple de réponse

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

Obtenir les transactions de portefeuille

POST /rfq/transaction-list

Paramètres d'entrée

Remarque : Les paramètres taker, maker et claimParams peuvent être utilisés pour une requête conjointe afin de trouver les enregistrements de trade correspondants à une position (une position peut correspondre à plusieurs trades) (tous les paramètres ne sont pas requis). Si le nombre de résultats dépasse 300 dans la plage de startDateTime et endDateTime spécifiée, un sondage peut être utilisé (dans ce cas, orderBy doit être défini sur "createdAt") pour continuer à interroger. Le paramètre endDateTime pour la n-ième requête de sondage doit être défini sur le createdAt du dernier enregistrement du résultat de sondage (n-1). Après avoir récupéré toutes les données, les doublons doivent être supprimés en fonction du champ id.

Paramètres de réponse

Objet

Exemple de réponse

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

Masquer les positions de perte

POST rfq/position/conceal

Paramètres d'entrée

Exemple de requête

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

Paramètres de réponse

Obtenir les transactions en attente

Ceci vise principalement à résoudre le problème de synchronisation des données de position sous-jacentes. Les données récupérées ici peuvent disparaître (en raison de la concurrence des forks de blockchain).

POST rfq/transactions/pending

Paramètres d'entrée

Paramètres de réponse

Objet

Obtenir l'historique des airdrops RCH

GET rfq/airdrop/history

Paramètres d'entrée

Paramètres de réponse

Objet