Der Abschnitt instruments enthält Methoden zum Abrufen einer Liste aktiver Instrumente, zum Abrufen von Informationen über ein einzelnes Instrument sowie zur Überprüfung, ob die Adresse für das angegebene Instrument korrekt ist.
Documentation
Allgemeine Beschreibung
Gibt eine öffentliche Liste aller aktiven Instrumente (Währungen und Netzwerke) zurück, die für den Austausch verfügbar sind.
Parameter
Query-Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
providers |
array[string] | ja | Liste der Liquiditätsanbieter (z. B., BINANCE). Wiederholen Sie den Parameter für jeden Anbieter. |
Headers
| Name | Erforderlich | Beschreibung |
|---|---|---|
X-Api-Public-Key |
ja | Ihr öffentlicher API-Schlüssel. |
X-Api-Timestamp |
ja | Timestamp im UNIX-Format (ms). |
X-Api-Signature |
ja | HMAC-Signatur der Anfrage, erstellt mit Ihrem geheimen Schlüssel. |
Beispielanfrage
curl -X GET "https://quickex.io/api/v2/instruments/public?providers" \
-H "accept: application/json" \
-H "X-Api-Public-Key: yourPublicKey" \
-H "X-Api-Timestamp: 1691400000000" \
-H "X-Api-Signature: yourHmacSignature"
Beispielantwort
[
{
"currencyTitle": "ADA",
"networkTitle": "ADA",
"currencyFriendlyTitle": "Cardano",
"precisionDecimals": 11,
"requiresMemo": false,
"currencyLogoLink": "https://static.coinall.ltd/cdn/assets/imgs/221/5FFE6AFD21B40243.png",
"instrumentType": "crypto"
},
{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"currencyFriendlyTitle": "Tether USD",
"precisionDecimals": 6,
"requiresMemo": false,
"currencyLogoLink": "https://static.coinall.ltd/cdn/assets/imgs/USDT.png",
"instrumentType": "crypto"
}
]
Anwendungsfall
Beim Initialisieren des Austauschformulars auf einer Webseite müssen alle verfügbaren Währungen und Netzwerke der angegebenen Anbieter angezeigt werden. Das Frontend ruft diese Methode auf und baut die Dropdowns für Währungen und Netzwerke basierend auf der zurückgegebenen Liste.
Code Sample
curl -X 'GET' \
'https://quickex.io/api/v2/instruments/public' \
-H 'accept: application/json'Response Example
[
{
"currencyTitle": "STX",
"networkTitle": "STX",
"slug": "stxstx",
"currencyFriendlyTitle": "STX",
"precisionDecimals": 8,
"currencyLogoLink": "https://quickex.io/assets/coins/stx.svg",
"requiresMemo": true,
"instrumentType": "crypto",
"bestChangeName": "",
"contractAddress": ""
},
{
"currencyTitle": "AVAX",
"networkTitle": "AVAX",
"slug": "avax",
"currencyFriendlyTitle": "AVAX",
"precisionDecimals": 3,
"currencyLogoLink": "https://quickex.io/assets/coins/avax.svg",
"requiresMemo": false,
"instrumentType": "crypto",
"bestChangeName": "AVAX",
"contractAddress": ""
},
{
"currencyTitle": "SAND",
"networkTitle": "ERC20",
"slug": "sanderc20",
"currencyFriendlyTitle": "SAND",
"precisionDecimals": 2,
"currencyLogoLink": "https://quickex.io/assets/coins/sand.svg",
"requiresMemo": false,
"instrumentType": "crypto",
"bestChangeName": "",
"contractAddress": "0x3845badade8e6dff049820680d1f14bd3903a5d0"
}
]Try it out
Leave empty to use default
Headers
Documentation
Allgemeine Beschreibung
Gibt Informationen über ein einzelnes aktives Instrument (Währung + Netzwerk) aus der öffentlichen Liste zurück.
Parameter
Headers
| Name | Erforderlich | Beschreibung |
|---|---|---|
X-Api-Public-Key |
ja | Ihr öffentlicher API-Schlüssel. |
X-Api-Timestamp |
ja | Zeitstempel im UNIX-Format (ms). |
X-Api-Signature |
ja | HMAC-Signatur des Anfragekörpers, erstellt mit Ihrem geheimen Schlüssel. |
Anfragetext (JSON)
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
currencyTitle |
string | ja | Währungscode (z. B. USDT). |
networkTitle |
string | ja | Währungsnetzwerk (z. B. TRC20). |
Beispielanfrage
curl -X POST 'https://quickex.io/api/v2/instruments/public/one' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'X-Api-Public-Key: yourPublicKey' \
-H 'X-Api-Timestamp: 1691400000000' \
-H 'X-Api-Signature: yourHmacSignature' \
-d '{
"currencyTitle": "USDT",
"networkTitle": "TRC20"
}'
Beispielantworten
200 OK — Instrument gefunden:
{
"currencyTitle": "ADA",
"networkTitle": "ADA",
"currencyFriendlyTitle": "Cardano",
"precisionDecimals": 11,
"requiresMemo": false,
"currencyLogoLink": "https://static.coinall.ltd/cdn/assets/imgs/221/5FFE6AFD21B40243.png",
"instrumentType": "crypto",
"bestChangeName": "USDTTRC20"
}
500 ERR_UNKNOWN — Instrument nicht gefunden oder interner Fehler:
{
"status": "ERR_UNKNOWN",
"message": "code=404, message=Not Found",
"data": null
}
Anwendungsfall
Beim Erstellen einer Order muss das Frontend detaillierte Informationen über das ausgewählte Instrument anzeigen: Anzeigename, Präzision und ob ein Memo/Tag erforderlich ist. Nachdem der Nutzer Währung und Netzwerk ausgewählt hat, wird diese Methode aufgerufen und die zurückgegebenen Daten dienen zur Validierung und Darstellung der Eingabefelder.
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v2/instruments/public/one' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"currencyTitle": "USDT",
"networkTitle": "TRC20"
}'Response Example
{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"currencyFriendlyTitle": "USDT",
"precisionDecimals": 2,
"currencyLogoLink": "https://quickex.io/assets/coins/usdt.svg",
"requiresMemo": false,
"instrumentType": "crypto",
"contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
}Try it out
Leave empty to use default
Request Body
Headers
Documentation
Allgemeine Beschreibung
Validiert die Korrektheit einer Adresse für die angegebene Währung und das Netzwerk. Gibt true zurück, wenn die Adresse dem Format und den Netzwerkanforderungen entspricht; andernfalls false oder einen Fehler.
Parameter
Headers
| Name | Erforderlich | Beschreibung |
|---|---|---|
X-Api-Public-Key |
ja | Ihr öffentlicher API-Schlüssel. |
X-Api-Timestamp |
ja | Zeitstempel im UNIX-Format (ms). |
X-Api-Signature |
ja | HMAC-Signatur des Anfragekörpers, erstellt mit Ihrem geheimen Schlüssel. |
Anfragetext (JSON)
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
currencyTitle |
string | ja | Währungscode (z. B. USDT). |
networkTitle |
string | ja | Netzwerk der Währung (z. B. TRC20). |
address |
string | ja | Zu validierende Adresse. |
Beispielanfrage
curl -X POST 'https://quickex.io/api/v2/instruments/public/validate-address' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'X-Api-Public-Key: yourPublicKey' \
-H 'X-Api-Timestamp: 1691400050000' \
-H 'X-Api-Signature: yourHmacSignature' \
-d '{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"address": "THUmkPhry61edcTf79yTioV6292ccsuCjV"
}'
Beispielantworten
200 OK — Adresse ist gültig:
true
400 ERR_INVALID_ADDRESS — Adresse entspricht nicht dem Netzwerkformat:
false
500 ERR_UNKNOWN — Instrument nicht gefunden oder interner Fehler:
{
"status": "ERR_UNKNOWN",
"message": "code=404, message=Not Found",
"data": null
}
Anwendungsfall
Vor dem Erstellen einer Order validiert das Frontend die vom Benutzer eingegebene Adresse: Wenn true zurückgegeben wird, wird der Vorgang fortgesetzt; andernfalls wird eine Fehlermeldung angezeigt und der Benutzer aufgefordert, die Adresse zu prüfen.
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v2/instruments/validate-address' \
-H 'accept: */*' \
-H 'Content-Type: application/json' \
-d '{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"address": "THUmkPhry61edcTf79yTioV6292ccsuCjV",
"memo": "2345678",
"getRejectReason": true
}'Response Example
{
"status": "ERR_HTTP",
"message": "Http Exception",
"data": {
"address": "adddress is incorrect"
}
}Try it out
Leave empty to use default