Team Quickex
17. November 2025
~1 Mindestlesezeit
Der Abschnitt orders enthält Methoden zum Erstellen einer Order sowie zum Hinzufügen der E-Mail-Adresse eines Nutzers zu einer bereits bestehenden Order. Mit den verfügbaren Methoden können Sie einen Umtausch durch das Anlegen einer Order starten und außerdem eine E-Mail-Adresse für Benachrichtigungen über den Status der Order hinzufügen.
POST
orders/public/set-email
Endpoint URL
https://quickex.io/api/v2/orders/public/set-email
Documentation
Allgemeine Beschreibung
Dieser Endpoint ermöglicht es, die E-Mail-Adresse eines Nutzers mit einem bereits erstellten Auftrag (Order) zu verknüpfen. Nachdem diese Methode aufgerufen wurde, wird das Feld userEmail im Auftrag auf die angegebene Adresse gesetzt, und Benachrichtigungen über Statusänderungen der Transaktion werden an diese E-Mail gesendet.
Parameter
Header
| Name | Erforderlich | Beschreibung |
|---|---|---|
X-Api-Public-Key |
ja | Dein öffentlicher API-Schlüssel zur Authentifizierung der Anfrage. |
X-Api-Timestamp |
ja | UNIX-Zeitstempel (ms). Wird verwendet, um Replay-Angriffe zu verhindern. |
X-Api-Signature |
ja | HMAC-Signatur des gesamten Anfragekörpers, generiert mit deinem geheimen Schlüssel. |
Anfragekörper (JSON)
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
orderId |
number | ja | Die ID des bestehenden Auftrags. |
userEmail |
string | ja | Die E-Mail-Adresse für Benachrichtigungen. |
Beispielanfrage
curl -X POST 'https://quickex.io/api/v2/orders/public/set-email' \ -H 'accept: application/json' \ -H 'Content-Type: application/json' \ -H 'X-Api-Public-Key: yourPublicKey' \ -H 'X-Api-Timestamp: 1691397292905' \ -H 'X-Api-Signature: yourHmacSignature' \ -d '{ "orderId": 12345, "userEmail": "user@example.com" }' Mögliche Antworten
200 OK — E-Mail erfolgreich hinzugefügt. 403 ERR_FORBIDDEN — erforderliche Header fehlen oder Signatur ungültig:
{ "status": "ERR_FORBIDDEN", "message": "Header params is missed!" } Anwendungsfall
Ein Integrationspartner bindet Quickex in seine Anwendung ein und möchte E-Mail-Benachrichtigungen nach der Auftragserstellung automatisch aktivieren:
- Der Kunde erstellt einen Auftrag über
/api/v2/orders/public/create. - Sobald die
orderIdzurückgegeben wird, ruft das System/api/v2/orders/public/set-emailauf, um die E-Mail hinzuzufügen. - Wenn Gelder eingezahlt oder ausgezahlt werden, sendet Quickex Benachrichtigungen an die angegebene
userEmail.
Code Sample
curl -X 'GET' \
'https://quickex.io/api/v2/orders?order=asc' \
-H 'accept: application/json' \
-H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
-H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
-H 'X-Api-Signature: {SIGNATURE}' \Response Example
[
{
"orderId": 2096,
"destinationAddress": "rMZiLhMHDKHSD9mMurzvixQGKFsDNLLP1",
"createdAt": "2024-11-21T09:57:37.536Z",
"updatedAt": "2024-11-21T09:57:37.536Z",
"destinationAddressMemo": null,
"refundAddress": null,
"refundAddressMemo": null,
"claimedDepositAmount": "11905.4",
"claimedNetworkFee": "0.25",
"amountToGet": "2000.535980286546",
"amountToGetUSDT": "0",
"amountToWithdrawFact": "0",
"amountToWithdrawFactUSDT": "0",
"instrumentFromCurrencyTitle": "TRX",
"instrumentFromNetworkTitle": "TRX",
"instrumentToCurrencyTitle": "XRP",
"instrumentToNetworkTitle": "XRP",
"ip": "165.22.73.162",
"geoCode": "DE",
"markup": "0",
"userEmail": "qa@support.quickex.io",
"completed": false,
"state": "created"
},
{
"orderId": 2097,
"destinationAddress": "rMZiLhMHDKHSD9mMurzvixQGKFsDNLLP1",
"createdAt": "2024-11-21T09:57:56.849Z",
"updatedAt": "2024-11-21T09:57:56.849Z",
"destinationAddressMemo": null,
"refundAddress": null,
"refundAddressMemo": null,
"claimedDepositAmount": "500",
"claimedNetworkFee": "0.25",
"amountToGet": "88.201060256891",
"amountToGetUSDT": "0",
"amountToWithdrawFact": "0",
"amountToWithdrawFactUSDT": "0",
"instrumentFromCurrencyTitle": "TRX",
"instrumentFromNetworkTitle": "TRX",
"instrumentToCurrencyTitle": "XRP",
"instrumentToNetworkTitle": "XRP",
"ip": "165.22.73.162",
"geoCode": "DE",
"markup": "0",
"userEmail": "qa@support.quickex.io",
"completed": false,
"state": "created"
},
{
"orderId": 3038,
"destinationAddress": "TFjfHBiDcL6B5S5W8g9b6gU2tbvnTR52ya",
"createdAt": "2025-04-28T13:15:03.006Z",
"updatedAt": "2025-07-22T10:36:58.557Z",
"destinationAddressMemo": null,
"refundAddress": null,
"refundAddressMemo": null,
"claimedDepositAmount": "0.034268",
"claimedNetworkFee": "1.5",
"amountToGet": "3263.05",
"amountToGetUSDT": "3263.058154",
"amountToWithdrawFact": "0",
"amountToWithdrawFactUSDT": "0",
"instrumentFromCurrencyTitle": "BTC",
"instrumentFromNetworkTitle": "BTC",
"instrumentToCurrencyTitle": "USDT",
"instrumentToNetworkTitle": "TRC20",
"ip": "45.76.90.73",
"geoCode": "DE",
"markup": "0",
"userEmail": "qa@support.quickex.io",
"completed": false,
"state": "created"
},
{
"orderId": 3172,
"destinationAddress": "TPjT9p6UK5omA19h1QuYf4HbWvB9CukMzx",
"createdAt": "2025-11-25T07:52:52.871Z",
"updatedAt": "2025-11-27T11:34:19.690Z",
"destinationAddressMemo": null,
"refundAddress": null,
"refundAddressMemo": null,
"claimedDepositAmount": "52",
"claimedNetworkFee": "2.054188275293",
"amountToGet": "419.2",
"amountToGetUSDT": "114.402051690569",
"amountToWithdrawFact": "417.825363",
"amountToWithdrawFactUSDT": "114.0245415627",
"instrumentFromCurrencyTitle": "XRP",
"instrumentFromNetworkTitle": "XRP",
"instrumentToCurrencyTitle": "TRX",
"instrumentToNetworkTitle": "TRX",
"ip": "77.246.100.22",
"geoCode": "NL",
"markup": "0",
"userEmail": "qa@support.quickex.io",
"completed": true,
"state": "withdraw"
},
{
"orderId": 3192,
"destinationAddress": "15vvDFQFksUS4r1cYxmjZuTVVUzWZSJauuUapg7Xjhgtkwqy",
"createdAt": "2025-12-02T14:11:15.985Z",
"updatedAt": "2025-12-02T14:11:16.107Z",
"destinationAddressMemo": null,
"refundAddress": "UQCGxjLy3msAFWG4r310Sk_rOz27QWRy252fdLMWJAMQJvSE",
"refundAddressMemo": null,
"claimedDepositAmount": "3300",
"claimedNetworkFee": "0.14",
"amountToGet": "2363.663",
"amountToGetUSDT": "4999.384629917638",
"amountToWithdrawFact": "0",
"amountToWithdrawFactUSDT": "0",
"instrumentFromCurrencyTitle": "TON",
"instrumentFromNetworkTitle": "TON",
"instrumentToCurrencyTitle": "DOT",
"instrumentToNetworkTitle": "DOT",
"ip": "77.246.100.22",
"geoCode": "NL",
"markup": "0",
"userEmail": null,
"completed": false,
"state": "created"
},
{
"orderId": 3193,
"destinationAddress": "15vvDFQFksUS4r1cYxmjZuTVVUzWZSJauuUapg7Xjhgtkwqy",
"createdAt": "2025-12-02T14:14:34.356Z",
"updatedAt": "2025-12-02T14:14:34.557Z",
"destinationAddressMemo": null,
"refundAddress": "UQCGxjLy3msAFWG4r310Sk_rOz27QWRy252fdLMWJAMQJvSE",
"refundAddressMemo": null,
"claimedDepositAmount": "73",
"claimedNetworkFee": "0.14",
"amountToGet": "52.235",
"amountToGetUSDT": "110.556162356583",
"amountToWithdrawFact": "0",
"amountToWithdrawFactUSDT": "0",
"instrumentFromCurrencyTitle": "TON",
"instrumentFromNetworkTitle": "TON",
"instrumentToCurrencyTitle": "DOT",
"instrumentToNetworkTitle": "DOT",
"ip": "77.246.100.22",
"geoCode": "NL",
"markup": "0",
"userEmail": null,
"completed": false,
"state": "created"
}
]Try it out
Leave empty to use default
Query Parameters
Request Body
Headers
POST
orders/public/create
Endpoint URL
https://quickex.io/api/v2/orders/public/create
Documentation
Allgemeine Beschreibung
Dieser Endpoint wird verwendet, um eine neue Order für den Kryptowährungsumtausch zu erstellen. Er gibt vollständige Informationen über die Order zurück: Einzahlungs- und Auszahlungsadressen, Kursparameter, Ereignisse und URLs für die weitere Verarbeitung.
Parameter
Headers
| Name | Erforderlich | Beschreibung |
|---|---|---|
X-Api-Public-Key |
ja | Ihr öffentlicher API-Schlüssel. |
X-Api-Timestamp |
ja | UNIX-Zeitstempel (ms). |
X-Api-Signature |
ja | HMAC-Signatur des Request-Bodys, erstellt mit Ihrem geheimen Schlüssel. |
Anfragetext (JSON)
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
instrumentFrom |
object | ja | Quellwährung und -netzwerk (currencyTitle / networkTitle). |
instrumentTo |
object | ja | Zielwährung und -netzwerk. |
destinationAddress |
string | ja | Adresse zum Empfang der umgetauschten Mittel. |
destinationAddressMemo |
string | nein | Optionales Memo/Tag für die Zieladresse. |
refundAddress |
string | ja | Adresse für Rückerstattungen im Falle eines Fehlers. |
refundAddressMemo |
string | nein | Memo/Tag für die Rückerstattungsadresse. |
claimedDepositAmount |
string | ja | Betrag, den der Benutzer einzuzahlen beabsichtigt. |
claimedPublicRate |
object | nein | Informationen zum angegebenen Kurs: Preis, Aktualisierungszeit und erwarteter Empfangsbetrag. |
claimedNetworkFee |
string | nein | Angegebene Netzwerkgebühr. |
userEmail |
string | nein | E-Mail für Benachrichtigungen. |
legacyOrderId |
string | nein | Externe Order-ID aus einem Altsystem. |
referrerId |
string | nein | Referrer-ID für das Affiliate-Programm. |
markupAffiliateId |
string | nein | Affiliate-ID für die Verteilung des Markups. |
rateMode |
string | nein | Kurstyp: FLOATING oder FIXED. |
utmData |
object | nein | UTM-Parameter für Analysen. |
browserFingerprint |
string | nein | Browser-Fingerabdruck für Betrugsschutz. |
markup |
string | nein | Markup-Prozentsatz. |
mercuryoBearerToken |
string | nein | Mercuryo-Token für optionale Integration. |
locale |
string | nein | Antwortsprache (z. B. en, ru). |
Beispielanfrage
curl -X POST 'https://quickex.io/api/v2/orders/public/create' \
-H 'accept: application/json' \
-H 'X-Api-Public-Key: yourPublicKey' \
-H 'X-Api-Timestamp: 1691397873000' \
-H 'X-Api-Signature: yourHmacSignature' \
-H 'Content-Type: application/json' \
-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",
"referrerId": "aff_some-affiliate-id",
"markupAffiliateId": "aff_some-affiliate-id",
"rateMode": "FLOATING",
"markup": "0.01",
"mercuryoBearerToken": "string",
"locale": "ru"
}'
Mögliche Antworten
200 OK — Order erfolgreich erstellt; vollständiges Orderobjekt wird zurückgegeben.
401 ERR_UNAUTHORIZED — fehlende oder ungültige Tokens/Schlüssel:
{
"status": "ERR_UNAUTHORIZED",
"message": "Unauthorized"
}
Anwendungsfall
Eine Partnerplattform möchte Orders automatisch erstellen, wenn ein Benutzer über Mercuryo bezahlt.
Nach der Authentifizierung stellt Mercuryo ein B2B-Bearer-Token bereit, anschließend erstellt die Plattform die Austauschinhalte und ruft diesen Endpoint auf, um die Order bei Quickex zu erzeugen.
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v2/orders/public/create' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
-H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
-H 'X-Api-Signature: {SIGNATURE}' \
-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",
"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-12-02T08:52:08.178Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true,
"id": 0,
"counterPartyAddress": "0xdeadc0dedeadbeef"
}
],
"withdrawals": [
{
"createdAt": "2025-12-02T08:52:08.178Z",
"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-12-02T08:52:08.179Z",
"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-12-02T08:52:08.179Z",
"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-12-02T08:52:08.179Z"
}
],
"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
Request Body
Headers
POST
orders/public/set-email
Endpoint URL Fill in path parameters
https://quickex.io<h2 style="margin-top: 28px;">Überblick</h2> <div style="border: 1px solid #ccc; padding: 18px; border-radius: 6px; margin-bottom: 22px;"> Diese Methode gibt detaillierte Informationen zu einer bestimmten Order anhand ihrer <code>orderId</code> zurück. Im Gegensatz zur Order-Liste (<code>GET /api/v2/orders</code>) liefert sie alle Daten, die mit der ausgewählten Order verknüpft sind: das vollständige Instrumentenpaar mit Parametern, den fixierten Kurs (<code>claimedPublicRate</code>), Bestätigungs-Limits, die Ereignishistorie (<code>orderEvents</code>), die Einzahlungsadresse sowie Informationen zu möglichem Cashback/Referral-Gutschriften und zum Abschlussstatus. Der Zugriff auf Orders ist durch den aktuellen API-Key eingeschränkt: Sie können nur Orders sehen, die unter Verwendung Ihres <code>X-Api-Public-Key</code> erstellt wurden. </div> <div style="border: 1px solid #ccc; padding: 18px; border-radius: 6px; margin-bottom: 22px;"> <h2 style="margin-top: 28px;">HTTP-Anfrage</h2> <strong>Methode:</strong> <code>GET</code> <strong>URL:</strong> <code>https://quickex.io/api/v2/orders/public-info</code> </div> <div style="border: 1px solid #ccc; padding: 18px; border-radius: 6px; margin-bottom: 22px;"> <h3>Anfragebeispiel</h3> <pre style="border-left: 4px solid #444; padding: 12px; white-space: pre-wrap; font-family: monospace;">curl -X 'GET' \ 'https://quickex.io/api/v2/orders/public-info?orderId=3038' \ -H 'accept: application/json' \ -H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \ -H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \ -H 'X-Api-Signature: {SIGNATURE}'</pre> <h2>Header</h2> <table style="width: 100%; border-collapse: collapse; margin-top: 10px;"> <thead> <tr> <th style="border: 1px solid #ccc; padding: 8px;">Header</th> <th style="border: 1px solid #ccc; padding: 8px;">Erforderlich</th> <th style="border: 1px solid #ccc; padding: 8px;">Beschreibung</th> </tr> </thead> <tbody> <tr> <td style="border: 1px solid #ccc; padding: 8px;">Accept</td> <td style="border: 1px solid #ccc; padding: 8px;">ja</td> <td style="border: 1px solid #ccc; padding: 8px;">Empfohlener Wert: <code>application/json</code>.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">X-Api-Public-Key</td> <td style="border: 1px solid #ccc; padding: 8px;">ja</td> <td style="border: 1px solid #ccc; padding: 8px;">Ihr öffentlicher API-Schlüssel.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">X-Api-Timestamp</td> <td style="border: 1px solid #ccc; padding: 8px;">ja</td> <td style="border: 1px solid #ccc; padding: 8px;">Zeitstempel (in der Regel UNIX in ms), der in die Signatur eingeht.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">X-Api-Signature</td> <td style="border: 1px solid #ccc; padding: 8px;">ja</td> <td style="border: 1px solid #ccc; padding: 8px;">Anfrage-Signatur (HMAC SHA256 gemäß API-v2-Schema).</td> </tr> </tbody> </table> <h2>Anfrageparameter</h2> <h3>Query-Parameter</h3> <table style="width: 100%; border-collapse: collapse; margin-top: 10px;"> <thead> <tr> <th style="border: 1px solid #ccc; padding: 8px;">Parameter</th> <th style="border: 1px solid #ccc; padding: 8px;">Typ</th> <th style="border: 1px solid #ccc; padding: 8px;">Erforderlich</th> <th style="border: 1px solid #ccc; padding: 8px;">Beschreibung</th> </tr> </thead> <tbody> <tr> <td style="border: 1px solid #ccc; padding: 8px;">orderId</td> <td style="border: 1px solid #ccc; padding: 8px;">int</td> <td style="border: 1px solid #ccc; padding: 8px;">ja</td> <td style="border: 1px solid #ccc; padding: 8px;">Die Order-ID, zu der Informationen angefordert werden.</td> </tr> </tbody> </table> </div> <h2>Antwortformat</h2> <div style="border: 1px solid #ccc; padding: 18px; border-radius: 6px; margin-bottom: 22px;"> Die Methode gibt ein <strong>JSON-Objekt</strong> mit vollständigen Informationen zur Order zurück. <h3 style="margin-top: 20px;">Antwortbeispiel</h3> <pre style="border-left: 4px solid #444; padding: 12px; white-space: pre-wrap; font-family: monospace;">{ "orderId": 174059, "legacyOrderId": "602184da-5881-408e-bffa-3562702d7d3e", "pair": { "instrumentFrom": { "currencyTitle": "XRP", "networkTitle": "XRP", "precisionDecimals": 2, "slug": "xrp", "liquidityProviderCurrencies": [ { "minConfirmationsToTrade": 12, "minConfirmationsToWithdraw": 12 } ] }, "instrumentTo": { "currencyTitle": "TRX", "networkTitle": "TRX", "precisionDecimals": 2, "slug": "trx", "liquidityProviderCurrencies": [ { "minConfirmationsToTrade": 3, "minConfirmationsToWithdraw": 3 } ] } }, "createdAt": "2025-12-15T14:38:40.523Z", "instrumentFromCurrencyTitle": "XRP", "instrumentFromNetworkTitle": "XRP", "instrumentToCurrencyTitle": "TRX", "instrumentToNetworkTitle": "TRX", "feeMode": "FIXED", "userId": 2382, "userEmail": "sam.white@support.example.io", "isPlatformEmail": false, "refundAddress": "rNFSruW9B1NwVoGgUMmfwXbruWMp8Mgv3K", "refundAddressMemo": null, "destinationAddress": "TWRW8YiZtjW7JkYxxzuPrN9fQzoDK5FHgm", "destinationAddressMemo": null, "claimedNetworkFee": "1.987665024814", "rateMode": "FIXED", "claimedDepositAmount": "57", "amountToGet": "393.07", "platformFee": "3.86", "redirectUrl": null, "orderEvents": [ { "createdAt": "2025-12-15T14:42:43.317Z", "kind": "WITHDRAWAL_COMPLETED" }, { "createdAt": "2025-12-15T14:41:54.109Z", "kind": "FUNDS_WITHDRAWAL_START" }, { "createdAt": "2025-12-15T14:41:00.379Z", "kind": "DEPOSIT_REGISTERED" }, { "createdAt": "2025-12-15T14:39:58.760Z", "kind": "INCOMING_FUNDS_DETECTED" }, { "createdAt": "2025-12-15T14:38:41.642Z", "kind": "CREATION_END" } ], "depositAddress": { "instrument": { "currencyTitle": "XRP", "networkTitle": "XRP" }, "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK", "depositAddressMemo": "2097040307" }, "deposits": [ { "id": 50958, "counterPartyAddress": null, "createdAt": "2025-12-15T14:39:45.000Z", "instrument": { "currencyTitle": "XRP", "networkTitle": "XRP" }, "amount": "57", "amountUSDT": "112.40742", "txId": "DEA15CCF7AF04799A090298CB06D78DD177B3B518BED9C9DE8A0A5B717CCDBE7", "confirmations": 12, "depositAddress": { "instrument": { "currencyTitle": "XRP", "networkTitle": "XRP" }, "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK", "depositAddressMemo": "2097040307" }, "isPending": false } ], "withdrawals": [ { "instrument": { "currencyTitle": "TRX", "networkTitle": "TRC20" }, "amount": "393.07", "txId": "39dc5802a931da0613f687087397e812dd6c0aa0b9041124d76e864e37bd1e09", "createdAt": "2025-12-15T14:41:58.926Z", "networkFee": "1.98" } ], "KYCFormLink": null, "liquidityProviderPublicCode": "hat", "possibleRefferalAccrualAmount": "0.78", "possibleCashbackAmountUSDT": "0.22", "actualCashbackAmountUSDT": "0.22", "claimedPublicRate": { "claimedAmountToReceive": "393.07", "finalNetworkFeeAmount": "1.9876650248138958", "platformFee_Absolute": null, "price": "7.000992555831266", "quotes": { "sellQuote": { "baseValue": "0.2821", "quoteValue": "1.9453930016929823" }, "buyQuote": { "baseValue": "1.97499", "quoteValue": "0.2777753832835882" } }, "updatedAt": "2025-12-15T14:38:36.201Z", "instrumentFrom": { "currencyTitle": "XRP", "networkTitle": "XRP", "precisionDecimals": 2, "slug": "xrp", "liquidityProviderCurrencies": [ { "minConfirmationsToTrade": 12, "minConfirmationsToWithdraw": 12 } ] }, "instrumentTo": { "currencyTitle": "TRX", "networkTitle": "TRX", "precisionDecimals": 2, "slug": "trx", "liquidityProviderCurrencies": [ { "minConfirmationsToTrade": 3, "minConfirmationsToWithdraw": 3 } ] } }, "completed": true, "minConfirmationsToTrade": 12, "minConfirmationsToWithdraw": 12 } </pre> </div> <div style="border: 1px solid #ccc; padding: 18px; border-radius: 6px; margin-bottom: 22px;"> <h2 style="margin-top: 28px;">Feldbeschreibung der Antwort</h2> Unten sind die wichtigsten Felder der Antwort aufgeführt. Einige verschachtelte Strukturen (z. B. <code>instrumentFrom</code> / <code>instrumentTo</code>) sind strukturell ähnlich zu Objekten aus den Methoden <code>/instruments</code> und <code>/rates</code>. <h3>Allgemeine Informationen zur Order</h3> <table style="width: 100%; border-collapse: collapse; margin-top: 10px;"> <thead> <tr> <th style="border: 1px solid #ccc; padding: 8px;">Feld</th> <th style="border: 1px solid #ccc; padding: 8px;">Typ</th> <th style="border: 1px solid #ccc; padding: 8px;">Beschreibung</th> </tr> </thead> <tbody> <tr> <td style="border: 1px solid #ccc; padding: 8px;">orderId</td> <td style="border: 1px solid #ccc; padding: 8px;">number</td> <td style="border: 1px solid #ccc; padding: 8px;">Eindeutige Order-ID im Quickex-System.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">legacyOrderId</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Order-ID im Legacy-System (falls für Migration/Kompatibilität verwendet).</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">createdAt</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Zeitpunkt der Order-Erstellung (ISO8601).</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentFromCurrencyTitle</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Code der Ausgangswährung (z. B. <code>BTC</code>).</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentFromNetworkTitle</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Ausgangsnetzwerk (z. B. <code>BTC</code>).</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentToCurrencyTitle</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Code der Zielwährung (z. B. <code>USDT</code>).</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentToNetworkTitle</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Zielnetzwerk (z. B. <code>TRC20</code>).</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">feeMode</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Gebührenmodus der Order: • <code data-start="176" data-end="186">FLOATING</code> – die Gebühr kann sich je nach Netzwerkbedingungen oder Markttyp ändern. • <code data-start="262" data-end="269">FIXED</code> – die Gebühr wird beim Erstellen der Order fixiert.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">rateMode</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Kursmodus: • <code data-start="373" data-end="380">FIXED</code> – der Kurs wird beim Erstellen der Order fixiert; der Auszahlungsbetrag ändert sich nicht. • <code data-start="474" data-end="484">FLOATING</code> – der Kurs kann bis zum Abschluss der Order schwanken; der Auszahlungsbetrag wird entsprechend den aktuellen Marktbedingungen aktualisiert.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">claimedDepositAmount</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Einzahlungsbetrag, der beim Erstellen der Order verwendet wurde.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">amountToGet</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Betrag, den der Nutzer für diese Order erhalten soll.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">claimedNetworkFee</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Netzwerkgebühr, die in der Order-Berechnung berücksichtigt wurde.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">platformFee</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Plattformgebühr.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">redirectUrl</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">URL für Redirect zu einem externen Service.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">completed</td> <td style="border: 1px solid #ccc; padding: 8px;">boolean</td> <td style="border: 1px solid #ccc; padding: 8px;">Abschluss-Flag der Order: <code>true</code> — Tausch abgeschlossen, <code>false</code> — in Bearbeitung.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">minConfirmationsToTrade</td> <td style="border: 1px solid #ccc; padding: 8px;">number</td> <td style="border: 1px solid #ccc; padding: 8px;">Minimale Bestätigungen, damit die Einzahlung als für den Tausch verfügbar gilt.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">minConfirmationsToWithdraw</td> <td style="border: 1px solid #ccc; padding: 8px;">number</td> <td style="border: 1px solid #ccc; padding: 8px;">Minimale Bestätigungen, die für die Auszahlung erforderlich sind.</td> </tr> </tbody> </table> <h3 style="margin-top: 20px;">Instrumentenpaar (pair)</h3> <pre style="border-left: 4px solid #444; padding: 12px; white-space: pre-wrap; font-family: monospace;"> "pair": { "instrumentFrom": { "currencyTitle": "XRP", "networkTitle": "XRP", "precisionDecimals": 2, "slug": "xrp", "liquidityProviderCurrencies": [ { "minConfirmationsToTrade": 12, "minConfirmationsToWithdraw": 12 } ] }, "instrumentTo": { "currencyTitle": "TRX", "networkTitle": "TRX", "precisionDecimals": 2, "slug": "trx", "liquidityProviderCurrencies": [ { "minConfirmationsToTrade": 3, "minConfirmationsToWithdraw": 3 } ] } }, </pre> <table style="width: 100%; border-collapse: collapse; border: 1px solid #ccc;"> <thead> <tr> <th style="border: 1px solid #ccc; padding: 8px;">Feld</th> <th style="border: 1px solid #ccc; padding: 8px;">Typ</th> <th style="border: 1px solid #ccc; padding: 8px;">Beschreibung</th> </tr> </thead> <tbody> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentFrom</td> <td style="border: 1px solid #ccc; padding: 8px;">object</td> <td style="border: 1px solid #ccc; padding: 8px;">Ausgangsinstrument: die Währung, die der Nutzer sendet.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentFrom.currencyTitle</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Währungscode des Ausgangsinstruments (z. B. XRP).</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentFrom.networkTitle</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Blockchain-Netzwerk des Ausgangsinstruments.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentFrom.precisionDecimals</td> <td style="border: 1px solid #ccc; padding: 8px;">number</td> <td style="border: 1px solid #ccc; padding: 8px;">Anzahl unterstützter Nachkommastellen für Beträge.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentFrom.slug</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Interner Bezeichner der Währung.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentFrom.liquidityProviderCurrencies</td> <td style="border: 1px solid #ccc; padding: 8px;">array</td> <td style="border: 1px solid #ccc; padding: 8px;">Einstellungen des Liquiditätsanbieters für diese Währung und dieses Netzwerk.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentFrom.liquidityProviderCurrencies.minConfirmationsToTrade</td> <td style="border: 1px solid #ccc; padding: 8px;">number</td> <td style="border: 1px solid #ccc; padding: 8px;">Minimale Bestätigungen, um die Einzahlung im Tausch zu verwenden.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentFrom.liquidityProviderCurrencies.minConfirmationsToWithdraw</td> <td style="border: 1px solid #ccc; padding: 8px;">number</td> <td style="border: 1px solid #ccc; padding: 8px;">Minimale Bestätigungen, bevor eine Auszahlung erlaubt wird.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentTo</td> <td style="border: 1px solid #ccc; padding: 8px;">object</td> <td style="border: 1px solid #ccc; padding: 8px;">Zielinstrument: die Währung, die der Nutzer erhält.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentTo.currencyTitle</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Währungscode des Zielinstruments (z. B. TRX).</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentTo.networkTitle</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Blockchain-Netzwerk des Zielinstruments.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentTo.precisionDecimals</td> <td style="border: 1px solid #ccc; padding: 8px;">number</td> <td style="border: 1px solid #ccc; padding: 8px;">Anzahl unterstützter Nachkommastellen für Beträge.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentTo.slug</td> <td style="border: 1px solid #ccc; padding: 8px;">string</td> <td style="border: 1px solid #ccc; padding: 8px;">Interner Bezeichner der Währung.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentTo.liquidityProviderCurrencies</td> <td style="border: 1px solid #ccc; padding: 8px;">array</td> <td style="border: 1px solid #ccc; padding: 8px;">Einstellungen des Liquiditätsanbieters für diese Währung und dieses Netzwerk.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentTo.liquidityProviderCurrencies.minConfirmationsToTrade</td> <td style="border: 1px solid #ccc; padding: 8px;">number</td> <td style="border: 1px solid #ccc; padding: 8px;">Minimale Bestätigungen, bevor die Mittel getauscht werden können.</td> </tr> <tr> <td style="border: 1px solid #ccc; padding: 8px;">instrumentTo.liquidityProviderCurrencies.minConfirmationsToWithdraw</td> <td style="border: 1px solid #ccc; padding: 8px;">number</td> <td style="border: 1px solid #ccc; padding: 8px;">Minimale Bestätigungen, bevor die Mittel ausgezahlt werden können.</td> </tr> </tbody> </table> </div> <div style="border: 1px solid #ccc; padding: 18px; border-radius: 6px; margin-bottom: 22px;"> <h2>Mögliche Anwendungsfälle</h2> <ul> <li>Abruf vollständiger Details zu einer bestimmten Order, um die komplette Transaktionshistorie, den Status und zugehörige Finanzdaten im Nutzerkonto/Partner-Dashboard anzuzeigen oder für Abgleich- und Audit-Zwecke.</li> </ul> </div>/api/v2/orders/public/set-email
Documentation
Übersicht
Diese Methode ermöglicht es Ihnen, für eine bereits erstellte öffentliche Order eine E-Mail-Adresse zu setzen.
Sie wird verwendet, wenn die Order ohne das Feld userEmail in der Anfrage /api/v2/orders/public/create erstellt wurde, Sie aber später eine E-Mail anhängen müssen (z. B. damit der Nutzer Benachrichtigungen über den Bestellstatus erhalten kann).
> Wichtig: Die E-Mail-Adresse kann nur einmal gesetzt werden. Wenn die Order bereits ein userEmail hat, kann sie über diese Methode nicht geändert werden.
HTTP Request
Methode: POST
URL: https://quickex.io/api/v2/orders/public/set-email
Beispiel für eine Anfrage
curl -X 'POST' \ 'https://quickex.io/api/v2/orders/public/set-email' \ -H 'accept: application/json' \ -H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \ -H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \ -H 'X-Api-Signature: {SIGNATURE}' \ -H 'Content-Type: application/json' \ -d '{ "orderId": 3038, "userEmail": "QA@quickex.com" }'
Headers
| Header | Erforderlich | Beschreibung |
|---|---|---|
Accept |
ja | Empfohlener Wert: application/json. |
Content-Type |
ja | application/json. |
X-Api-Public-Key |
ja | Ihr öffentlicher API-Schlüssel. |
X-Api-Timestamp |
ja | Zeitstempel (normalerweise UNIX in ms), der in die Signatur einbezogen wird. |
X-Api-Signature |
ja | Signatur der Anfrage (HMAC SHA256 gemäß API-v2-Schema). |
Request Parameters
Body-Parameter
{ "orderId": 3038, "userEmail": "QA@quickex.com" }
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
orderId |
number | ja | Die ID der Order, für die Sie die E-Mail festlegen möchten. |
userEmail |
string | ja | Die E-Mail-Adresse des Nutzers, die mit der Order verknüpft wird und für Benachrichtigungen verwendet wird. |
Einschränkungen: Wenn für diese Order bereits ein userEmail gesetzt ist, gibt die Methode einen Fehler 403 ERR_FORBIDDEN zurück.
Response Format
Wenn die Anfrage erfolgreich ist, gibt die Methode ein JSON-Objekt der Order zurück, ähnlich der Antwort von POST /api/v2/orders/public/create / GET /api/v2/orders/info, jedoch mit gesetztem Feld userEmail.
Beispielantwort
{ "deposits": [ { "createdAt": "2025-12-02T09:31:46.246Z", "instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" }, "amount": "1000.1", "confirmations": 0, "txId": "0xdeadc0dedeadbeef", "depositAddress": "0xdeadc0de", "isPending": true, "id": 0, "counterPartyAddress": "0xdeadc0dedeadbeef" } ], "withdrawals": [ { "createdAt": "2025-12-02T09:31:46.246Z", "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-12-02T09:31:46.246Z", "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-12-02T09:31:46.246Z", "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-12-02T09:31:46.246Z" } ], "userEmail": "QA@example.com", "rateMode": "FLOATING", "destinationAddress": "0xdeadbeef", "destinationAddressMemo": "0xdeadbeef", "completed": false, "possibleCashbackAmountUSDT": "500.00", "redirectUrl": "https://payments.mercuryo.io/", "minConfirmationsToTrade": 3, "minConfirmationsToWithdraw": 3 }
Wichtig: Das mit der Order verknüpfte Feld userEmail ist in der Antwort ausgefüllt.
Errors
403 ERR_FORBIDDEN — E-Mail bereits gesetzt
{ "status": "ERR_FORBIDDEN", "message": "Order.userEmail already set and can not be modified" }
Dieser Fehler wird zurückgegeben, wenn Sie versuchen, die E-Mail für eine Order zu ändern, bei der das Feld userEmail bereits gesetzt wurde (entweder während der Ordererstellung oder in einem vorherigen set-email-Aufruf).
Was ist zu tun?
- Die E-Mail-Adresse kann für Orders, die bereits eine E-Mail gesetzt haben, nicht geändert werden.
Mögliche Anwendungsfälle
- Hinzufügen einer E-Mail für anonym erstellte Orders (z. B. über ein Widget, in dem das E-Mail-Feld nicht verpflichtend ist).
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v2/orders/public/set-email' \
-H 'accept: application/json' \
-H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
-H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
-H 'X-Api-Signature: {SIGNATURE}'
-H 'Content-Type: application/json' \
-d '{
"orderId": 3038,
"userEmail": "QA@quickex.com"
}'Response Example
{
"deposits": [
{
"createdAt": "2025-12-02T09:31:46.246Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true,
"id": 0,
"counterPartyAddress": "0xdeadc0dedeadbeef"
}
],
"withdrawals": [
{
"createdAt": "2025-12-02T09:31:46.246Z",
"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-12-02T09:31:46.246Z",
"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-12-02T09:31:46.246Z",
"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-12-02T09:31:46.246Z"
}
],
"userEmail": "QA@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
Request Body
Headers
GET
orders/public-info
Endpoint URL
https://quickex.io/api/v2/orders/public-info
Documentation
Überblick
Diese Methode gibt detaillierte Informationen zu einer bestimmten Order anhand ihrer orderId zurück.
Im Gegensatz zur Order-Liste (GET /api/v2/orders) liefert sie alle Daten, die mit der ausgewählten Order verknüpft sind:
das vollständige Instrumentenpaar mit Parametern, den fixierten Kurs (claimedPublicRate),
Bestätigungs-Limits, die Ereignishistorie (orderEvents), die Einzahlungsadresse
sowie Informationen zu möglichem Cashback/Referral-Gutschriften und zum Abschlussstatus.
Der Zugriff auf Orders ist durch den aktuellen API-Key eingeschränkt: Sie können nur Orders sehen, die
unter Verwendung Ihres X-Api-Public-Key erstellt wurden.
HTTP-Anfrage
Methode: GET
URL: https://quickex.io/api/v2/orders/public-info
Anfragebeispiel
curl -X 'GET' \
'https://quickex.io/api/v2/orders/public-info?orderId=3038' \
-H 'accept: application/json' \
-H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
-H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
-H 'X-Api-Signature: {SIGNATURE}'
Header
| Header | Erforderlich | Beschreibung |
|---|---|---|
| Accept | ja | Empfohlener Wert: application/json. |
| X-Api-Public-Key | ja | Ihr öffentlicher API-Schlüssel. |
| X-Api-Timestamp | ja | Zeitstempel (in der Regel UNIX in ms), der in die Signatur eingeht. |
| X-Api-Signature | ja | Anfrage-Signatur (HMAC SHA256 gemäß API-v2-Schema). |
Anfrageparameter
Query-Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| orderId | int | ja | Die Order-ID, zu der Informationen angefordert werden. |
Antwortformat
Die Methode gibt ein JSON-Objekt mit vollständigen Informationen zur Order zurück.
Antwortbeispiel
{
"orderId": 174059,
"legacyOrderId": "602184da-5881-408e-bffa-3562702d7d3e",
"pair": {
"instrumentFrom": {
"currencyTitle": "XRP",
"networkTitle": "XRP",
"precisionDecimals": 2,
"slug": "xrp",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 12,
"minConfirmationsToWithdraw": 12
}
]
},
"instrumentTo": {
"currencyTitle": "TRX",
"networkTitle": "TRX",
"precisionDecimals": 2,
"slug": "trx",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}
]
}
},
"createdAt": "2025-12-15T14:38:40.523Z",
"instrumentFromCurrencyTitle": "XRP",
"instrumentFromNetworkTitle": "XRP",
"instrumentToCurrencyTitle": "TRX",
"instrumentToNetworkTitle": "TRX",
"feeMode": "FIXED",
"userId": 2382,
"userEmail": "sam.white@support.example.io",
"isPlatformEmail": false,
"refundAddress": "rNFSruW9B1NwVoGgUMmfwXbruWMp8Mgv3K",
"refundAddressMemo": null,
"destinationAddress": "TWRW8YiZtjW7JkYxxzuPrN9fQzoDK5FHgm",
"destinationAddressMemo": null,
"claimedNetworkFee": "1.987665024814",
"rateMode": "FIXED",
"claimedDepositAmount": "57",
"amountToGet": "393.07",
"platformFee": "3.86",
"redirectUrl": null,
"orderEvents": [
{
"createdAt": "2025-12-15T14:42:43.317Z",
"kind": "WITHDRAWAL_COMPLETED"
},
{
"createdAt": "2025-12-15T14:41:54.109Z",
"kind": "FUNDS_WITHDRAWAL_START"
},
{
"createdAt": "2025-12-15T14:41:00.379Z",
"kind": "DEPOSIT_REGISTERED"
},
{
"createdAt": "2025-12-15T14:39:58.760Z",
"kind": "INCOMING_FUNDS_DETECTED"
},
{
"createdAt": "2025-12-15T14:38:41.642Z",
"kind": "CREATION_END"
}
],
"depositAddress": {
"instrument": {
"currencyTitle": "XRP",
"networkTitle": "XRP"
},
"depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
"depositAddressMemo": "2097040307"
},
"deposits": [
{
"id": 50958,
"counterPartyAddress": null,
"createdAt": "2025-12-15T14:39:45.000Z",
"instrument": {
"currencyTitle": "XRP",
"networkTitle": "XRP"
},
"amount": "57",
"amountUSDT": "112.40742",
"txId": "DEA15CCF7AF04799A090298CB06D78DD177B3B518BED9C9DE8A0A5B717CCDBE7",
"confirmations": 12,
"depositAddress": {
"instrument": {
"currencyTitle": "XRP",
"networkTitle": "XRP"
},
"depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
"depositAddressMemo": "2097040307"
},
"isPending": false
}
],
"withdrawals": [
{
"instrument": {
"currencyTitle": "TRX",
"networkTitle": "TRC20"
},
"amount": "393.07",
"txId": "39dc5802a931da0613f687087397e812dd6c0aa0b9041124d76e864e37bd1e09",
"createdAt": "2025-12-15T14:41:58.926Z",
"networkFee": "1.98"
}
],
"KYCFormLink": null,
"liquidityProviderPublicCode": "hat",
"possibleRefferalAccrualAmount": "0.78",
"possibleCashbackAmountUSDT": "0.22",
"actualCashbackAmountUSDT": "0.22",
"claimedPublicRate": {
"claimedAmountToReceive": "393.07",
"finalNetworkFeeAmount": "1.9876650248138958",
"platformFee_Absolute": null,
"price": "7.000992555831266",
"quotes": {
"sellQuote": {
"baseValue": "0.2821",
"quoteValue": "1.9453930016929823"
},
"buyQuote": {
"baseValue": "1.97499",
"quoteValue": "0.2777753832835882"
}
},
"updatedAt": "2025-12-15T14:38:36.201Z",
"instrumentFrom": {
"currencyTitle": "XRP",
"networkTitle": "XRP",
"precisionDecimals": 2,
"slug": "xrp",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 12,
"minConfirmationsToWithdraw": 12
}
]
},
"instrumentTo": {
"currencyTitle": "TRX",
"networkTitle": "TRX",
"precisionDecimals": 2,
"slug": "trx",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}
]
}
},
"completed": true,
"minConfirmationsToTrade": 12,
"minConfirmationsToWithdraw": 12
}
Feldbeschreibung der Antwort
Unten sind die wichtigsten Felder der Antwort aufgeführt. Einige verschachtelte Strukturen (z. B. instrumentFrom / instrumentTo) sind strukturell ähnlich zu Objekten aus den Methoden /instruments und /rates.
Allgemeine Informationen zur Order
| Feld | Typ | Beschreibung |
|---|---|---|
| orderId | number | Eindeutige Order-ID im Quickex-System. |
| legacyOrderId | string | Order-ID im Legacy-System (falls für Migration/Kompatibilität verwendet). |
| createdAt | string | Zeitpunkt der Order-Erstellung (ISO8601). |
| instrumentFromCurrencyTitle | string | Code der Ausgangswährung (z. B. BTC). |
| instrumentFromNetworkTitle | string | Ausgangsnetzwerk (z. B. BTC). |
| instrumentToCurrencyTitle | string | Code der Zielwährung (z. B. USDT). |
| instrumentToNetworkTitle | string | Zielnetzwerk (z. B. TRC20). |
| feeMode | string | Gebührenmodus der Order: • FLOATING – die Gebühr kann sich je nach Netzwerkbedingungen oder Markttyp ändern.• FIXED – die Gebühr wird beim Erstellen der Order fixiert. |
| rateMode | string | Kursmodus: • FIXED – der Kurs wird beim Erstellen der Order fixiert; der Auszahlungsbetrag ändert sich nicht.• FLOATING – der Kurs kann bis zum Abschluss der Order schwanken; der Auszahlungsbetrag wird entsprechend den aktuellen Marktbedingungen aktualisiert. |
| claimedDepositAmount | string | Einzahlungsbetrag, der beim Erstellen der Order verwendet wurde. |
| amountToGet | string | Betrag, den der Nutzer für diese Order erhalten soll. |
| claimedNetworkFee | string | Netzwerkgebühr, die in der Order-Berechnung berücksichtigt wurde. |
| platformFee | string | Plattformgebühr. |
| redirectUrl | string | URL für Redirect zu einem externen Service. |
| completed | boolean | Abschluss-Flag der Order: true — Tausch abgeschlossen, false — in Bearbeitung. |
| minConfirmationsToTrade | number | Minimale Bestätigungen, damit die Einzahlung als für den Tausch verfügbar gilt. |
| minConfirmationsToWithdraw | number | Minimale Bestätigungen, die für die Auszahlung erforderlich sind. |
Instrumentenpaar (pair)
"pair": {
"instrumentFrom": {
"currencyTitle": "XRP",
"networkTitle": "XRP",
"precisionDecimals": 2,
"slug": "xrp",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 12,
"minConfirmationsToWithdraw": 12
}
]
},
"instrumentTo": {
"currencyTitle": "TRX",
"networkTitle": "TRX",
"precisionDecimals": 2,
"slug": "trx",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}
]
}
},
| Feld | Typ | Beschreibung |
|---|---|---|
| instrumentFrom | object | Ausgangsinstrument: die Währung, die der Nutzer sendet. |
| instrumentFrom.currencyTitle | string | Währungscode des Ausgangsinstruments (z. B. XRP). |
| instrumentFrom.networkTitle | string | Blockchain-Netzwerk des Ausgangsinstruments. |
| instrumentFrom.precisionDecimals | number | Anzahl unterstützter Nachkommastellen für Beträge. |
| instrumentFrom.slug | string | Interner Bezeichner der Währung. |
| instrumentFrom.liquidityProviderCurrencies | array | Einstellungen des Liquiditätsanbieters für diese Währung und dieses Netzwerk. |
| instrumentFrom.liquidityProviderCurrencies.minConfirmationsToTrade | number | Minimale Bestätigungen, um die Einzahlung im Tausch zu verwenden. |
| instrumentFrom.liquidityProviderCurrencies.minConfirmationsToWithdraw | number | Minimale Bestätigungen, bevor eine Auszahlung erlaubt wird. |
| instrumentTo | object | Zielinstrument: die Währung, die der Nutzer erhält. |
| instrumentTo.currencyTitle | string | Währungscode des Zielinstruments (z. B. TRX). |
| instrumentTo.networkTitle | string | Blockchain-Netzwerk des Zielinstruments. |
| instrumentTo.precisionDecimals | number | Anzahl unterstützter Nachkommastellen für Beträge. |
| instrumentTo.slug | string | Interner Bezeichner der Währung. |
| instrumentTo.liquidityProviderCurrencies | array | Einstellungen des Liquiditätsanbieters für diese Währung und dieses Netzwerk. |
| instrumentTo.liquidityProviderCurrencies.minConfirmationsToTrade | number | Minimale Bestätigungen, bevor die Mittel getauscht werden können. |
| instrumentTo.liquidityProviderCurrencies.minConfirmationsToWithdraw | number | Minimale Bestätigungen, bevor die Mittel ausgezahlt werden können. |
Mögliche Anwendungsfälle
- Abruf vollständiger Details zu einer bestimmten Order, um die komplette Transaktionshistorie, den Status und zugehörige Finanzdaten im Nutzerkonto/Partner-Dashboard anzuzeigen oder für Abgleich- und Audit-Zwecke.
Code Sample
curl -X 'GET' \
'https://quickex.io/api/v2/orders/info?orderId=3038' \
-H 'accept: application/json' \
-H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
-H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
-H 'X-Api-Signature: {SIGNATURE}'Response Example
{
"orderId": 3038,
"legacyOrderId": "4602ddf9-e516-4c3a-9146-7bc748edd89b",
"pair": {
"instrumentFrom": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"precisionDecimals": 7,
"slug": "btc",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}
]
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"precisionDecimals": 5,
"slug": "usdttrc20",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}
]
}
},
"createdAt": "2025-04-28T13:15:03.006Z",
"instrumentFromCurrencyTitle": "BTC",
"instrumentFromNetworkTitle": "BTC",
"instrumentToCurrencyTitle": "USDT",
"instrumentToNetworkTitle": "TRC20",
"feeMode": "FLOATING",
"userId": 229,
"userEmail": "qa@support.quickex.io",
"isPlatformEmail": false,
"refundAddress": null,
"refundAddressMemo": null,
"destinationAddress": "TFjfHBiDcL6B5S5W8g9b6gU2tbvnTR52ya",
"destinationAddressMemo": null,
"claimedNetworkFee": "1.5",
"rateMode": "FLOATING",
"claimedDepositAmount": "0.034268",
"amountToGet": "3263.05",
"platformFee": null,
"redirectUrl": null,
"orderEvents": [
{
"createdAt": "2025-04-28T13:15:03.021Z",
"kind": "CREATION_END"
}
],
"depositAddress": {
"instrument": {
"currencyTitle": "BTC",
"networkTitle": "BTC"
},
"depositAddress": "3LpR1ZKEVysoi6sxFqoGtB49638RsxzKSh",
"depositAddressMemo": null
},
"deposits": [],
"withdrawals": [],
"KYCFormLink": null,
"liquidityProviderPublicCode": "hat",
"possibleRefferalAccrualAmount": "3.01",
"possibleCashbackAmountUSDT": "0",
"actualCashbackAmountUSDT": null,
"claimedPublicRate": {
"claimedAmountToReceive": "3259.38",
"finalNetworkFeeAmount": "1.5",
"price": "95158.1",
"quotes": {
"sellQuote": {
"baseValue": "1",
"quoteValue": "95114.32743505127"
},
"buyQuote": {
"baseValue": "95158",
"quoteValue": "0.9995400016924599"
}
},
"updatedAt": "2025-04-28T13:11:30.251Z",
"instrumentFrom": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"precisionDecimals": 7,
"slug": "btc",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}
]
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"precisionDecimals": 5,
"slug": "usdttrc20",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}
]
}
},
"completed": false,
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}Try it out
Leave empty to use default
Query Parameters
Headers
POST
accept-rate-mode-change
Endpoint URL
https://quickex.io/api/v2/orders/public/accept-rate-mode-change
Documentation
Bestätigt die Änderung des Kursmodus (rate mode) für eine Order. Dies wird in Fällen verwendet, in denen die Order mit einem festen Kurs erstellt wurde,
während des Austauschprozesses jedoch auf einen variablen Kurs umgestellt wurde (zum Beispiel aufgrund überschrittener Limits oder hoher Volatilität).
Die Methode ermöglicht es dem Nutzer, den neuen Modus zu akzeptieren und die Orderverarbeitung fortzusetzen.
URL
https://quickex.io/api/v2/orders/public/accept-rate-mode-change
Headers
Accept: application/jsonContent-Type: application/json
Request Body (JSON)
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
orderId |
number | ja | Die Kennung der Order, für die die Änderung des Kursmodus 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"
}Request Example (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"
}'Responses
| Code | Beschreibung |
|---|---|
201 Created |
Die Änderung des Kursmodus wurde bestätigt und die Order wird weiter verarbeitet. |
404 Not Found |
Order nicht gefunden ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Validierungsfehler (zum Beispiel ungültige Eingabedaten). |
5xx |
Interner Serverfehler. |
Notes
- Diese Methode wird nur aufgerufen, wenn die Order ihren Kursmodus geändert hat (zum Beispiel von FIXED zu FLOATING).
- Ohne Bestätigung wird die Orderverarbeitung angehalten.
- Bei Erfolg gibt die Antwort den Status 201 zurück und die Order wechselt in den Zustand der fortgesetzten Verarbeitung.
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
POST
request-refund
Endpoint URL
https://quickex.io/api/v2/orders/public/request-refund
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ückgegeben werden müssen.
Damit der Vorgang erfolgreich ist, müssen der Rückerstattungsbetrag und die Rückerstattungsadresse angegeben werden.
URL
https://quickex.io/api/v2/orders/public/request-refund
Headers
Accept: application/jsonContent-Type: application/json
Request Body (JSON)
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
orderId |
number | ja | Die Kennung 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 an den Nutzer zurückerstattet werden soll. |
refundAddress |
string | ja | Die Wallet-Adresse des Nutzers, an die die Rückerstattung gesendet wird. |
claimedNetworkFee |
string | nein | Der Betrag der Netzwerkgebühr, den der Nutzer für die Rückerstattung zu zahlen bereit ist. |
{
"orderId": 123456,
"destinationAddress": "0xdeadbeef",
"refundAmount": "10.00",
"refundAddress": "0xuserrefundwallet",
"claimedNetworkFee": "0.50"
}Request Example (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"
}'Responses
| Code | Beschreibung |
|---|---|
201 Created |
Die Rückerstattungsanfrage wurde akzeptiert und wird bearbeitet. |
404 Not Found |
Order nicht gefunden ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Validierungsfehler (zum Beispiel Rückerstattungsbetrag unter dem zulässigen Minimum oder ungültige refundAddress). |
5xx |
Interner Serverfehler. |
Notes
- Diese Methode wird nur für Orders verwendet, die nicht abgeschlossen werden können.
- Die Rückerstattung erfolgt an die in
refundAddressangegebene Adresse, abzüglich ggf. anfallender Netzwerkgebühren.- Nach dem Absenden kann die Rückerstattung eine manuelle Prüfung durch den Support 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
GET
order-refund-info
Endpoint URL
https://quickex.io/api/v2/orders/order-refund-info
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, Rückerstattungsadresse, Status).
URL
https://quickex.io/api/v2/orders/order-refund-info
Request Parameters (Query)
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
orderId |
string | ja | Die Kennung 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'Responses
| Code | Beschreibung |
|---|---|
200 OK |
Gibt JSON mit Rückerstattungsinformationen zurück (Betrag, Adresse, Status, Gebühren). |
400 Bad Request |
Validierungsfehler oder ungültige Order-Daten ({"status":"ERR_BAD_REQUEST","message":"Unknown liquidity provider title: ..."}). |
404 Not Found |
Order nicht gefunden. |
5xx |
Interner Serverfehler. |
Notes
- Die Methode gibt Daten nur für Orders zurück, bei denen eine Rückerstattung initiiert wurde.
- In einer erfolgreichen
200-Antwort kann das JSON den Rückerstattungsbetrag, die Rückerstattungsadresse und Netzwerkgebühren enthalten.- Bei Validierungsfehlern (
400) gibt der Server den Grund im Feldmessagean.
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