Équipe Quickex
12 novembre 2025
~1 lecture minimale
Le groupe de méthodes Orders est responsable du travail avec les ordres — des échanges créés par les utilisateurs sur la plateforme Quickex.
À l’aide de ces méthodes, vous pouvez : obtenir des informations publiques sur un ordre particulier et sur les derniers échanges,
lier une adresse e-mail à un ordre pour recevoir des notifications, accepter les changements de régime de taux de change (par ex., passage d’un taux fixe à un taux flottant), initier un remboursement et en vérifier l’état.
Ces méthodes sont utilisées à toutes les étapes du cycle de vie d’un ordre — du suivi au remboursement.
GET
public-info
Endpoint URL
https://quickex.io/api/v1/orders/public-info
Documentation
Renvoie des informations publiques sur une commande (opération d’échange) à partir de l’adresse de destination.
La réponse contient des détails sur les dépôts/retraits, la paire de trading, les paramètres de taux déclarés, les événements de la commande, etc.
URL
https://quickex.io/api/v1/orders/public-info
Paramètres de requête (query)
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
destinationAddress |
string | oui | L’adresse de destination liée à la commande. Utilisée pour rechercher la commande. |
Exemple de requête (cURL)
curl -X GET \
'https://quickex.io/api/v1/orders/public-info?destinationAddress=0xdeadbeef' \
-H 'Accept: application/json'Exemple de réponse (succès)
{
"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"
}Réponses
| Code | Contenu | Description |
|---|---|---|
200 OK |
JSON avec les informations de la commande | La commande a été trouvée et renvoyée. |
400 Bad Request |
{"status":"ERR_VALIDATION","message":"Validation Exception", ...} |
Erreur de validation (par exemple si destinationAddress est manquante ou invalide). |
5xx |
— | Erreur interne du serveur. |
Remarques
- La méthode renvoie des données publiques de la commande ; les détails privés ne sont pas disponibles.
- Si la commande n’a pas encore été créée / ne peut pas être trouvée via l’adresse, une erreur de validation ou un résultat vide sera renvoyé.
- La structure des sections
deposits/withdrawalset des champs auxiliaires peut varier selon l’état de la commande et le fournisseur de liquidité.
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
POST
set-email
Endpoint URL
/api/v1/orders/public/set-email
Documentation
Assigne une adresse e-mail à une commande existante (opération d’échange). L’e-mail est utilisé pour envoyer des notifications sur l’état de la commande et pour contacter le support.
URL
https://quickex.io/api/v1/orders/public/set-email
Autorisation requise
Non (méthode publique pour une commande existante).
En-têtes
Accept: application/jsonContent-Type: application/json
Corps de la requête (JSON)
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
orderId |
number | oui | Identifiant de la commande à laquelle l’e-mail doit être associé. |
userEmail |
string (email) | oui | Adresse e-mail de l’utilisateur pour les notifications. |
{
"orderId": 123456,
"userEmail": "user@example.com"
}Exemple de requête (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"
}'Réponses
| Code | Corps | Description |
|---|---|---|
200 OK |
JSON avec des informations publiques sur la commande (y compris userEmail) |
L’e-mail a été associé à la commande avec succès. |
400 Bad Request |
{"status":"ERR_VALIDATION","message":"Validation Exception", ...} |
Erreur de validation (par exemple, si userEmail n’est pas une adresse e-mail valide). |
5xx |
— | Erreur interne du serveur. |
Remarques
- Avant l’appel, assurez-vous d’indiquer un
orderIdvalide d’une commande existante.userEmaildoit être une adresse e-mail valide (exemple d’erreur :userEmail must be an email).- En cas de réussite, la réponse renvoie les informations publiques actuelles de la commande, où le champ
userEmailcontiendra l’adresse attribuée.
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
GET
latest
Endpoint URL
https://quickex.io/api/v1/orders/public/latest
Documentation
Renvoie une liste des dernières commandes publiques créées sur la plateforme Quickex. Cette méthode ne nécessite aucun paramètre et fournit des informations de base sur les échanges récents (devises, réseaux et montants).
Paramètres
Aucun
Exemple de requête
curl -X 'GET' \
'https://quickex.io/api/v1/orders/public/latest' \
-H 'accept: application/json'Exemple de réponse (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"
}
]Remarques
La méthode renvoie uniquement des informations publiques (sans données personnelles de l’utilisateur).
Elle peut être utile pour l’affichage d’un widget « derniers échanges » sur un site Web.
La réponse contient une liste avec un nombre limité d’entrées (par ex., les 5 à 10 dernières commandes).
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
POST
accept-rate-mode-change
Endpoint URL
https://quickex.io/api/v1/orders/public/accept-rate-mode-change
Documentation
Confirme la modification du mode de taux pour une commande. Cette action est utilisée lorsque la commande a été créée avec un taux fixe, mais qu’au cours du processus d’échange elle a été basculée sur un taux flottant (par exemple en raison d’un dépassement des limites ou d’une forte volatilité).
La méthode permet à l’utilisateur d’accepter le nouveau mode et de poursuivre le traitement de la commande.
URL
https://quickex.io/api/v1/orders/public/accept-rate-mode-change
En-têtes
Accept: application/jsonContent-Type: application/json
Corps de la requête (JSON)
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
orderId |
number | oui | Identifiant de la commande pour laquelle la modification du mode de taux doit être confirmée. |
destinationAddress |
string | oui | Adresse de destination associée à la commande (utilisée comme vérification supplémentaire). |
{
"orderId": 123456,
"destinationAddress": "0xdeadbeef"
}Exemple de requête (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"
}'Réponses
| Code | Description |
|---|---|
201 Created |
La modification du mode de taux a été confirmée et la commande poursuit son traitement. |
404 Not Found |
Commande introuvable ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Erreur de validation (par exemple, données d’entrée invalides). |
5xx |
Erreur interne du serveur. |
Remarques
- Cette méthode n’est appelée que si la commande a changé de mode de taux (par exemple, de fixe à flottant).
- Sans confirmation, le traitement de la commande sera suspendu.
- En cas de succès, la réponse renvoie le statut 201 et la commande continue d’être traitée.
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/v1/orders/public/request-refund
Documentation
Demande un remboursement pour une commande. Utilisé lorsque l’échange n’a pas été finalisé ou lorsque des fonds doivent être restitués à l’utilisateur.
Pour réussir, le montant du remboursement et l’adresse de remboursement doivent être indiqués.
URL
https://quickex.io/api/v1/orders/public/request-refund
En-têtes
Accept: application/jsonContent-Type: application/json
Corps de la requête (JSON)
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
orderId |
number | oui | Identifiant de la commande pour laquelle un remboursement est demandé. |
destinationAddress |
string | oui | Adresse de destination indiquée dans la commande initiale (utilisée comme vérification supplémentaire). |
refundAmount |
string | oui | Montant à rembourser à l’utilisateur. |
refundAddress |
string | oui | Adresse du portefeuille de l’utilisateur vers laquelle les fonds seront remboursés. |
claimedNetworkFee |
string | non | Montant des frais de réseau que l’utilisateur accepte de payer pour le remboursement. |
{
"orderId": 123456,
"destinationAddress": "0xdeadbeef",
"refundAmount": "10.00",
"refundAddress": "0xuserrefundwallet",
"claimedNetworkFee": "0.50"
}Exemple de requête (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"
}'Réponses
| Code | Description |
|---|---|
201 Created |
La demande de remboursement a été acceptée et sera traitée. |
404 Not Found |
Commande introuvable ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Erreur de validation (par exemple, montant de remboursement inférieur au minimum autorisé ou refundAddress invalide). |
5xx |
Erreur interne du serveur. |
Remarques
- Cette méthode est utilisée uniquement pour les commandes qui ne peuvent pas être finalisées.
- Le remboursement est effectué à l’adresse indiquée dans
refundAddress, déduction faite des frais de réseau applicables.- Après l’envoi, le remboursement peut nécessiter une vérification manuelle par l’équipe d’assistance.
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/v1/orders/order-refund-info
Documentation
Renvoie les informations de remboursement pour une commande spécifique.
Utilisé après la création d’une demande de remboursement afin de vérifier les détails (montant, adresse de remboursement, statut).
URL
https://quickex.io/api/v1/orders/order-refund-info
Paramètres de la requête (query)
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
orderId |
string | oui | Identifiant de la commande pour laquelle les données de remboursement doivent être récupérées. |
curl -X GET \
'https://quickex.io/api/v1/orders/order-refund-info?orderId=1234' \
-H 'Accept: application/json'Réponses
| Code | Description |
|---|---|
200 OK |
Renvoie un JSON avec les informations de remboursement (montant, adresse, statut, frais). |
400 Bad Request |
Erreur de validation ou données de commande invalides ({"status":"ERR_BAD_REQUEST","message":"Unknown liquidity provider title: ..."}). |
404 Not Found |
Commande introuvable. |
5xx |
Erreur interne du serveur. |
Remarques
- La méthode renvoie des données uniquement pour les commandes pour lesquelles un remboursement a été initié.
- Dans une réponse
200réussie, le JSON peut inclure le montant du remboursement, l’adresse de remboursement et les frais de réseau.- En cas d’erreurs de validation (
400), le serveur fournit la raison dans le champmessage.
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
GET
public/list
Endpoint URL
https://quickex.io/api/v1/orders/public/list
Documentation
Renvoie la liste des ordres associés à l’utilisateur actuellement authentifié.
La réponse inclut des détails sur les dépôts, les retraits, les paramètres de la paire de trading, le statut de l’ordre et d’autres informations.
URL
https://quickex.io/api/v1/orders/public/list
Autorisation requise
Oui — un access_token valide doit être fourni dans l’en-tête.
En-têtes
Accept: application/jsonaccess_token = YOUR_TOKEN
Paramètres
Aucun
Exemple de requête (cURL)
curl -X GET \
'https://quickex.io/api/v1/orders/public/list' \
-H 'Accept: application/json' \
--cookie "access_token=YOUR_TOKEN"Exemple de réponse (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"
}
]Réponses
| Code | Description |
|---|---|
200 OK |
Renvoie un tableau des ordres de l’utilisateur. |
401 Unauthorized |
access_token manquant ou invalide. |
5xx |
Erreur du serveur lors du traitement de la requête. |
Remarques
- Cette méthode renvoie uniquement les ordres créés par l’utilisateur actuellement authentifié.
- Pour récupérer des informations publiques sur un ordre spécifique, utilisez la méthode
/api/v1/orders/public-info.- Il est recommandé de mettre en cache les données des ordres côté client afin de réduire le nombre de requêtes.
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
POST
/api/v1/orders/public/create
Endpoint URL
https://quickex.io/api/v1/orders/public/create
Documentation
Crée un nouvel ordre d’échange.
La méthode accepte les paramètres de la paire de trading (monnaies d’envoi et de réception), le montant, les adresses de l’utilisateur, ainsi que des données supplémentaires
(taux, frais, paramètres d’affiliation). La réponse renvoie un objet ordre avec les détails des dépôts et des retraits.
URL
https://quickex.io/api/v1/orders/public/create
Authentification
- L’en-tête
B2B-Bearer-Tokenest requis pour les intégrations B2B (exemple :-H "B2B-Bearer-Token: TOKEN"). - Pour les scénarios utilisateur,
access_tokenpeut être utilisé comme cookie.
En-têtes
Accept: application/jsonContent-Type: application/jsonB2B-Bearer-Token: <TOKEN>
Corps de la requête (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"
}Exemple de requête (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"
}'Exemple de réponse (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"
}Réponses
| Code | Description |
|---|---|
200 OK |
Ordre créé avec succès ; l’objet ordre est renvoyé. |
401 Unauthorized |
En-tête B2B-Bearer-Token ou cookie access_token manquant ou invalide. |
422 Unprocessable Entity |
Erreur de validation dans les données d’entrée (par exemple, montant trop faible). |
501 |
Erreur serveur (« data is not iterable »). |
Remarques
- Il est recommandé de récupérer d’abord le taux via
/api/v1/rates/public/oneavant de créer un ordre.- Si
rateMode=FIXEDest spécifié, le taux sera verrouillé pendant une durée limitée.- Les paramètres
referrerIdetmarkupAffiliateIdsont utilisés pour les intégrations d’affiliation.- La réponse peut contenir des tableaux
withdrawalsvides si les fonds n’ont pas encore été envoyés.
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