DApp Open APIs

Unsere bestehende dApp auf sofa.org ist ein kritisches Workflow-Feature und der Hauptweg für Benutzer, um mit den SOFA-Protokollen zu interagieren. Wir ermutigen jedoch andere Entwickler, den Zugang zu ermöglichen und sich über ihre eigenen dApps mit SOFA zu verbinden, um das Wachstum unseres Ökosystems zu maximieren. Wir betrachten diese als unsere 'Broker'-Partner und ermutigen interessierte Parteien, das SOFA-Team für weitere API-Informationen zu kontaktieren.

DNT

Empfohlene DNT RFQ-Liste Anfrage

GET /rfq/dnt/recommended-list

Eingabeparameter

Antwortparameter

Objekt

Anforderungsbeispiel

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

Antwort

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

• Hinweise:
  • Bitte geben Sie die Wallet-Adresse des Benutzers bei einer reinen Anfrage nicht weiter.
  • Die Wallet-Adresse eines Benutzers sollte nur bei einer Anmeldung weitergegeben werden.

GET /rfq/dnt/quote

Eingabeparameter

Antwortparameter

Objekt

DNT Gewinnwahrscheinlichkeit

Wahrscheinlichkeit, innerhalb der Grenzen bis zum Ablauf zu bleiben

GET rfq/dnt/winning-probabilities

Eingabeparameter

Antwortparameter

Objekt

Anforderungsbeispiel

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

Antwort

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

Smart Trend

Empfohlene Smart Trend RFQ-Liste Anfrage

GET rfq/smart-trend/recommended-list

Eingabeparameter

Antwortparameter

Objekt

Anfragebeispiel

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

Smart Trend Anfrage

• Hinweise:
  • Bitte geben Sie die Wallet-Adresse des Benutzers bei einer reinen Anfrage nicht weiter.
  • Die Wallet-Adresse eines Benutzers sollte nur bei einer Anmeldung übermittelt werden.

GET /rfq/smart-trend/quote

Eingabeparameter

Antwortparameter

Objekt

Smart Trend Gewinnwahrscheinlichkeit

Wahrscheinlichkeit, innerhalb der Grenzen bis zum Ablauf zu bleiben

GET rfq/smart-trend/winning-probabilities

Eingabeparameter

Antwortparameter

Objekt

Beispielanfrage

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

Antwort

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

Generische Schnittstelle

RFQ löschen

Löschen Sie die RFQ, die on-chain war

POST rfq/remove

Eingabeparameter

Beispielanfrage

{  
"rfqId":123456  
}

Antwortparameter

Transaktionsbenachrichtigung

POST rfq/trade

Eingabeparameter

Beispielanfrage

{
    "quotes": [
        {
            "rfqId": 123456,
            "quoteId": 333,
            "txId": "adsswe"
        }
    ],
    "code": "adsswe"
}

Antwortparameter

Strike-Liste

GET rfq/strike-list

Eingabeparameter

Beispielanfrage

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

Antwortparameter

Ablauf-Liste

GET rfq/expiry-list

Eingabeparameter

Beispielanfrage

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

Antwortparameter

Aave apy

GET rfq/aave-apy

Eingabeparameter

Antwortparameter

Beispielantwort

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

Apy

GET rfq/apy

Eingabeparameter

Antwortparameter

Beispielantwort

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

Wallet-Positionen abrufen

POST /rfq/position-list

Eingabeparameter

Hinweis: Wenn die Anzahl der Ergebnisse 300 innerhalb des angegebenen startDateTime und endDateTime überschreitet, kann Polling verwendet werden (in diesem Fall muss orderBy auf "createdAt" gesetzt werden), um die Abfrage fortzusetzen. Der endDateTime-Parameter für die n-te Polling-Anfrage sollte auf den createdAt des letzten Datensatzes aus dem (n-1)-ten Polling-Ergebnis gesetzt werden. Nach dem Abrufen aller Daten sollten Duplikate basierend auf dem id-Feld entfernt werden.

Antwortparameter

Objekt

Antwortbeispiel

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

Wallet-Transaktionen abrufen

POST /rfq/transaction-list

Eingabeparameter

Hinweis: Die Parameter Taker, Maker und claimParams können für eine gemeinsame Abfrage verwendet werden, um die Handelsaufzeichnungen zu finden, die einer Position entsprechen (eine Position kann mehreren Trades entsprechen) (nicht alle Parameter sind erforderlich). Wenn die Anzahl der Ergebnisse 300 innerhalb des angegebenen startDateTime und endDateTime überschreitet, kann Polling verwendet werden (in diesem Fall muss orderBy auf "createdAt" gesetzt werden), um die Abfrage fortzusetzen. Der endDateTime-Parameter für die n-te Polling-Anfrage sollte auf das createdAt des letzten Datensatzes aus dem (n-1)-ten Polling-Ergebnis gesetzt werden. Nach dem Abrufen aller Daten sollten Duplikate basierend auf dem id-Feld entfernt werden.

Antwortparameter

Objekt

Beispielantwort

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

Verlustpositionen verbergen

POST rfq/position/conceal

Eingabeparameter

Beispielanfrage

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

Antwortparameter

Ausstehende Transaktionen abrufen

Dies dient hauptsächlich der Behebung des Problems der Synchronisierung der zugrunde liegenden Positionsdaten. Die hier abgerufenen Daten können verschwinden (aufgrund von Blockchain-Gabelwettbewerb).

POST rfq/transactions/pending

Eingabeparameter

Antwortparameter

Objekt

RCH Airdrop-Historie abrufen

GET rfq/airdrop/history

Eingabeparameter

Antwortparameter

Objekt