Die Methodengruppe Orders ist für die Arbeit mit Aufträgen – von Nutzerinnen und Nutzern auf der Quickex-Plattform erstellten Tauschvorgängen – verantwortlich.
Mit diesen Methoden können Sie öffentliche Informationen zu einem bestimmten Auftrag sowie zu den neuesten Tauschvorgängen abrufen,
eine E-Mail mit einem Auftrag verknüpfen, um Benachrichtigungen zu erhalten, Änderungen des Wechselkursmodus akzeptieren (z. B. Wechsel von fest zu variabel), eine Rückerstattung anstoßen und deren Status prüfen.
Diese Methoden werden in allen Phasen des Auftragslebenszyklus verwendet – vom Tracking bis zu Rückerstattungen.
Documentation
Gibt öffentliche Informationen zu einem Auftrag (Tauschvorgang) anhand der Zieladresse zurück.
Die Antwort enthält Details zu Einzahlungen/Auszahlungen, Handelspaar, deklarierten Kursparametern, Auftragsereignissen usw.
URL
https://quickex.io/api/v1/orders/public-info
Anfrageparameter (Query)
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
destinationAddress |
string | ja | Die mit dem Auftrag verknüpfte Zieladresse. Wird zur Suche nach dem Auftrag verwendet. |
Beispielanfrage (cURL)
curl -X GET \
'https://quickex.io/api/v1/orders/public-info?destinationAddress=0xdeadbeef' \
-H 'Accept: application/json'
Beispielantwort (Erfolg)
{
"orderId": 1234,
"legacyOrderId": "QX-0001234",
"pair": {
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo": { "currencyTitle": "BTC", "networkTitle": "BTC" }
},
"deposits": [
{
"createdAt": "2025-08-22T05:51:30.993Z",
"instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true
}
],
"withdrawals": [
{
"createdAt": "2025-08-22T05:51:30.993Z",
"instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"amount": "1000.1",
"networkFee": "1.1",
"txId": "0xdeadc0dedeadbeef"
}
],
"rateMode": "FLOATING",
"claimedDepositAmount": "10.01",
"amountToGet": "10.01",
"completed": false,
"userEmail": "test@example.com",
"destinationAddress": "0xdeadbeef"
}
Antworten
| Code | Inhalt | Beschreibung |
|---|---|---|
200 OK |
JSON mit Auftragsinformationen | Der Auftrag wurde gefunden und zurückgegeben. |
400 Bad Request |
{"status":"ERR_VALIDATION","message":"Validation Exception", ...} |
Validierungsfehler (z. B. wenn destinationAddress fehlt oder ungültig ist). |
5xx |
— | Interner Serverfehler. |
Hinweise
- Die Methode liefert öffentliche Auftragsdaten; private Details sind nicht verfügbar.
- Wenn der Auftrag noch nicht erstellt wurde bzw. unter der Adresse nicht gefunden werden kann, wird ein Validierungsfehler oder ein leeres Ergebnis zurückgegeben.
- Die Struktur der Abschnitte
deposits/withdrawalsund der Hilfsfelder kann je nach Auftragsstatus und Liquiditätsanbieter variieren.
Code Sample
curl -X 'GET' \
'https://quickex.io/api/v1/orders/public-info?destinationAddress={YOUR_ADDRESS}' \
-H 'accept: application/json'Response Example
{
"deposits": [
{
"createdAt": "2025-08-22T05:51:30.993Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true,
"id": 0,
"counterPartyAddress": "0xdeadc0dedeadbeef"
}
],
"withdrawals": [
{
"createdAt": "2025-08-22T05:51:30.993Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"networkFee": "1.1",
"txId": "0xdeadc0dedeadbeef"
}
],
"depositAddress": {
"orderId": 0,
"liquidityProviderTitle": "QUICKEX_BUSINESS_ACCOUNT",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"depositAddress": "0xdeadc0de",
"depositAddressMemo": "string",
"redirectUrl": "string"
},
"orderId": 0,
"legacyOrderId": "string",
"pair": {
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
}
},
"createdAt": "2025-08-22T05:51:30.994Z",
"claimedDepositAmount": "10.01",
"amountToGet": "10.01",
"claimedPublicRate": {
"price": "1000.1",
"quotes": {
"sellQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
},
"buyQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
}
},
"updatedAt": "2025-08-22T05:51:30.994Z",
"liquidityProviderPublicCode": "formulae",
"claimedAmountToReceive": "0.01",
"finalNetworkFeeAmount": "0.01",
"platformFee_Absolute": "0.01",
"fixedRate_maxAmount": "1000.000",
"fixedRate_maxTimeMinutes": 1,
"fixedRate_maxRateVolatilityPercent": "1000.000"
},
"claimedNetworkFee": "10.01",
"KYCFormLink": "string",
"orderEvents": [
{
"kind": "TRACKING_STARTED",
"createdAt": "2025-08-22T05:51:30.994Z"
}
],
"userEmail": "test@example.com",
"rateMode": "FLOATING",
"destinationAddress": "0xdeadbeef",
"destinationAddressMemo": "0xdeadbeef",
"completed": false,
"possibleCashbackAmountUSDT": "500.00",
"redirectUrl": "https://payments.mercuryo.io/"
}Try it out
Leave empty to use default
Headers
Documentation
Weist einer bestehenden Order (Tauschvorgang) eine E-Mail zu. Die E-Mail wird verwendet, um Benachrichtigungen zum Auftragsstatus zu senden und um den Support zu kontaktieren.
URL
https://quickex.io/api/v1/orders/public/set-email
Autorisierung erforderlich
Nein (öffentliche Methode für eine bestehende Order).
Header
Accept: application/jsonContent-Type: application/json
Anfragetext (JSON)
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
orderId |
number | ja | Der Bezeichner der Order, der die E-Mail zugeordnet werden soll. |
userEmail |
string (email) | ja | E-Mail-Adresse des Nutzers für Benachrichtigungen. |
{
"orderId": 123456,
"userEmail": "user@example.com"
}
Beispielanfrage (cURL)
curl -X POST \
'https://quickex.io/api/v1/orders/public/set-email' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"orderId": 123456,
"userEmail": "user@example.com"
}'
Antworten
| Code | Inhalt | Beschreibung |
|---|---|---|
200 OK |
JSON mit öffentlichen Order-Informationen (einschließlich userEmail) |
E-Mail wurde der Order erfolgreich zugeordnet. |
400 Bad Request |
{"status":"ERR_VALIDATION","message":"Validation Exception", ...} |
Validierungsfehler (z. B. wenn userEmail keine gültige E-Mail-Adresse ist). |
5xx |
— | Interner Serverfehler. |
Hinweise
- Stellen Sie vor dem Aufruf sicher, dass eine gültige
orderIdeiner bestehenden Order angegeben ist.userEmailmuss eine gültige E-Mail-Adresse sein (Beispiel für einen Fehler:userEmail must be an email).- Bei Erfolg enthält die Antwort die aktuellen öffentlichen Order-Informationen, wobei das Feld
userEmaildie zugewiesene Adresse enthält.
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v1/orders/public/set-email' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"orderId": {ID},
"userEmail": "user@example.com"
}'Response Example
{
"deposits": [
{
"createdAt": "2025-08-22T06:03:09.050Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true,
"id": 0,
"counterPartyAddress": "0xdeadc0dedeadbeef"
}
],
"withdrawals": [
{
"createdAt": "2025-08-22T06:03:09.050Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"networkFee": "1.1",
"txId": "0xdeadc0dedeadbeef"
}
],
"depositAddress": {
"orderId": 0,
"liquidityProviderTitle": "QUICKEX_BUSINESS_ACCOUNT",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"depositAddress": "0xdeadc0de",
"depositAddressMemo": "string",
"redirectUrl": "string"
},
"orderId": 0,
"legacyOrderId": "string",
"pair": {
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
}
},
"createdAt": "2025-08-22T06:03:09.050Z",
"claimedDepositAmount": "10.01",
"amountToGet": "10.01",
"claimedPublicRate": {
"price": "1000.1",
"quotes": {
"sellQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
},
"buyQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
}
},
"updatedAt": "2025-08-22T06:03:09.050Z",
"liquidityProviderPublicCode": "formulae",
"claimedAmountToReceive": "0.01",
"finalNetworkFeeAmount": "0.01",
"platformFee_Absolute": "0.01",
"fixedRate_maxAmount": "1000.000",
"fixedRate_maxTimeMinutes": 1,
"fixedRate_maxRateVolatilityPercent": "1000.000"
},
"claimedNetworkFee": "10.01",
"KYCFormLink": "string",
"orderEvents": [
{
"kind": "TRACKING_STARTED",
"createdAt": "2025-08-22T06:03:09.050Z"
}
],
"userEmail": "test@example.com",
"rateMode": "FLOATING",
"destinationAddress": "0xdeadbeef",
"destinationAddressMemo": "0xdeadbeef",
"completed": false,
"possibleCashbackAmountUSDT": "500.00",
"redirectUrl": "https://payments.mercuryo.io/"
}Try it out
Leave empty to use default
Request Body
Headers
Documentation
Gibt eine Liste der neuesten öffentlichen Orders zurück, die auf der Quickex-Plattform erstellt wurden.
Diese Methode erfordert keine Parameter und stellt Basisinformationen zu jüngsten Tauschvorgängen bereit (Währungen, Netzwerke und Beträge).
Parameter
Keine
Beispielanfrage
curl -X 'GET' \
'https://quickex.io/api/v1/orders/public/latest' \
-H 'accept: application/json'
Beispielantwort (200)
[
{
"createdAt": "2025-08-22T05:43:01.000Z",
"instrumentFrom": {
"currencyTitle": "BNB",
"networkTitle": "BEP20",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "BNB",
"currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/1839.png"
}
},
"instrumentTo": {
"currencyTitle": "SOL",
"networkTitle": "SOL",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "SOL",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/sol.png"
}
},
"amountFrom": "0.1809",
"amountTo": "0.82480169"
}
]
Hinweise
Die Methode gibt nur öffentliche Informationen zurück (ohne personenbezogene Nutzerdaten).
Sie eignet sich z. B. zur Anzeige eines Widgets „Neueste Tauschvorgänge“ auf einer Website.
Die Antwort enthält eine Liste mit einer begrenzten Anzahl von Einträgen (z. B. die letzten 5–10 Orders).
Code Sample
curl -X 'GET' \
'https://quickex.io/api/v1/orders/public/latest' \
-H 'accept: */*'Response Example
[
{
"createdAt": "2025-08-22T05:43:01.000Z",
"instrumentFrom": {
"currencyTitle": "BNB",
"networkTitle": "BEP20",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "BNB",
"currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/1839.png"
}
},
"instrumentTo": {
"currencyTitle": "SOL",
"networkTitle": "SOL",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "SOL",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/sol.png"
}
},
"amountFrom": "0.1809",
"amountTo": "0.82480169"
},
{
"createdAt": "2025-08-22T05:37:01.000Z",
"instrumentFrom": {
"currencyTitle": "BNB",
"networkTitle": "BEP20",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "BNB",
"currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/1839.png"
}
},
"instrumentTo": {
"currencyTitle": "SOL",
"networkTitle": "SOL",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "SOL",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/sol.png"
}
},
"amountFrom": "0.2012",
"amountTo": "0.91833564"
},
{
"createdAt": "2025-08-22T05:33:04.000Z",
"instrumentFrom": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "BTC",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/btc20230419112752.png"
}
},
"instrumentTo": {
"currencyTitle": "ATOM",
"networkTitle": "ATOM",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "ATOM",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/atom.png"
}
},
"amountFrom": "0.12827865",
"amountTo": "3149.690556"
},
{
"createdAt": "2025-08-22T05:29:03.000Z",
"instrumentFrom": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "BTC",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/btc20230419112752.png"
}
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "USDT",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/usdt20230419113051.png"
}
},
"amountFrom": "0.00478498",
"amountTo": "563.455834"
},
{
"createdAt": "2025-08-22T05:22:03.000Z",
"instrumentFrom": {
"currencyTitle": "ETH",
"networkTitle": "ETH",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "Ethereum",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/eth20230419112854.png"
}
},
"instrumentTo": {
"currencyTitle": "BNB",
"networkTitle": "BEP20",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "BNB",
"currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/1839.png"
}
},
"amountFrom": "0.59",
"amountTo": "2.77157716"
}
]Try it out
Leave empty to use default
Headers
Documentation
Bestätigt die Änderung des Wechselkursmodus für eine Order. Dies wird in Fällen verwendet, in denen die Order mit festem Kurs erstellt wurde, während des Tauschprozesses jedoch auf einen variablen Kurs umgestellt wurde (z. B. aufgrund von Limitüberschreitungen oder hoher Volatilität).
Die Methode ermöglicht es dem Nutzer, den neuen Modus zu akzeptieren und die Auftragsverarbeitung fortzusetzen.
URL
https://quickex.io/api/v1/orders/public/accept-rate-mode-change
Header
Accept: application/jsonContent-Type: application/json
Anfragetext (JSON)
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
orderId |
number | ja | Der Bezeichner der Order, für die die Änderung des Wechselkursmodus bestätigt werden muss. |
destinationAddress |
string | ja | Die mit der Order verknüpfte Zieladresse (wird als zusätzliche Prüfung verwendet). |
{
"orderId": 123456,
"destinationAddress": "0xdeadbeef"
}
Beispielanfrage (cURL)
curl -X POST \
'https://quickex.io/api/v1/orders/public/accept-rate-mode-change' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"orderId": 123456,
"destinationAddress": "0xdeadbeef"
}'
Antworten
| Code | Beschreibung |
|---|---|
201 Created |
Die Änderung des Wechselkursmodus wurde bestätigt und die Order wird weiterverarbeitet. |
404 Not Found |
Order nicht gefunden ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Validierungsfehler (z. B. ungültige Eingabedaten). |
5xx |
Interner Serverfehler. |
Hinweise
- Diese Methode wird nur aufgerufen, wenn die Order ihren Wechselkursmodus geändert hat (z. B. von fest zu variabel).
- Ohne Bestätigung wird die Verarbeitung der Order ausgesetzt.
- Bei Erfolg gibt die Antwort den Status 201 zurück und die Order wird weiterverarbeitet.
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v1/orders/public/accept-rate-mode-change' \
-H 'accept: */*' \
-H 'Content-Type: application/json' \
-d '{
"orderId": {},
"destinationAddress": "string"
}'Try it out
Leave empty to use default
Request Body
Headers
Documentation
Fordert eine Rückerstattung für eine Order an. Wird in Situationen verwendet, in denen der Tausch nicht abgeschlossen wurde oder Gelder an den Nutzer zurückgezahlt werden müssen.
Damit die Anfrage erfolgreich ist, müssen der Erstattungsbetrag und die Rückerstattungsadresse angegeben werden.
URL
https://quickex.io/api/v1/orders/public/request-refund
Header
Accept: application/jsonContent-Type: application/json
Anfragetext (JSON)
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
orderId |
number | ja | Der Bezeichner der Order, für die eine Rückerstattung angefordert wird. |
destinationAddress |
string | ja | Die in der ursprünglichen Order angegebene Zieladresse (wird als zusätzliche Prüfung verwendet). |
refundAmount |
string | ja | Der Betrag, der dem Nutzer erstattet werden soll. |
refundAddress |
string | ja | Die Wallet-Adresse des Nutzers, auf die die Erstattung ausgezahlt wird. |
claimedNetworkFee |
string | nein | Die Höhe der Netzwerkgebühr, deren Abzug der Nutzer für die Erstattung akzeptiert. |
{
"orderId": 123456,
"destinationAddress": "0xdeadbeef",
"refundAmount": "10.00",
"refundAddress": "0xuserrefundwallet",
"claimedNetworkFee": "0.50"
}
Beispielanfrage (cURL)
curl -X POST \
'https://quickex.io/api/v1/orders/public/request-refund' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"orderId": 123456,
"destinationAddress": "0xdeadbeef",
"refundAmount": "10.00",
"refundAddress": "0xuserrefundwallet",
"claimedNetworkFee": "0.50"
}'
Antworten
| Code | Beschreibung |
|---|---|
201 Created |
Die Rückerstattungsanfrage wurde angenommen und wird verarbeitet. |
404 Not Found |
Order nicht gefunden ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Validierungsfehler (z. B. Erstattungsbetrag unterhalb des zulässigen Minimums oder ungültige refundAddress). |
5xx |
Interner Serverfehler. |
Hinweise
- Diese Methode wird nur für Orders verwendet, die nicht abgeschlossen werden können.
- Die Erstattung erfolgt an die in
refundAddressangegebene Adresse, abzüglich etwaiger Netzwerkgebühren.- Nach dem Absenden kann die Rückerstattung eine manuelle Prüfung durch das Support-Team erfordern.
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v1/orders/public/request-refund' \
-H 'accept: */*' \
-H 'Content-Type: application/json' \
-d '{
"orderId": {},
"destinationAddress": "string",
"refundAmount": "10.00",
"refundAddress": "string",
"claimedNetworkFee": "10.00"
}'Try it out
Leave empty to use default
Request Body
Headers
Documentation
Gibt Rückerstattungsinformationen für eine bestimmte Order zurück.
Wird nach dem Erstellen einer Rückerstattungsanfrage verwendet, um die Details zu prüfen (Betrag, Erstattungsadresse, Status).
URL
https://quickex.io/api/v1/orders/order-refund-info
Anfrageparameter (Query)
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
orderId |
string | ja | Der Bezeichner der Order, für die Rückerstattungsdaten abgerufen werden sollen. |
curl -X GET \
'https://quickex.io/api/v1/orders/order-refund-info?orderId=1234' \
-H 'Accept: application/json'
Antworten
| Code | Beschreibung |
|---|---|
200 OK |
Gibt JSON mit Rückerstattungsinformationen zurück (Betrag, Adresse, Status, Gebühren). |
400 Bad Request |
Validierungsfehler oder ungültige Orderdaten ({"status":"ERR_BAD_REQUEST","message":"Unknown liquidity provider title: ..."}). |
404 Not Found |
Order nicht gefunden. |
5xx |
Interner Serverfehler. |
Hinweise
- Die Methode liefert Daten nur für Orders, bei denen eine Rückerstattung initiiert wurde.
- In einer erfolgreichen
200-Antwort kann das JSON den Erstattungsbetrag, die Erstattungsadresse und die Netzwerkgebühren enthalten.- Bei Validierungsfehlern (
400) liefert der Server den Grund im Feldmessage.
Code Sample
curl -X 'GET' \
'https://quickex.io/api/v1/orders/order-refund-info?orderId={YOUR_ORDERID}' \
-H 'accept: */*'Try it out
Leave empty to use default
Headers
Documentation
Gibt eine Liste der Orders zurück, die dem aktuell authentifizierten Nutzer zugeordnet sind.
Die Antwort enthält Details zu Einzahlungen, Auszahlungen, Parametern des Handelspaars, Orderstatus und weitere Informationen.
URL
https://quickex.io/api/v1/orders/public/list
Autorisierung erforderlich
Ja — im Header muss ein gültiges access_token angegeben werden.
Header
Accept: application/jsonaccess_token = YOUR_TOKEN
Parameter
Keine
Beispielanfrage (cURL)
curl -X GET \
'https://quickex.io/api/v1/orders/public/list' \
-H 'Accept: application/json' \
--cookie "access_token=YOUR_TOKEN"
Beispielantwort (200)
[
{
"orderId": 123,
"pair": {
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo": { "currencyTitle": "BTC", "networkTitle": "BTC" }
},
"deposits": [
{
"createdAt": "2025-08-26T09:55:46.101Z",
"instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true
}
],
"withdrawals": [
{
"createdAt": "2025-08-26T09:55:46.101Z",
"instrument": { "currencyTitle": "BTC", "networkTitle": "BTC" },
"amount": "0.025",
"txId": "0xbtcdeadbeef"
}
],
"status": "PENDING",
"createdAt": "2025-08-26T09:55:46.101Z"
}
]
Antworten
| Code | Beschreibung |
|---|---|
200 OK |
Gibt ein Array der Orders des Nutzers zurück. |
401 Unauthorized |
access_token fehlt oder ist ungültig. |
5xx |
Serverfehler bei der Verarbeitung der Anfrage. |
Hinweise
- Diese Methode gibt nur die Orders zurück, die vom aktuell authentifizierten Nutzer erstellt wurden.
- Um öffentliche Informationen zu einer bestimmten Order abzurufen, verwende die Methode
/api/v1/orders/public-info.- Es wird empfohlen, Orderdaten clientseitig zu cachen, um die Anzahl der Anfragen zu reduzieren.
Code Sample
curl -X 'GET' \
'https://quickex.io/api/v1/orders/public/list' \
-H 'accept: application/json'
--cookie "access_token=YOUR_TOKEN" \Try it out
Leave empty to use default
Headers
Documentation
Erstellt eine neue Tausch-Order.
Die Methode akzeptiert Parameter für das Handelspaar (Sende- und Empfangswährung), Betrag, Benutzeradressen sowie zusätzliche Daten
(Kurs, Gebühren, Affiliate-Parameter). In der Antwort wird ein Order-Objekt mit Details zu Ein- und Auszahlungen zurückgegeben.
URL
https://quickex.io/api/v1/orders/public/create
Authentifizierung
- Der Header
B2B-Bearer-Tokenist für B2B-Integrationen erforderlich (Beispiel:-H "B2B-Bearer-Token: TOKEN"). - Für Nutzerszenarien kann
access_tokenals Cookie verwendet werden.
Header
Accept: application/jsonContent-Type: application/jsonB2B-Bearer-Token: <TOKEN>
Anfragetext (JSON)
{
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo": { "currencyTitle": "LTC", "networkTitle": "LTC" },
"destinationAddress": "MWYK4uQXFvWc1Bj1CPACyX5HTQxUUpRZ2e",
"refundAddress": "TFe5tdqSy8CMGMDVHPJHLTK8hrAL6ddUpD",
"claimedDepositAmount": "3300",
"claimedPublicRate": {
"price": "0.014271620139287839394",
"updatedAt": "2024-02-13T14:43:12.983Z",
"claimedAmountToReceive": "47.09634645964987"
},
"claimedNetworkFee": "0.001",
"userEmail": "test@example.com",
"referrerId": "aff_some-affiliate-id",
"markupAffiliateId": "aff_some-affiliate-id",
"rateMode": "FLOATING",
"browserFingerprint": "string",
"markup": "0.01",
"locale": "en"
}
Beispielanfrage (cURL)
curl -X POST \
'https://quickex.io/api/v1/orders/public/create' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'B2B-Bearer-Token: YOUR TOKEN' \
-d '{
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo": { "currencyTitle": "LTC", "networkTitle": "LTC" },
"destinationAddress": "MWYK4uQXFvWc1Bj1CPACyX5HTQxUUpRZ2e",
"refundAddress": "TFe5tdqSy8CMGMDVHPJHLTK8hrAL6ddUpD",
"claimedDepositAmount": "3300",
"claimedPublicRate": {
"price": "0.014271620139287839394",
"updatedAt": "2024-02-13T14:43:12.983Z",
"claimedAmountToReceive": "47.09634645964987"
},
"claimedNetworkFee": "0.001",
"userEmail": "test@example.com",
"rateMode": "FLOATING",
"browserFingerprint": "string",
"markup": "0.01",
"locale": "en"
}'
Beispielantwort (200)
{
"orderId": 9876,
"deposits": [
{
"createdAt": "2025-08-26T10:08:06.203Z",
"instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"amount": "3300",
"depositAddress": "0xdeadc0de",
"txId": null,
"isPending": true
}
],
"withdrawals": [],
"pair": {
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo": { "currencyTitle": "LTC", "networkTitle": "LTC" }
},
"rateMode": "FLOATING",
"userEmail": "test@example.com",
"status": "CREATED",
"createdAt": "2025-08-26T10:08:06.203Z"
}
Antworten
| Code | Beschreibung |
|---|---|
200 OK |
Order erfolgreich erstellt; das Order-Objekt wird zurückgegeben. |
401 Unauthorized |
B2B-Bearer-Token oder access_token-Cookie fehlt oder ist ungültig. |
422 Unprocessable Entity |
Validierungsfehler in den Eingabedaten (z. B. Betrag zu klein). |
501 |
Serverfehler („data is not iterable“). |
Hinweise
- Es wird empfohlen, den Kurs zuerst mit
/api/v1/rates/public/oneabzurufen, bevor eine Order erstellt wird.- Wenn
rateMode=FIXEDangegeben ist, wird der Kurs für eine begrenzte Zeit fixiert.- Die Parameter
referrerIdundmarkupAffiliateIdwerden für Affiliate-Integrationen verwendet.- Die Antwort kann leere
withdrawals-Arrays enthalten, wenn noch keine Gelder gesendet wurden.
Erstellt eine neue Tausch-Order.
Die Methode akzeptiert Parameter für das Handelspaar (Sende- und Empfangswährung), Betrag, Benutzeradressen sowie zusätzliche Daten
(Kurs, Gebühren, Affiliate-Parameter). In der Antwort wird ein Order-Objekt mit Details zu Ein- und Auszahlungen zurückgegeben.
URL
https://quickex.io/api/v1/orders/public/create
Authentifizierung
- Der Header
B2B-Bearer-Tokenist für B2B-Integrationen erforderlich (Beispiel:-H "B2B-Bearer-Token: TOKEN"). - Für Nutzerszenarien kann
access_tokenals Cookie verwendet werden.
Header
Accept: application/jsonContent-Type: application/jsonB2B-Bearer-Token: <TOKEN>
Anfragetext (JSON)
{
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo": { "currencyTitle": "LTC", "networkTitle": "LTC" },
"destinationAddress": "MWYK4uQXFvWc1Bj1CPACyX5HTQxUUpRZ2e",
"refundAddress": "TFe5tdqSy8CMGMDVHPJHLTK8hrAL6ddUpD",
"claimedDepositAmount": "3300",
"claimedPublicRate": {
"price": "0.014271620139287839394",
"updatedAt": "2024-02-13T14:43:12.983Z",
"claimedAmountToReceive": "47.09634645964987"
},
"claimedNetworkFee": "0.001",
"userEmail": "test@example.com",
"referrerId": "aff_some-affiliate-id",
"markupAffiliateId": "aff_some-affiliate-id",
"rateMode": "FLOATING",
"browserFingerprint": "string",
"markup": "0.01",
"locale": "en"
}
Beispielanfrage (cURL)
curl -X POST \
'https://quickex.io/api/v1/orders/public/create' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'B2B-Bearer-Token: YOUR TOKEN' \
-d '{
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo": { "currencyTitle": "LTC", "networkTitle": "LTC" },
"destinationAddress": "MWYK4uQXFvWc1Bj1CPACyX5HTQxUUpRZ2e",
"refundAddress": "TFe5tdqSy8CMGMDVHPJHLTK8hrAL6ddUpD",
"claimedDepositAmount": "3300",
"claimedPublicRate": {
"price": "0.014271620139287839394",
"updatedAt": "2024-02-13T14:43:12.983Z",
"claimedAmountToReceive": "47.09634645964987"
},
"claimedNetworkFee": "0.001",
"userEmail": "test@example.com",
"rateMode": "FLOATING",
"browserFingerprint": "string",
"markup": "0.01",
"locale": "en"
}'
Beispielantwort (200)
{
"orderId": 9876,
"deposits": [
{
"createdAt": "2025-08-26T10:08:06.203Z",
"instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"amount": "3300",
"depositAddress": "0xdeadc0de",
"txId": null,
"isPending": true
}
],
"withdrawals": [],
"pair": {
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo": { "currencyTitle": "LTC", "networkTitle": "LTC" }
},
"rateMode": "FLOATING",
"userEmail": "test@example.com",
"status": "CREATED",
"createdAt": "2025-08-26T10:08:06.203Z"
}
Antworten
| Code | Beschreibung |
|---|---|
200 OK |
Order erfolgreich erstellt; das Order-Objekt wird zurückgegeben. |
401 Unauthorized |
B2B-Bearer-Token oder access_token-Cookie fehlt oder ist ungültig. |
422 Unprocessable Entity |
Validierungsfehler in den Eingabedaten (z. B. Betrag zu klein). |
501 |
Serverfehler („data is not iterable“). |
Hinweise
- Es wird empfohlen, den Kurs zuerst mit
/api/v1/rates/public/oneabzurufen, bevor eine Order erstellt wird.- Wenn
rateMode=FIXEDangegeben ist, wird der Kurs für eine begrenzte Zeit fixiert.- Die Parameter
referrerIdundmarkupAffiliateIdwerden für Affiliate-Integrationen verwendet.- Die Antwort kann leere
withdrawals-Arrays enthalten, wenn noch keine Gelder gesendet wurden.
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v1/orders/public/create' \
-H 'accept: application/json' \
-H 'B2B-Bearer-Token: {'JWToken'}' \
-H 'Content-Type: application/json' \
-d '{
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"instrumentTo": {
"currencyTitle": "LTC",
"networkTitle": "LTC"
},
"destinationAddress": "MWYK4uQXFvWc1Bj1CPACyX5HTQxUUpRZ2e",
"destinationAddressMemo": null,
"refundAddress": "TFe5tdqSy8CMGMDVHPJHLTK8hrAL6ddUpD",
"refundAddressMemo": null,
"claimedDepositAmount": "3300",
"claimedPublicRate": {
"price": "0.014271620139287839394",
"updatedAt": "2024-02-13T14:43:12.983Z",
"claimedAmountToReceive": "47.09634645964987"
},
"claimedNetworkFee": "0.001",
"userEmail": "test@example.com",
"legacyOrderId": null,
"referrerId": "aff_some-affiliate-id",
"markupAffiliateId": "aff_some-affiliate-id",
"rateMode": "FLOATING",
"utmData": {},
"browserFingerprint": "string",
"markup": "0.01",
"mercuryoBearerToken": "string",
"locale": "string"
}'Response Example
{
"deposits": [
{
"createdAt": "2025-11-21T09:26:08.476Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true,
"id": 0,
"counterPartyAddress": "0xdeadc0dedeadbeef"
}
],
"withdrawals": [
{
"createdAt": "2025-11-21T09:26:08.476Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"networkFee": "1.1",
"txId": "0xdeadc0dedeadbeef"
}
],
"depositAddress": {
"orderId": 0,
"liquidityProviderTitle": "QUICKEX_BUSINESS_ACCOUNT",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"depositAddress": "0xdeadc0de",
"depositAddressMemo": "string",
"redirectUrl": "string"
},
"orderId": 0,
"userId": 0,
"legacyOrderId": "string",
"pair": {
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
}
},
"createdAt": "2025-11-21T09:26:08.476Z",
"claimedDepositAmount": "10.01",
"amountToGet": "10.01",
"claimedPublicRate": {
"price": "1000.1",
"quotes": {
"sellQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
},
"buyQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
}
},
"updatedAt": "2025-11-21T09:26:08.476Z",
"liquidityProviderPublicCode": "formulae",
"claimedAmountToReceive": "0.01",
"finalNetworkFeeAmount": "0.01",
"platformFee_Absolute": "0.01",
"fixedRate_maxAmount": "1000.000",
"fixedRate_maxTimeMinutes": 1,
"fixedRate_maxRateVolatilityPercent": "1000.000"
},
"claimedNetworkFee": "10.01",
"KYCFormLink": "string",
"orderEvents": [
{
"kind": "TRACKING_STARTED",
"createdAt": "2025-11-21T09:26:08.476Z"
}
],
"userEmail": "test@example.com",
"rateMode": "FLOATING",
"destinationAddress": "0xdeadbeef",
"destinationAddressMemo": "0xdeadbeef",
"completed": false,
"possibleCashbackAmountUSDT": "500.00",
"redirectUrl": "https://payments.mercuryo.io/",
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}Try it out
Leave empty to use default