Equipo Quickex
12 de noviembre de 2025
~1 lectura mínima
El grupo de métodos Orders es responsable de trabajar con las órdenes – intercambios creados por los usuarios en la plataforma Quickex.
Con estos métodos puedes: obtener información pública sobre una orden específica y sobre los últimos intercambios,
vincular un correo electrónico a una orden para recibir notificaciones, aceptar cambios en el modo de tipo de cambio (p. ej., pasar de un tipo fijo a uno flotante), iniciar un reembolso y comprobar su estado.
Estos métodos se utilizan en todas las etapas del ciclo de vida de la orden – desde el seguimiento hasta los reembolsos.
GET
public-info
Endpoint URL
https://quickex.io/api/v1/orders/public-info
Documentation
Devuelve información pública sobre una orden (operación de intercambio) por la dirección de destino.
La respuesta contiene detalles de depósitos/retiros, par de intercambio, parámetros declarados del tipo de cambio, eventos de la orden, etc.
URL
https://quickex.io/api/v1/orders/public-info
Parámetros de la solicitud (query)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
destinationAddress |
string | sí | La dirección de destino vinculada a la orden. Se usa para buscar la orden. |
Ejemplo de solicitud (cURL)
curl -X GET \
'https://quickex.io/api/v1/orders/public-info?destinationAddress=0xdeadbeef' \
-H 'Accept: application/json'Ejemplo de respuesta (éxito)
{
"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"
}Respuestas
| Código | Cuerpo | Descripción |
|---|---|---|
200 OK |
JSON con información de la orden | La orden fue encontrada y devuelta. |
400 Bad Request |
{"status":"ERR_VALIDATION","message":"Validation Exception", ...} |
Error de validación (por ejemplo, si destinationAddress falta o no es válido). |
5xx |
— | Error interno del servidor. |
Notas
- El método devuelve datos públicos de la orden; los detalles privados no están disponibles.
- Si la orden aún no se ha creado o no puede encontrarse por la dirección, se devolverá un error de validación o un resultado vacío.
- La estructura de las secciones
deposits/withdrawalsy los campos auxiliares puede variar según el estado de la orden y el proveedor de liquidez.
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
Asigna un correo electrónico a una orden existente (operación de intercambio). El correo se utiliza para enviar notificaciones sobre el estado de la orden y para contactar con soporte.
URL
https://quickex.io/api/v1/orders/public/set-email
¿Se requiere autorización?
No (método público para una orden existente).
Encabezados
Accept: application/jsonContent-Type: application/json
Cuerpo de la solicitud (JSON)
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
orderId |
number | sí | Identificador de la orden a la que se debe vincular el correo. |
userEmail |
string (email) | sí | Dirección de correo electrónico del usuario para notificaciones. |
{
"orderId": 123456,
"userEmail": "user@example.com"
}Ejemplo de solicitud (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"
}'Respuestas
| Código | Cuerpo | Descripción |
|---|---|---|
200 OK |
JSON con información pública de la orden (incluido userEmail) |
El correo se vinculó correctamente a la orden. |
400 Bad Request |
{"status":"ERR_VALIDATION","message":"Validation Exception", ...} |
Error de validación (por ejemplo, si userEmail no es un correo electrónico válido). |
5xx |
— | Error interno del servidor. |
Notas
- Antes de llamar al método, asegúrate de indicar un
orderIdválido de una orden existente.userEmaildebe ser una dirección de correo válida (ejemplo de error:userEmail must be an email).- La respuesta exitosa devuelve la información pública actual de la orden, donde el campo
userEmailcontendrá la dirección asignada.
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
Devuelve una lista de las órdenes públicas más recientes creadas en la plataforma Quickex.
Este método no requiere parámetros y proporciona información básica sobre los intercambios recientes (monedas, redes y montos).
Parámetros
Ninguno
Ejemplo de solicitud
curl -X 'GET' \
'https://quickex.io/api/v1/orders/public/latest' \
-H 'accept: application/json'Ejemplo de respuesta (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"
}
]Notas
El método devuelve solo información pública (sin datos personales del usuario).
Puede ser útil para mostrar un widget de “últimos intercambios” en un sitio web.
La respuesta contiene una lista con un número limitado de registros (p. ej., las últimas 5–10 órdenes).
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
Confirma el cambio del modo de tipo de cambio de una orden. Se utiliza en casos en los que la orden se creó con tipo fijo, pero durante el proceso de intercambio se cambió a tipo flotante (por ejemplo, por exceder límites o por alta volatilidad).
El método permite al usuario aceptar el nuevo modo y continuar el procesamiento de la orden.
URL
https://quickex.io/api/v1/orders/public/accept-rate-mode-change
Encabezados
Accept: application/jsonContent-Type: application/json
Cuerpo de la solicitud (JSON)
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
orderId |
number | sí | Identificador de la orden para la que debe confirmarse el cambio de modo de tipo de cambio. |
destinationAddress |
string | sí | La dirección de destino asociada a la orden (se usa como verificación adicional). |
{
"orderId": 123456,
"destinationAddress": "0xdeadbeef"
}Ejemplo de solicitud (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"
}'Respuestas
| Código | Descripción |
|---|---|
201 Created |
El cambio de modo de tipo de cambio ha sido confirmado y la orden continúa procesándose. |
404 Not Found |
Orden no encontrada ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Error de validación (por ejemplo, datos de entrada no válidos). |
5xx |
Error interno del servidor. |
Notas
- Este método solo se llama si la orden ha cambiado su modo de tipo de cambio (por ejemplo, de fijo a flotante).
- Sin confirmación, el procesamiento de la orden se suspenderá.
- Si tiene éxito, la respuesta devuelve el estado 201 y la orden continúa procesándose.
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
Solicita un reembolso para una orden. Se utiliza en situaciones en las que el intercambio no se completó o los fondos deben devolverse al usuario.
Para que tenga éxito, se deben especificar el monto del reembolso y la dirección de reembolso.
URL
https://quickex.io/api/v1/orders/public/request-refund
Encabezados
Accept: application/jsonContent-Type: application/json
Cuerpo de la solicitud (JSON)
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
orderId |
number | sí | Identificador de la orden para la que se solicita un reembolso. |
destinationAddress |
string | sí | La dirección de destino especificada en la orden original (se usa como verificación adicional). |
refundAmount |
string | sí | El monto que se reembolsará al usuario. |
refundAddress |
string | sí | La dirección de la cartera del usuario a la que se reembolsarán los fondos. |
claimedNetworkFee |
string | no | El importe de la comisión de red que el usuario acepta pagar por el reembolso. |
{
"orderId": 123456,
"destinationAddress": "0xdeadbeef",
"refundAmount": "10.00",
"refundAddress": "0xuserrefundwallet",
"claimedNetworkFee": "0.50"
}Ejemplo de solicitud (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"
}'Respuestas
| Código | Descripción |
|---|---|
201 Created |
La solicitud de reembolso ha sido aceptada y será procesada. |
404 Not Found |
Orden no encontrada ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Error de validación (por ejemplo, monto de reembolso por debajo del mínimo permitido o refundAddress no válido). |
5xx |
Error interno del servidor. |
Notas
- Este método solo se utiliza para órdenes que no pueden completarse.
- El reembolso se realiza a la dirección especificada en
refundAddress, menos las comisiones de red aplicables.- Tras el envío, el reembolso puede requerir verificación manual por parte del personal de soporte.
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
Devuelve la información de reembolso de una orden específica.
Se utiliza después de crear una solicitud de reembolso para comprobar los detalles (monto, dirección de reembolso, estado).
URL
https://quickex.io/api/v1/orders/order-refund-info
Parámetros de la solicitud (query)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
orderId |
string | sí | Identificador de la orden para la que se deben obtener los datos de reembolso. |
curl -X GET \
'https://quickex.io/api/v1/orders/order-refund-info?orderId=1234' \
-H 'Accept: application/json'Respuestas
| Código | Descripción |
|---|---|
200 OK |
Devuelve JSON con la información del reembolso (monto, dirección, estado, comisiones). |
400 Bad Request |
Error de validación o datos de la orden no válidos ({"status":"ERR_BAD_REQUEST","message":"Unknown liquidity provider title: ..."}). |
404 Not Found |
Orden no encontrada. |
5xx |
Error interno del servidor. |
Notas
- El método devuelve datos solo para órdenes en las que se haya iniciado un reembolso.
- En una respuesta
200exitosa, el JSON puede incluir el monto del reembolso, la dirección de reembolso y las comisiones de red.- Para errores de validación (
400), el servidor proporciona el motivo en el campomessage.
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
Devuelve una lista de las órdenes asociadas con el usuario actualmente autenticado.
La respuesta incluye detalles de depósitos, retiros, parámetros del par de intercambio, estado de la orden y otra información.
URL
https://quickex.io/api/v1/orders/public/list
¿Se requiere autorización?
Sí — se debe proporcionar un access_token válido en el encabezado.
Encabezados
Accept: application/jsonaccess_token = YOUR_TOKEN
Parámetros
Ninguno
Ejemplo de solicitud (cURL)
curl -X GET \
'https://quickex.io/api/v1/orders/public/list' \
-H 'Accept: application/json' \
--cookie "access_token=YOUR_TOKEN"Ejemplo de respuesta (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"
}
]Respuestas
| Código | Descripción |
|---|---|
200 OK |
Devuelve un arreglo con las órdenes del usuario. |
401 Unauthorized |
Falta access_token o no es válido. |
5xx |
Error del servidor al procesar la solicitud. |
Notas
- Este método devuelve únicamente las órdenes creadas por el usuario actualmente autenticado.
- Para obtener información pública sobre una orden específica, utiliza el método
/api/v1/orders/public-info.- Se recomienda almacenar en caché los datos de las órdenes en el lado del cliente para reducir la cantidad de solicitudes.
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
Crea una nueva orden de intercambio.
El método acepta parámetros para el par de intercambio (monedas de envío y de recepción), monto, direcciones del usuario, así como datos adicionales
(tipo de cambio, comisiones, parámetros de afiliados). La respuesta devuelve un objeto de orden con detalles de depósitos y retiros.
URL
https://quickex.io/api/v1/orders/public/create
Autenticación
- Se requiere el encabezado
B2B-Bearer-Tokenpara integraciones B2B (ejemplo:-H "B2B-Bearer-Token: TOKEN"). - Para escenarios de usuario,
access_tokenpuede usarse como cookie.
Encabezados
Accept: application/jsonContent-Type: application/jsonB2B-Bearer-Token: <TOKEN>
Cuerpo de la solicitud (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"
}Ejemplo de solicitud (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"
}'Ejemplo de respuesta (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"
}Respuestas
| Código | Descripción |
|---|---|
200 OK |
La orden se creó correctamente; se devuelve el objeto de la orden. |
401 Unauthorized |
Falta B2B-Bearer-Token o la cookie access_token, o no es válida. |
422 Unprocessable Entity |
Error de validación en los datos de entrada (por ejemplo, monto demasiado pequeño). |
501 |
Error del servidor (“data is not iterable”). |
Notas
- Se recomienda obtener primero el tipo de cambio usando
/api/v1/rates/public/oneantes de crear una orden.- Si se especifica
rateMode=FIXED, el tipo de cambio quedará bloqueado por un tiempo limitado.- Los parámetros
referrerIdymarkupAffiliateIdse utilizan para integraciones de afiliados.- La respuesta puede contener arreglos vacíos en
withdrawalssi los fondos aún no han sido enviados.
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