Orders API V2

POST

orders/public/set-email

Endpoint URL

https://quickex.io/api/v2/orders/public/set-email

Documentation

Nombre	Requerido	Descripción
`X-Api-Public-Key`	sí	Tu clave pública de API para la autenticación de la solicitud.
`X-Api-Timestamp`	sí	Marca de tiempo en formato UNIX (ms). Se utiliza para evitar ataques de repetición.
`X-Api-Signature`	sí	Firma HMAC de todo el cuerpo de la solicitud, generada con tu clave secreta.

Campo	Tipo	Requerido	Descripción
`orderId`	number	sí	Identificador del pedido existente.
`userEmail`	string	sí	Dirección de correo electrónico para notificaciones.

Code Sample

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

POST

orders/public/create

Endpoint URL

https://quickex.io/api/v2/orders/public/create

Documentation

Descripción general
Crea una nueva orden de intercambio de criptomonedas. Devuelve los datos completos de la orden: direcciones de depósito y retiro, parámetros del tipo de cambio, eventos y URL para el procesamiento adicional.

Parámetros

Encabezados

Nombre	Requerido	Descripción
`B2B-Bearer-Token`	sí	Token Bearer para autenticación a través de Mercuryo.
`X-Api-Public-Key`	sí	Tu clave pública de API.
`X-Api-Timestamp`	sí	Marca de tiempo en formato UNIX (ms).
`X-Api-Signature`	sí	Firma HMAC del cuerpo de la solicitud utilizando tu clave secreta.

Cuerpo de la solicitud (JSON)

Campo	Tipo	Requerido	Descripción
`instrumentFrom`	object	sí	Moneda y red de origen (`currencyTitle` / `networkTitle`).
`instrumentTo`	object	sí	Moneda y red de destino.
`destinationAddress`	string	sí	Dirección donde se recibirán los fondos intercambiados.
`destinationAddressMemo`	string	no	Memo/tag opcional para la dirección de destino.
`refundAddress`	string	sí	Dirección para reembolsos en caso de fallo en el intercambio.
`refundAddressMemo`	string	no	Memo/tag para la dirección de reembolso.
`claimedDepositAmount`	string	sí	El monto que el usuario pretende depositar.
`claimedPublicRate`	object	no	Detalles del tipo de cambio reclamado: precio, marca de tiempo y monto esperado a recibir.
`claimedNetworkFee`	string	no	Comisión de red reclamada.
`userEmail`	string	no	Email para notificaciones.
`legacyOrderId`	string	no	ID externo de la orden desde un sistema heredado.
`referrerId`	string	no	ID de referido para el programa de afiliados.
`markupAffiliateId`	string	no	ID del afiliado para la asignación del margen.
`rateMode`	string	no	Tipo de tarifa: `FLOATING` o `FIXED`.
`utmData`	object	no	Parámetros UTM para analítica.
`browserFingerprint`	string	no	Huella digital del navegador para protección antifraude.
`markup`	string	no	Porcentaje de margen.
`mercuryoBearerToken`	string	no	Token de Mercuryo para integración opcional.
`locale`	string	no	Idioma de la respuesta (por ejemplo, `en`, `ru`).

Ejemplo de solicitud

curl -X POST 'https://quickex.io/api/v2/orders/public/create' \
  -H 'accept: application/json' \
  -H 'B2B-Bearer-Token: yourMercuryoToken' \
  -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"
  }'

Respuestas posibles

200 OK — orden creada con éxito; se devuelve el objeto completo de la orden.

401 ERR_UNAUTHORIZED — tokens o claves faltantes o inválidos:

{
  "status": "ERR_UNAUTHORIZED",
  "message": "Unauthorized"
}

Caso de uso

Una plataforma asociada desea crear órdenes automáticamente cuando un usuario paga mediante Mercuryo. Tras la autenticación de Mercuryo, que proporciona un B2B-Bearer-Token, la plataforma compone los detalles del intercambio y llama a este endpoint para crear una orden en Quickex.

Code Sample

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

POST

orders/public/set-email

Endpoint URL

https://quickex.io/api/v2/orders/public/set-email

Documentation

Descripción general

Este método permite establecer un correo electrónico para una orden pública ya creada.

Se utiliza cuando la orden se creó sin userEmail en la solicitud /api/v2/orders/public/create, pero posteriormente necesitas asociar un correo (por ejemplo, para que el usuario pueda recibir notificaciones sobre el estado de la orden).

> Importante: El correo electrónico se puede establecer solo una vez. Si la orden ya tiene un userEmail, no se puede cambiar mediante este método.

Solicitud HTTP

Método: POST
URL: https://quickex.io/api/v2/orders/public/set-email

Ejemplo de solicitud

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"
}'

Encabezados

Encabezado	Requerido	Descripción
`Accept`	sí	Valor recomendado: `application/json`.
`Content-Type`	sí	`application/json`.
`X-Api-Public-Key`	sí	Tu clave pública de la API.
`X-Api-Timestamp`	sí	Marca de tiempo (normalmente UNIX en ms), incluida en la firma.
`X-Api-Signature`	sí	Firma de la solicitud (HMAC SHA256 según el esquema de API v2).

Parámetros de la solicitud

Parámetros del cuerpo

{
  "orderId": 3038,
  "userEmail": "QA@quickex.com"
}

Campo	Tipo	Requerido	Descripción
`orderId`	number	sí	El ID de la orden para la que quieres establecer el correo.
`userEmail`	string	sí	El correo del usuario que se asociará a la orden y se usará para notificaciones.

Restricciones: Si userEmail ya está establecido para esta orden, el método devolverá un error 403 ERR_FORBIDDEN.

Formato de respuesta

Si la solicitud se realiza correctamente, el método devuelve un objeto JSON de la orden, similar a la respuesta de POST /api/v2/orders/public/create / GET /api/v2/orders/info, pero con el campo userEmail establecido.

Ejemplo de respuesta

{
  "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
}

Punto clave: el campo userEmail vinculado a la orden se completará en la respuesta.

Errores

403 ERR_FORBIDDEN — Correo ya establecido

{
  "status": "ERR_FORBIDDEN",
  "message": "Order.userEmail already set and can not be modified"
}

Este error se devuelve si intentas cambiar el correo de una orden en la que userEmail ya fue establecido (ya sea durante la creación de la orden o en una llamada previa a set-email).

Qué hacer:

No se puede cambiar el correo en órdenes que ya tienen un correo establecido.

Casos de uso posibles

Añadir un correo a órdenes creadas de forma anónima (por ejemplo, a través de un widget sin un campo de correo obligatorio).

Code Sample

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

GET

orders/public-info

Endpoint URL

https://quickex.io/api/v2/orders/public-info

Documentation

Descripción general

Este método devuelve información detallada sobre una orden específica por su orderId.
A diferencia de la lista de órdenes (GET /api/v2/orders), proporciona todos los datos relacionados con la orden seleccionada:
el par completo de instrumentos con parámetros, la tasa fija (claimedPublicRate),
los límites de confirmación, el historial de eventos (orderEvents), la dirección de depósito,
así como información sobre posible cashback o acumulaciones por referidos y el estado de finalización.
El acceso a las órdenes está restringido por la clave API actual: solo puedes ver las órdenes que fueron creadas
usando tu X-Api-Public-Key.

Solicitud HTTP

Método: GET
URL: https://quickex.io/api/v2/orders/public-info

Ejemplo de solicitud

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}'

Encabezados

Encabezado	Requerido	Descripción
Accept	sí	Valor recomendado: `application/json`.
X-Api-Public-Key	sí	Tu clave pública de la API.
X-Api-Timestamp	sí	Marca de tiempo (normalmente UNIX en ms), incluida en la firma.
X-Api-Signature	sí	Firma de la solicitud (HMAC SHA256 según el esquema de API v2).

Parámetros de la solicitud

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
orderId	int	sí	Identificador de la orden para la que se solicita información.

Formato de respuesta

El método devuelve un objeto JSON con información completa sobre la orden.

Ejemplo de respuesta

{
  "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
}

Desglose de campos de la respuesta

A continuación se muestran los campos clave de la respuesta. Algunas estructuras anidadas (p. ej., instrumentFrom / instrumentTo) son similares a los objetos de los métodos /instruments y /rates.

Información general de la orden

Campo	Tipo	Descripción
orderId	number	Identificador único de la orden en el sistema Quickex.
legacyOrderId	string	Identificador de la orden en el sistema legado (si se usa para migración/compatibilidad).
createdAt	string	Hora de creación de la orden (ISO8601).
instrumentFromCurrencyTitle	string	Código de la moneda de origen (`BTC`).
instrumentFromNetworkTitle	string	Red de origen (`BTC`).
instrumentToCurrencyTitle	string	Código de la moneda de destino (`USDT`).
instrumentToNetworkTitle	string	Red de destino (`TRC20`).
feeMode	string	Modo de comisión de la orden: • `FLOATING` – la comisión puede cambiar según las condiciones de la red o el tipo de mercado. • `FIXED` – la comisión se fija en el momento en que se crea la orden.
rateMode	string	Modo del tipo de cambio: • `FIXED` – el tipo se bloquea cuando se crea la orden; el importe a recibir no cambia. • `FLOATING` – el tipo puede fluctuar hasta que se complete la orden; el importe a recibir se actualiza según las condiciones actuales del mercado.
claimedDepositAmount	string	Importe del depósito usado para crear la orden.
amountToGet	string	Importe que el usuario debe recibir por esta orden.
claimedNetworkFee	string	Comisión de red aplicada en el cálculo de la orden.
platformFee	string	Comisión de la plataforma
redirectUrl	string	URL de redirección a un servicio externo.
completed	boolean	Indicador de finalización de la orden: `true` — intercambio completado, `false` — en progreso.
minConfirmationsToTrade	number	Confirmaciones mínimas para que el depósito se considere disponible para el intercambio.
minConfirmationsToWithdraw	number	Confirmaciones mínimas requeridas para el retiro.

Par de instrumentos (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
        }
      ]
    }
  },

Campo	Tipo	Descripción
instrumentFrom	object	Instrumento de origen: la moneda que el usuario envía.
instrumentFrom.currencyTitle	string	Código de la moneda del instrumento de origen (p. ej., XRP).
instrumentFrom.networkTitle	string	Red blockchain del instrumento de origen.
instrumentFrom.precisionDecimals	number	Número de decimales soportados para importes.
instrumentFrom.slug	string	Identificador interno de la moneda.
instrumentFrom.liquidityProviderCurrencies	array	Configuración del proveedor de liquidez para esta moneda y red.
instrumentFrom.liquidityProviderCurrencies.minConfirmationsToTrade	number	Confirmaciones mínimas requeridas para usar el depósito en el intercambio.
instrumentFrom.liquidityProviderCurrencies.minConfirmationsToWithdraw	number	Confirmaciones mínimas requeridas antes de permitir el retiro.
instrumentTo	object	Instrumento de destino: la moneda que el usuario recibe.
instrumentTo.currencyTitle	string	Código de la moneda del instrumento de destino (p. ej., TRX).
instrumentTo.networkTitle	string	Red blockchain del instrumento de destino.
instrumentTo.precisionDecimals	number	Número de decimales soportados para importes.
instrumentTo.slug	string	Identificador interno de la moneda.
instrumentTo.liquidityProviderCurrencies	array	Configuración del proveedor de liquidez para esta moneda y red.
instrumentTo.liquidityProviderCurrencies.minConfirmationsToTrade	number	Confirmaciones mínimas requeridas antes de que los fondos puedan intercambiarse.
instrumentTo.liquidityProviderCurrencies.minConfirmationsToWithdraw	number	Confirmaciones mínimas requeridas antes de que los fondos puedan retirarse.

orderEvents

  "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"
    }
  ],

Campo	Tipo	Descripción
orderEvents	array	Lista de eventos que describen el ciclo de vida de la orden en orden cronológico.
orderEvents[].createdAt	string (ISO 8601)	Marca de tiempo cuando ocurrió el evento.
orderEvents[].kind	string	Tipo de evento de la orden.

Valores posibles de orderEvents[].kind

Valor	Descripción
CREATION_END	La orden se ha creado correctamente.
INCOMING_FUNDS_DETECTED	Se ha detectado en la blockchain una transacción de depósito entrante.
DEPOSIT_REGISTERED	El depósito ha recibido las confirmaciones requeridas y fue acreditado.
FUNDS_WITHDRAWAL_START	Se ha iniciado la transacción de retiro.
WITHDRAWAL_COMPLETED	Los fondos se han enviado correctamente a la dirección de destino.

Objeto depositAddress

  "depositAddress": {
    "instrument": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP"
    },
    "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
    "depositAddressMemo": "2097040307"
  },

Campo	Tipo	Descripción
depositAddress	object	Detalles del depósito para el instrumento de origen.
depositAddress.instrument	object	Instrumento y red utilizados para el depósito.
depositAddress.instrument.currencyTitle	string	Código de la moneda del instrumento de depósito (p. ej., XRP).
depositAddress.instrument.networkTitle	string	Red blockchain utilizada para el depósito.
depositAddress.depositAddress	string	Dirección blockchain a la que el usuario debe enviar los fondos.
depositAddress.depositAddressMemo	string \| null	Memo / tag requerido para el depósito (p. ej., XRP Destination Tag). Debe incluirse si se proporciona.

Array deposits

"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
  }
]

Campo	Tipo	Descripción
deposits[]	array	Lista de transacciones de depósito asociadas a la orden.
deposits[].id	number	Identificador interno de la transacción de depósito.
deposits[].counterPartyAddress	string \| null	Dirección de la contraparte que envía el depósito, si se conoce.
deposits[].createdAt	string (ISO 8601)	Marca de tiempo cuando la transacción de depósito se registró en el sistema.
deposits[].instrument	object	Instrumento y red de la moneda depositada.
deposits[].instrument.currencyTitle	string	Código de la moneda del depósito (p. ej., XRP).
deposits[].instrument.networkTitle	string	Red blockchain del depósito (p. ej., XRP).
deposits[].amount	string	Importe de la moneda depositada, en el token original.
deposits[].amountUSDT	string	Valor equivalente del depósito en USDT en el momento del depósito.
deposits[].txId	string	ID de la transacción de depósito en la blockchain.
deposits[].confirmations	number	Número de confirmaciones de blockchain recibidas para este depósito.
deposits[].depositAddress	object	Objeto de dirección de depósito al que se enviaron los fondos (ver bloque `depositAddress`).
deposits[].isPending	boolean	Indica si el depósito sigue pendiente (true) o está confirmado/acreditado (false).

Array withdrawals

"withdrawals": [
  {
    "instrument": {
      "currencyTitle": "TRX",
      "networkTitle": "TRC20"
    },
    "amount": "393.07",
    "txId": "39dc5802a931da0613f687087397e812dd6c0aa0b9041124d76e864e37bd1e09",
    "createdAt": "2025-12-15T14:41:58.926Z",
    "networkFee": "1.98"
  }
]

Campo	Tipo	Descripción
withdrawals[]	array	Lista de transacciones de retiro de la orden.
withdrawals[].instrument	object	Instrumento y red de la moneda que se está retirando.
withdrawals[].instrument.currencyTitle	string	Código de la moneda del token retirado (p. ej., TRX).
withdrawals[].instrument.networkTitle	string	Red blockchain usada para el retiro (p. ej., TRC20).
withdrawals[].amount	string	Importe retirado en el token original.
withdrawals[].txId	string	ID de la transacción de retiro en la blockchain.
withdrawals[].createdAt	string (ISO 8601)	Marca de tiempo cuando se creó el retiro.
withdrawals[].networkFee	string	Comisión de red cobrada por la transacción de retiro.

Casos de uso posibles

Obtener los detalles completos de una orden específica para mostrar el historial completo de transacciones, el estado y los datos financieros relacionados en una cuenta de usuario, un panel de socios o para fines de conciliación y auditoría.

Code Sample

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

POST

accept-rate-mode-change

Endpoint URL

https://quickex.io/api/v2/orders/public/accept-rate-mode-change

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 la solicitud tenga éxito, se deben especificar el importe del reembolso y la dirección de reembolso.

URL

https://quickex.io/api/v2/orders/public/request-refund

Encabezados

Accept: application/json
Content-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 el reembolso.
`destinationAddress`	string	sí	La dirección de destino especificada en la orden original (utilizada como comprobación adicional).
`refundAmount`	string	sí	El importe que se debe reembolsar al usuario.
`refundAddress`	string	sí	La dirección de monedero del usuario a la que se enviarán los fondos del reembolso.
`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, importe de reembolso por debajo del mínimo permitido o `refundAddress` no válida).
`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 indicada en refundAddress, menos las comisiones de red aplicables.

Después del envío, el reembolso puede requerir una verificación manual por parte del equipo de soporte.

Code Sample

Try it out

POST

request-refund

Parámetro	Tipo	Obligatorio	Descripción
`orderId`	string	sí	Identificador de la orden para la que se deben obtener los datos de reembolso.

Código	Descripción
`200 OK`	Devuelve un JSON con información del reembolso (importe, 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.

GET

order-refund-info

Endpoint URL

https://quickex.io/api/v2/orders/order-refund-info

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í	Dirección de destino asociada a la orden (se utiliza como comprobación adicional).

Código	Descripción
`201 Created`	El cambio del modo de tipo de cambio ha sido confirmado y la orden continúa su procesamiento.
`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.

API V2 Orders

Documentation

Parámetros

Ejemplo de solicitud

Respuestas posibles

Caso de uso

Code Sample

Response Example

Try it out

Query Parameters

Request Body

Headers

Documentation

Parámetros

Ejemplo de solicitud

Respuestas posibles

Caso de uso

Code Sample

Response Example

Try it out

Request Body

Headers

Documentation

Descripción general

Solicitud HTTP

Ejemplo de solicitud

Encabezados

Parámetros de la solicitud

Parámetros del cuerpo

Formato de respuesta

Ejemplo de respuesta

Errores

403 ERR_FORBIDDEN — Correo ya establecido

Casos de uso posibles

Code Sample

Response Example

Try it out

Request Body

Headers

Documentation

Descripción general

Solicitud HTTP

Ejemplo de solicitud

Encabezados

Parámetros de la solicitud

Parámetros de consulta

Formato de respuesta

Ejemplo de respuesta

Desglose de campos de la respuesta

Información general de la orden

Par de instrumentos (pair)

orderEvents

Valores posibles de orderEvents[].kind

Objeto depositAddress

Array deposits

Array withdrawals

Casos de uso posibles

Code Sample

Response Example

Try it out

Query Parameters

Headers

Documentation

URL

Encabezados

Cuerpo de la solicitud (JSON)

Ejemplo de solicitud (cURL)

Respuestas

Notas

Code Sample

Try it out

Request Body

Headers

Documentation

URL

Parámetros de la solicitud (Query)

Respuestas

Notas

Code Sample

Try it out