Раздел ордеры (orders) включает методы для создания ордера и добавления электронной почты пользователя к уже существующему ордеру. С помощью доступных методов можно инициировать обмен через создание ордера, а также прикрепить email для уведомлений о его статусе.
Documentation
POST /api/v2/orders/public/set-email
Общее описание
Этот эндпоинт позволяет прикрепить электронную почту пользователя к уже созданному ордеру. После вызова метода в поле userEmail ордера сохраняется переданный адрес, и на него будут отправляться уведомления о смене статуса транзакций.
Параметры
Заголовки (Headers)
| Название | Обязателен | Описание |
|---|---|---|
X-Api-Public-Key |
да | Ваш публичный API-ключ для аутентификации запроса. |
X-Api-Timestamp |
да | Метка времени в формате UNIX (ms). Используется для защиты от повторных запросов. |
X-Api-Signature |
да | HMAC-подпись всего тела запроса, сгенерированная с помощью вашего секретного ключа. |
Тело запроса (JSON)
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
orderId |
number | да | Идентификатор существующего ордера. |
userEmail |
string | да | Электронная почта для уведомлений. |
Пример запроса
curl -X POST 'https://quickex.io/api/v2/orders/public/set-email' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'X-Api-Public-Key: yourPublicKey' \
-H 'X-Api-Timestamp: 1691397292905' \
-H 'X-Api-Signature: yourHmacSignature' \
-d '{
"orderId": 12345,
"userEmail": "user@example.com"
}'
Возможные ответы
200 OK — почта успешно добавлена.
403 ERR_FORBIDDEN — отсутствуют обязательные заголовки или неверная подпись.
{
"status": "ERR_FORBIDDEN",
"message": "Header params is missed!"
}
Use Case
Партнёр-интегратор встраивает обменник Quickex в своё приложение и хочет после создания ордера автоматически подключить уведомления о зачислениях и выводах на электронную почту пользователя.
- Клиент создаёт ордер через
/api/v2/orders/public/create. - Сразу после получения
orderIdотправляется запрос к/api/v2/orders/public/set-email, чтобы закрепить адрес для уведомлений. - Как только средства будут зачислены или выведены, Quickex отправит письма на указанный
userEmail.
Code Sample
curl -X 'GET' \
'https://quickex.io/api/v2/orders?order=asc' \
-H 'accept: application/json' \
-H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
-H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
-H 'X-Api-Signature: {SIGNATURE}' \Response Example
[
{
"orderId": 2096,
"destinationAddress": "rMZiLhMHDKHSD9mMurzvixQGKFsDNLLP1",
"createdAt": "2024-11-21T09:57:37.536Z",
"updatedAt": "2024-11-21T09:57:37.536Z",
"destinationAddressMemo": null,
"refundAddress": null,
"refundAddressMemo": null,
"claimedDepositAmount": "11905.4",
"claimedNetworkFee": "0.25",
"amountToGet": "2000.535980286546",
"amountToGetUSDT": "0",
"amountToWithdrawFact": "0",
"amountToWithdrawFactUSDT": "0",
"instrumentFromCurrencyTitle": "TRX",
"instrumentFromNetworkTitle": "TRX",
"instrumentToCurrencyTitle": "XRP",
"instrumentToNetworkTitle": "XRP",
"ip": "165.22.73.162",
"geoCode": "DE",
"markup": "0",
"userEmail": "qa@support.quickex.io",
"completed": false,
"state": "created"
},
{
"orderId": 2097,
"destinationAddress": "rMZiLhMHDKHSD9mMurzvixQGKFsDNLLP1",
"createdAt": "2024-11-21T09:57:56.849Z",
"updatedAt": "2024-11-21T09:57:56.849Z",
"destinationAddressMemo": null,
"refundAddress": null,
"refundAddressMemo": null,
"claimedDepositAmount": "500",
"claimedNetworkFee": "0.25",
"amountToGet": "88.201060256891",
"amountToGetUSDT": "0",
"amountToWithdrawFact": "0",
"amountToWithdrawFactUSDT": "0",
"instrumentFromCurrencyTitle": "TRX",
"instrumentFromNetworkTitle": "TRX",
"instrumentToCurrencyTitle": "XRP",
"instrumentToNetworkTitle": "XRP",
"ip": "165.22.73.162",
"geoCode": "DE",
"markup": "0",
"userEmail": "qa@support.quickex.io",
"completed": false,
"state": "created"
},
{
"orderId": 3038,
"destinationAddress": "TFjfHBiDcL6B5S5W8g9b6gU2tbvnTR52ya",
"createdAt": "2025-04-28T13:15:03.006Z",
"updatedAt": "2025-07-22T10:36:58.557Z",
"destinationAddressMemo": null,
"refundAddress": null,
"refundAddressMemo": null,
"claimedDepositAmount": "0.034268",
"claimedNetworkFee": "1.5",
"amountToGet": "3263.05",
"amountToGetUSDT": "3263.058154",
"amountToWithdrawFact": "0",
"amountToWithdrawFactUSDT": "0",
"instrumentFromCurrencyTitle": "BTC",
"instrumentFromNetworkTitle": "BTC",
"instrumentToCurrencyTitle": "USDT",
"instrumentToNetworkTitle": "TRC20",
"ip": "45.76.90.73",
"geoCode": "DE",
"markup": "0",
"userEmail": "qa@support.quickex.io",
"completed": false,
"state": "created"
},
{
"orderId": 3172,
"destinationAddress": "TPjT9p6UK5omA19h1QuYf4HbWvB9CukMzx",
"createdAt": "2025-11-25T07:52:52.871Z",
"updatedAt": "2025-11-27T11:34:19.690Z",
"destinationAddressMemo": null,
"refundAddress": null,
"refundAddressMemo": null,
"claimedDepositAmount": "52",
"claimedNetworkFee": "2.054188275293",
"amountToGet": "419.2",
"amountToGetUSDT": "114.402051690569",
"amountToWithdrawFact": "417.825363",
"amountToWithdrawFactUSDT": "114.0245415627",
"instrumentFromCurrencyTitle": "XRP",
"instrumentFromNetworkTitle": "XRP",
"instrumentToCurrencyTitle": "TRX",
"instrumentToNetworkTitle": "TRX",
"ip": "77.246.100.22",
"geoCode": "NL",
"markup": "0",
"userEmail": "qa@support.quickex.io",
"completed": true,
"state": "withdraw"
},
{
"orderId": 3192,
"destinationAddress": "15vvDFQFksUS4r1cYxmjZuTVVUzWZSJauuUapg7Xjhgtkwqy",
"createdAt": "2025-12-02T14:11:15.985Z",
"updatedAt": "2025-12-02T14:11:16.107Z",
"destinationAddressMemo": null,
"refundAddress": "UQCGxjLy3msAFWG4r310Sk_rOz27QWRy252fdLMWJAMQJvSE",
"refundAddressMemo": null,
"claimedDepositAmount": "3300",
"claimedNetworkFee": "0.14",
"amountToGet": "2363.663",
"amountToGetUSDT": "4999.384629917638",
"amountToWithdrawFact": "0",
"amountToWithdrawFactUSDT": "0",
"instrumentFromCurrencyTitle": "TON",
"instrumentFromNetworkTitle": "TON",
"instrumentToCurrencyTitle": "DOT",
"instrumentToNetworkTitle": "DOT",
"ip": "77.246.100.22",
"geoCode": "NL",
"markup": "0",
"userEmail": null,
"completed": false,
"state": "created"
},
{
"orderId": 3193,
"destinationAddress": "15vvDFQFksUS4r1cYxmjZuTVVUzWZSJauuUapg7Xjhgtkwqy",
"createdAt": "2025-12-02T14:14:34.356Z",
"updatedAt": "2025-12-02T14:14:34.557Z",
"destinationAddressMemo": null,
"refundAddress": "UQCGxjLy3msAFWG4r310Sk_rOz27QWRy252fdLMWJAMQJvSE",
"refundAddressMemo": null,
"claimedDepositAmount": "73",
"claimedNetworkFee": "0.14",
"amountToGet": "52.235",
"amountToGetUSDT": "110.556162356583",
"amountToWithdrawFact": "0",
"amountToWithdrawFactUSDT": "0",
"instrumentFromCurrencyTitle": "TON",
"instrumentFromNetworkTitle": "TON",
"instrumentToCurrencyTitle": "DOT",
"instrumentToNetworkTitle": "DOT",
"ip": "77.246.100.22",
"geoCode": "NL",
"markup": "0",
"userEmail": null,
"completed": false,
"state": "created"
}
]Try it out
Leave empty to use default
Query Parameters
Request Body
Headers
Documentation
POST /api/v2/orders/public/create
Общее описание
Создаёт новый ордер для обмена криптовалют. Возвращает все детали ордера: адреса для депозита и вывода, параметры курса, события и ссылки для дальнейшей обработки.
Параметры
Заголовки (Headers)
| Название | Обязателен | Описание |
|---|---|---|
B2B-Bearer-Token |
да | Bearer-токен для аутентификации через Mercuryo. |
X-Api-Public-Key |
да | Ваш публичный API-ключ. |
X-Api-Timestamp |
да | Метка времени в формате UNIX (ms). |
X-Api-Signature |
да | HMAC-подпись тела запроса вашим секретным ключом. |
Тело запроса (JSON)
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
instrumentFrom |
object | да | Исходная валюта и сеть (currencyTitle/networkTitle). |
instrumentTo |
object | да | Целевая валюта и сеть. |
destinationAddress |
string | да | Адрес для получения обменянных средств. |
destinationAddressMemo |
string | нет | Доп. метка для адреса (Memo/Tag). |
refundAddress |
string | да | Адрес возврата при ошибке обмена. |
refundAddressMemo |
string | нет | Memo/Tag для возвратного адреса. |
claimedDepositAmount |
string | да | Сумма, которую пользователь заявляет внести. |
claimedPublicRate |
object | нет | Заявленный курс: цена, время обновления и ожидаемая сумма к получению. |
claimedNetworkFee |
string | нет | Заявленная сетевая комиссия. |
userEmail |
string | нет | Email для уведомлений. |
legacyOrderId |
string | нет | Внешний идентификатор ордера из старой системы. |
referrerId |
string | нет | ID реферера для партнёрской программы. |
markupAffiliateId |
string | нет | ID аффилиата для начисления маржи. |
rateMode |
string | нет | Тип курса: FLOATING или FIXED. |
utmData |
object | нет | UTM-метки для аналитики. |
browserFingerprint |
string | нет | Фингерпринт браузера для защиты от мошенничества. |
markup |
string | нет | Процент маржи. |
mercuryoBearerToken |
string | нет | Токен Mercuryo для опциональной интеграции. |
locale |
string | нет | Языковой локаль ответа (например, en, ru). |
Пример запроса
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"
}'
Возможные ответы
200 OK — ордер успешно создан, возвращается полная структура ордера.
401 ERR_UNAUTHORIZED — неверные или отсутствующие токены/ключи.
{
"status": "ERR_UNAUTHORIZED",
"message": "Unauthorized"
}
Use Case
Партнёрская платформа хочет автоматически создавать ордера при оплате пользователя через Mercuryo. После завершения аутентификации Mercuryo выдаёт B2B-Bearer-Token, платформа формирует детали обмена и вызывает этот метод для создания ордера на Quickex.
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v2/orders/public/create' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
-H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
-H 'X-Api-Signature: {SIGNATURE}' \
-d '{
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo": { "currencyTitle": "LTC", "networkTitle": "LTC" },
"destinationAddress": "MWYK4uQXFvWc1Bj1CPACyX5HTQxUUpRZ2e",
"destinationAddressMemo": null,
"refundAddress": "TFe5tdqSy8CMGMDVHPJHLTK8hrAL6ddUpD",
"refundAddressMemo": null,
"claimedDepositAmount": "3300",
"claimedPublicRate": {
"price": "0.014271620139287839394",
"updatedAt": "2024-02-13T14:43:12.983Z",
"claimedAmountToReceive": "47.09634645964987"
},
"claimedNetworkFee": "0.001",
"userEmail": "test@example.com",
"referrerId": "aff_some-affiliate-id",
"markupAffiliateId": "aff_some-affiliate-id",
"rateMode": "FLOATING",
"utmData": {},
"browserFingerprint": "string",
"markup": "0.01",
"mercuryoBearerToken": "string",
"locale": "string"
}'Response Example
{
"deposits": [
{
"createdAt": "2025-12-02T08:52:08.178Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true,
"id": 0,
"counterPartyAddress": "0xdeadc0dedeadbeef"
}
],
"withdrawals": [
{
"createdAt": "2025-12-02T08:52:08.178Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"networkFee": "1.1",
"txId": "0xdeadc0dedeadbeef"
}
],
"depositAddress": {
"orderId": 0,
"liquidityProviderTitle": "QUICKEX_BUSINESS_ACCOUNT",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"depositAddress": "0xdeadc0de",
"depositAddressMemo": "string",
"redirectUrl": "string"
},
"orderId": 0,
"userId": 0,
"legacyOrderId": "string",
"pair": {
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
}
},
"createdAt": "2025-12-02T08:52:08.179Z",
"claimedDepositAmount": "10.01",
"amountToGet": "10.01",
"claimedPublicRate": {
"price": "1000.1",
"quotes": {
"sellQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
},
"buyQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
}
},
"updatedAt": "2025-12-02T08:52:08.179Z",
"liquidityProviderPublicCode": "formulae",
"claimedAmountToReceive": "0.01",
"finalNetworkFeeAmount": "0.01",
"platformFee_Absolute": "0.01",
"fixedRate_maxAmount": "1000.000",
"fixedRate_maxTimeMinutes": 1,
"fixedRate_maxRateVolatilityPercent": "1000.000"
},
"claimedNetworkFee": "10.01",
"KYCFormLink": "string",
"orderEvents": [
{
"kind": "TRACKING_STARTED",
"createdAt": "2025-12-02T08:52:08.179Z"
}
],
"userEmail": "test@example.com",
"rateMode": "FLOATING",
"destinationAddress": "0xdeadbeef",
"destinationAddressMemo": "0xdeadbeef",
"completed": false,
"possibleCashbackAmountUSDT": "500.00",
"redirectUrl": "https://payments.mercuryo.io/",
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}Try it out
Leave empty to use default
Request Body
Headers
Documentation
Обзор
Этот метод позволяет установить email для уже созданного публичного ордера.
Он используется, когда ордер был создан без userEmail в запросе /api/v2/orders/public/create, но позже нужно привязать email (например, чтобы пользователь мог получать уведомления о статусе ордера).
> Важно: email можно установить только один раз. Если у ордера уже есть userEmail, его нельзя изменить через этот метод.
HTTP-запрос
Метод: POST
URL: https://quickex.io/api/v2/orders/public/set-email
Пример запроса
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"
}'
Заголовки
| Заголовок | Обязательный | Описание |
|---|---|---|
Accept |
да | Рекомендуемое значение: application/json. |
Content-Type |
да | application/json. |
X-Api-Public-Key |
да | Ваш публичный ключ API. |
X-Api-Timestamp |
да | Метка времени (обычно UNIX в мс), включается в подпись. |
X-Api-Signature |
да | Подпись запроса (HMAC SHA256 согласно схеме API v2). |
Параметры запроса
Параметры тела
{
"orderId": 3038,
"userEmail": "QA@quickex.com"
}
| Поле | Тип | Обязательный | Описание |
|---|---|---|---|
orderId |
number | да | ID ордера, для которого вы хотите установить email. |
userEmail |
string | да | Email пользователя, который будет привязан к ордеру и использован для уведомлений. |
Ограничения: если для этого ордера userEmail уже установлен, метод вернет ошибку 403 ERR_FORBIDDEN.
Формат ответа
Если запрос выполнен успешно, метод возвращает JSON-объект ордера, похожий на ответ от POST /api/v2/orders/public/create / GET /api/v2/orders/info, но с установленным полем userEmail.
Пример ответа
{
"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
}
Ключевой момент: поле userEmail, привязанное к ордеру, будет заполнено в ответе.
Ошибки
403 ERR_FORBIDDEN — Email уже установлен
{
"status": "ERR_FORBIDDEN",
"message": "Order.userEmail already set and can not be modified"
}
Эта ошибка возвращается, если вы пытаетесь изменить email у ордера, для которого userEmail уже был установлен (либо при создании ордера, либо в предыдущем вызове set-email).
Что делать:
- Email нельзя изменить для ордеров, у которых email уже установлен.
Возможные сценарии использования
- Добавление email для ордеров, созданных анонимно (например, через виджет без обязательного поля email).
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v2/orders/public/set-email' \
-H 'accept: application/json' \
-H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
-H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
-H 'X-Api-Signature: {SIGNATURE}'
-H 'Content-Type: application/json' \
-d '{
"orderId": 3038,
"userEmail": "QA@quickex.com"
}'Response Example
{
"deposits": [
{
"createdAt": "2025-12-02T09:31:46.246Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true,
"id": 0,
"counterPartyAddress": "0xdeadc0dedeadbeef"
}
],
"withdrawals": [
{
"createdAt": "2025-12-02T09:31:46.246Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"networkFee": "1.1",
"txId": "0xdeadc0dedeadbeef"
}
],
"depositAddress": {
"orderId": 0,
"liquidityProviderTitle": "QUICKEX_BUSINESS_ACCOUNT",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"depositAddress": "0xdeadc0de",
"depositAddressMemo": "string",
"redirectUrl": "string"
},
"orderId": 0,
"userId": 0,
"legacyOrderId": "string",
"pair": {
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
}
},
"createdAt": "2025-12-02T09:31:46.246Z",
"claimedDepositAmount": "10.01",
"amountToGet": "10.01",
"claimedPublicRate": {
"price": "1000.1",
"quotes": {
"sellQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
},
"buyQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
}
},
"updatedAt": "2025-12-02T09:31:46.246Z",
"liquidityProviderPublicCode": "formulae",
"claimedAmountToReceive": "0.01",
"finalNetworkFeeAmount": "0.01",
"platformFee_Absolute": "0.01",
"fixedRate_maxAmount": "1000.000",
"fixedRate_maxTimeMinutes": 1,
"fixedRate_maxRateVolatilityPercent": "1000.000"
},
"claimedNetworkFee": "10.01",
"KYCFormLink": "string",
"orderEvents": [
{
"kind": "TRACKING_STARTED",
"createdAt": "2025-12-02T09:31:46.246Z"
}
],
"userEmail": "QA@example.com",
"rateMode": "FLOATING",
"destinationAddress": "0xdeadbeef",
"destinationAddressMemo": "0xdeadbeef",
"completed": false,
"possibleCashbackAmountUSDT": "500.00",
"redirectUrl": "https://payments.mercuryo.io/",
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}Try it out
Leave empty to use default
Request Body
Headers
Documentation
Обзор
Этот метод возвращает подробную информацию по конкретному ордеру по его orderId.
В отличие от списка ордеров (GET /api/v2/orders), он возвращает все данные, связанные с выбранным ордером:
полную пару инструментов с параметрами, фиксированный курс (claimedPublicRate),
лимиты подтверждений, историю событий (orderEvents), депозитный адрес,
а также информацию о возможном кэшбэке/начислениях по рефералам и статус завершения.
Доступ к ордерам ограничен текущим API-ключом: вы можете видеть только те ордера, которые были созданы
с использованием вашего X-Api-Public-Key.
HTTP-запрос
Метод: GET
URL: https://quickex.io/api/v2/orders/public-info
Пример запроса
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}'
Заголовки
| Заголовок | Обязательный | Описание |
|---|---|---|
| Accept | да | Рекомендуемое значение: application/json. |
| X-Api-Public-Key | да | Ваш публичный ключ API. |
| X-Api-Timestamp | да | Метка времени (обычно UNIX в мс), включается в подпись. |
| X-Api-Signature | да | Подпись запроса (HMAC SHA256 согласно схеме API v2). |
Параметры запроса
Query-параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| orderId | int | да | Идентификатор ордера, по которому запрашивается информация. |
Формат ответа
Метод возвращает JSON-объект с полной информацией об ордере.
Пример ответа
{
"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
}
Расшифровка полей ответа
Ниже приведены ключевые поля ответа. Некоторые вложенные структуры (например, instrumentFrom / instrumentTo) по структуре похожи на объекты из методов /instruments и /rates.
Общая информация об ордере
| Поле | Тип | Описание |
|---|---|---|
| orderId | number | Уникальный идентификатор ордера в системе Quickex. |
| legacyOrderId | string | Идентификатор ордера в legacy-системе (если используется для миграции/совместимости). |
| createdAt | string | Время создания ордера (ISO8601). |
| instrumentFromCurrencyTitle | string | Код исходной валюты (например, BTC). |
| instrumentFromNetworkTitle | string | Исходная сеть (например, BTC). |
| instrumentToCurrencyTitle | string | Код целевой валюты (например, USDT). |
| instrumentToNetworkTitle | string | Целевая сеть (например, TRC20). |
| feeMode | string | Режим комиссии ордера: • FLOATING – комиссия может меняться в зависимости от условий сети или типа рынка.• FIXED – комиссия фиксируется в момент создания ордера. |
| rateMode | string | Режим курса: • FIXED – курс фиксируется при создании ордера; сумма к получению не меняется.• FLOATING – курс может колебаться до завершения ордера; сумма к получению обновляется согласно текущим рыночным условиям. |
| claimedDepositAmount | string | Сумма депозита, использованная при создании ордера. |
| amountToGet | string | Сумма, которую пользователь должен получить по этому ордеру. |
| claimedNetworkFee | string | Сетевая комиссия, учтенная в расчете ордера. |
| platformFee | string | Комиссия платформы. |
| redirectUrl | string | URL для редиректа на внешний сервис. |
| completed | boolean | Флаг завершения ордера: true — обмен завершен, false — в процессе. |
| minConfirmationsToTrade | number | Минимальные подтверждения, чтобы депозит считался доступным для обмена. |
| minConfirmationsToWithdraw | number | Минимальные подтверждения, необходимые для вывода. |
Пара инструментов (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
}
]
}
},
| Поле | Тип | Описание |
|---|---|---|
| instrumentFrom | object | Исходный инструмент: валюта, которую пользователь отправляет. |
| instrumentFrom.currencyTitle | string | Код валюты исходного инструмента (например, XRP). |
| instrumentFrom.networkTitle | string | Блокчейн-сеть исходного инструмента. |
| instrumentFrom.precisionDecimals | number | Количество поддерживаемых знаков после запятой для сумм. |
| instrumentFrom.slug | string | Внутренний идентификатор валюты. |
| instrumentFrom.liquidityProviderCurrencies | array | Настройки провайдера ликвидности для этой валюты и сети. |
| instrumentFrom.liquidityProviderCurrencies.minConfirmationsToTrade | number | Минимальные подтверждения, чтобы использовать депозит в обмене. |
| instrumentFrom.liquidityProviderCurrencies.minConfirmationsToWithdraw | number | Минимальные подтверждения перед разрешением вывода. |
| instrumentTo | object | Целевой инструмент: валюта, которую пользователь получает. |
| instrumentTo.currencyTitle | string | Код валюты целевого инструмента (например, TRX). |
| instrumentTo.networkTitle | string | Блокчейн-сеть целевого инструмента. |
| instrumentTo.precisionDecimals | number | Количество поддерживаемых знаков после запятой для сумм. |
| instrumentTo.slug | string | Внутренний идентификатор валюты. |
| instrumentTo.liquidityProviderCurrencies | array | Настройки провайдера ликвидности для этой валюты и сети. |
| instrumentTo.liquidityProviderCurrencies.minConfirmationsToTrade | number | Минимальные подтверждения до того, как средства могут быть обменены. |
| instrumentTo.liquidityProviderCurrencies.minConfirmationsToWithdraw | number | Минимальные подтверждения до того, как средства могут быть выведены. |
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"
}
],
| Поле | Тип | Описание |
|---|---|---|
| orderEvents | array | Список событий, описывающих жизненный цикл ордера (в хронологическом порядке). |
| orderEvents[].createdAt | string (ISO 8601) | Метка времени, когда произошло событие. |
| orderEvents[].kind | string | Тип события ордера. |
Возможные значения orderEvents[].kind
| Значение | Описание |
|---|---|
| CREATION_END | Ордер успешно создан. |
| INCOMING_FUNDS_DETECTED | В блокчейне обнаружена входящая депозитная транзакция. |
| DEPOSIT_REGISTERED | Депозит получил необходимые подтверждения и был зачислен. |
| FUNDS_WITHDRAWAL_START | Инициирована транзакция вывода средств. |
| WITHDRAWAL_COMPLETED | Средства успешно отправлены на адрес назначения. |
Объект depositAddress
"depositAddress": {
"instrument": {
"currencyTitle": "XRP",
"networkTitle": "XRP"
},
"depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
"depositAddressMemo": "2097040307"
},
| Поле | Тип | Описание |
|---|---|---|
| depositAddress | object | Детали депозита для исходного инструмента. |
| depositAddress.instrument | object | Инструмент и сеть, используемые для депозита. |
| depositAddress.instrument.currencyTitle | string | Код валюты депозитного инструмента (например, XRP). |
| depositAddress.instrument.networkTitle | string | Блокчейн-сеть, используемая для депозита. |
| depositAddress.depositAddress | string | Блокчейн-адрес, на который пользователь должен отправить средства. |
| depositAddress.depositAddressMemo | string | null | Memo / tag, требуемый для депозита (например, XRP Destination Tag). Должен быть указан, если он предоставлен. |
Массив 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
}
]
| Поле | Тип | Описание |
|---|---|---|
| deposits[] | array | Список депозитных транзакций, связанных с ордером. |
| deposits[].id | number | Внутренний идентификатор депозитной транзакции. |
| deposits[].counterPartyAddress | string | null | Адрес контрагента, отправившего депозит, если известен. |
| deposits[].createdAt | string (ISO 8601) | Время, когда депозитная транзакция была зафиксирована в системе. |
| deposits[].instrument | object | Инструмент и сеть внесенной валюты. |
| deposits[].instrument.currencyTitle | string | Код валюты депозита (например, XRP). |
| deposits[].instrument.networkTitle | string | Блокчейн-сеть депозита (например, XRP). |
| deposits[].amount | string | Сумма депозита в исходном токене. |
| deposits[].amountUSDT | string | Эквивалент депозита в USDT на момент депозита. |
| deposits[].txId | string | ID депозитной транзакции в блокчейне. |
| deposits[].confirmations | number | Количество подтверждений блокчейна по этому депозиту. |
| deposits[].depositAddress | object | Объект депозитного адреса, на который были отправлены средства (см. блок depositAddress). |
| deposits[].isPending | boolean | Показывает, находится ли депозит в ожидании (true) или подтвержден/зачислен (false). |
Массив withdrawals
"withdrawals": [
{
"instrument": {
"currencyTitle": "TRX",
"networkTitle": "TRC20"
},
"amount": "393.07",
"txId": "39dc5802a931da0613f687087397e812dd6c0aa0b9041124d76e864e37bd1e09",
"createdAt": "2025-12-15T14:41:58.926Z",
"networkFee": "1.98"
}
]
| Поле | Тип | Описание |
|---|---|---|
| withdrawals[] | array | Список транзакций вывода по ордеру. |
| withdrawals[].instrument | object | Инструмент и сеть выводимой валюты. |
| withdrawals[].instrument.currencyTitle | string | Код выводимой валюты (например, TRX). |
| withdrawals[].instrument.networkTitle | string | Блокчейн-сеть, используемая для вывода (например, TRC20). |
| withdrawals[].amount | string | Сумма вывода в исходном токене. |
| withdrawals[].txId | string | ID транзакции вывода в блокчейне. |
| withdrawals[].createdAt | string (ISO 8601) | Время создания вывода. |
| withdrawals[].networkFee | string | Сетевая комиссия, списанная за транзакцию вывода. |
Возможные сценарии использования
- Получение полных деталей конкретного ордера, чтобы отображать полную историю транзакций, статус и связанные финансовые данные в аккаунте пользователя/партнерской панели или для целей сверки и аудита.
Code Sample
curl -X 'GET' \
'https://quickex.io/api/v2/orders/info?orderId=3038' \
-H 'accept: application/json' \
-H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
-H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
-H 'X-Api-Signature: {SIGNATURE}'Response Example
{
"orderId": 3038,
"legacyOrderId": "4602ddf9-e516-4c3a-9146-7bc748edd89b",
"pair": {
"instrumentFrom": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"precisionDecimals": 7,
"slug": "btc",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}
]
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"precisionDecimals": 5,
"slug": "usdttrc20",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}
]
}
},
"createdAt": "2025-04-28T13:15:03.006Z",
"instrumentFromCurrencyTitle": "BTC",
"instrumentFromNetworkTitle": "BTC",
"instrumentToCurrencyTitle": "USDT",
"instrumentToNetworkTitle": "TRC20",
"feeMode": "FLOATING",
"userId": 229,
"userEmail": "qa@support.quickex.io",
"isPlatformEmail": false,
"refundAddress": null,
"refundAddressMemo": null,
"destinationAddress": "TFjfHBiDcL6B5S5W8g9b6gU2tbvnTR52ya",
"destinationAddressMemo": null,
"claimedNetworkFee": "1.5",
"rateMode": "FLOATING",
"claimedDepositAmount": "0.034268",
"amountToGet": "3263.05",
"platformFee": null,
"redirectUrl": null,
"orderEvents": [
{
"createdAt": "2025-04-28T13:15:03.021Z",
"kind": "CREATION_END"
}
],
"depositAddress": {
"instrument": {
"currencyTitle": "BTC",
"networkTitle": "BTC"
},
"depositAddress": "3LpR1ZKEVysoi6sxFqoGtB49638RsxzKSh",
"depositAddressMemo": null
},
"deposits": [],
"withdrawals": [],
"KYCFormLink": null,
"liquidityProviderPublicCode": "hat",
"possibleRefferalAccrualAmount": "3.01",
"possibleCashbackAmountUSDT": "0",
"actualCashbackAmountUSDT": null,
"claimedPublicRate": {
"claimedAmountToReceive": "3259.38",
"finalNetworkFeeAmount": "1.5",
"price": "95158.1",
"quotes": {
"sellQuote": {
"baseValue": "1",
"quoteValue": "95114.32743505127"
},
"buyQuote": {
"baseValue": "95158",
"quoteValue": "0.9995400016924599"
}
},
"updatedAt": "2025-04-28T13:11:30.251Z",
"instrumentFrom": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"precisionDecimals": 7,
"slug": "btc",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}
]
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"precisionDecimals": 5,
"slug": "usdttrc20",
"liquidityProviderCurrencies": [
{
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}
]
}
},
"completed": false,
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}Try it out
Leave empty to use default
Query Parameters
Headers
Documentation
Отправляет запрос на возврат средств по ордеру. Используется в ситуациях, когда обмен не был завершён
или средства необходимо вернуть пользователю. Для успешного выполнения должны быть указаны сумма
возврата и адрес для возврата.
URL
https://quickex.io/api/v2/orders/public/request-refund
Заголовки
Accept: application/jsonContent-Type: application/json
Тело запроса (JSON)
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
orderId |
number | yes | Идентификатор ордера, для которого запрашивается возврат средств. |
destinationAddress |
string | yes | Адрес назначения, указанный в исходном ордере (используется как дополнительная проверка). |
refundAmount |
string | yes | Сумма, которую нужно вернуть пользователю. |
refundAddress |
string | yes | Адрес кошелька пользователя, на который будут возвращены средства. |
claimedNetworkFee |
string | no | Сумма сетевой комиссии, которую пользователь соглашается оплатить за возврат. |
{
"orderId": 123456,
"destinationAddress": "0xdeadbeef",
"refundAmount": "10.00",
"refundAddress": "0xuserrefundwallet",
"claimedNetworkFee": "0.50"
}
Пример запроса (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"
}'
Ответы
| Код | Описание |
|---|---|
201 Created |
Запрос на возврат принят и будет обработан. |
404 Not Found |
Ордер не найден ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Ошибка валидации (например, сумма возврата ниже допустимого минимума или некорректный refundAddress). |
5xx |
Внутренняя ошибка сервера. |
Примечания
- Этот метод используется только для ордеров, которые не могут быть завершены.
- Возврат выполняется на адрес, указанный в
refundAddress, за вычетом применимых сетевых комиссий.- После отправки запрос на возврат может потребовать ручной проверки со стороны службы поддержки.
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v1/orders/public/accept-rate-mode-change' \
-H 'accept: */*' \
-H 'Content-Type: application/json' \
-d '{
"orderId": {},
"destinationAddress": "string"
}'Try it out
Leave empty to use default
Request Body
Headers
Documentation
Возвращает информацию о возврате средств по конкретному ордеру.
Используется после создания запроса на возврат для проверки деталей (сумма, адрес возврата, статус).
URL
https://quickex.io/api/v2/orders/order-refund-info
Параметры запроса (Query)
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
orderId |
string | yes | Идентификатор ордера, для которого нужно получить данные о возврате. |
curl -X GET \
'https://quickex.io/api/v1/orders/order-refund-info?orderId=1234' \
-H 'Accept: application/json'
Ответы
| Код | Описание |
|---|---|
200 OK |
Возвращает JSON с информацией о возврате (сумма, адрес, статус, комиссии). |
400 Bad Request |
Ошибка валидации или некорректные данные ордера ({"status":"ERR_BAD_REQUEST","message":"Unknown liquidity provider title: ..."}). |
404 Not Found |
Ордер не найден. |
5xx |
Внутренняя ошибка сервера. |
Примечания
- Метод возвращает данные только для ордеров, по которым был инициирован возврат.
- В успешном ответе с кодом
200JSON может содержать сумму возврата, адрес возврата и сетевые комиссии.- При ошибках валидации (
400) сервер возвращает причину в полеmessage.
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v1/orders/public/request-refund' \
-H 'accept: */*' \
-H 'Content-Type: application/json' \
-d '{
"orderId": {},
"destinationAddress": "string",
"refundAmount": "10.00",
"refundAddress": "string",
"claimedNetworkFee": "10.00"
}'Try it out
Leave empty to use default
Request Body
Headers
Documentation
Подтверждает изменение режима курса для ордера. Используется в случаях, когда ордер был создан
с фиксированным курсом, но в процессе обмена был переключён на плавающий курс
(например, из-за превышения лимитов или высокой волатильности).
Метод позволяет пользователю принять новый режим и продолжить обработку ордера.
URL
https://quickex.io/api/v1/orders/public/accept-rate-mode-change
Заголовки
Accept: application/jsonContent-Type: application/json
Тело запроса (JSON)
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
orderId |
number | yes | Идентификатор ордера, для которого нужно подтвердить изменение режима курса. |
destinationAddress |
string | yes | Адрес назначения, связанный с ордером (используется как дополнительная проверка). |
{
"orderId": 123456,
"destinationAddress": "0xdeadbeef"
}
Пример запроса (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"
}'
Ответы
| Код | Описание |
|---|---|
201 Created |
Изменение режима курса подтверждено, ордер продолжает обработку. |
404 Not Found |
Ордер не найден ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Ошибка валидации (например, неверные входные данные). |
5xx |
Внутренняя ошибка сервера. |
Примечания
- Этот метод вызывается только в том случае, если у ордера был изменён режим курса (например, с фиксированного на плавающий).
- Без подтверждения обработка ордера будет приостановлена.
- В случае успеха в ответе возвращается статус 201, и ордер переходит в состояние дальнейшей обработки.
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