Команда Quickex
22 августа 2025 г.
~1 мин. чтения
Группа методов Orders отвечает за работу с заказами — обменными операциями, создаваемыми пользователями на платформе Quickex.
С помощью этих методов можно:получать публичную информацию о конкретном заказе и о последних обменах,
привязывать email к заказу для получения уведомлений,принимать изменения режима курса (например, переход с фиксированного на плавающий курс),инициировать возврат средств и проверять его статус.
Эти методы используются на всех этапах жизненного цикла заказа — от отслеживания до возврата.
GET
public-info
Endpoint URL
https://quickex.io/api/v1/orders/public-info
Documentation
Возвращает публичную информацию о заказе (обменной операции) по адресу назначения.
В ответе приходят детали депозита/вывода, пара инструментов, параметры заявленного курса, события заказа и т.д.
URL
https://quickex.io/api/v1/orders/public-info
Параметры запроса (Query)
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
destinationAddress |
string | да | Адрес назначения, к которому привязан заказ. Используется для поиска заказа. |
Пример запроса (cURL)
curl -X GET \
'https://quickex.io/api/v1/orders/public-info?destinationAddress=0xdeadbeef' \
-H 'Accept: application/json'Пример ответа (успех)
{
"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"
}Ответы
| Код | Тело | Описание |
|---|---|---|
200 OK |
JSON с информацией о заказе | Заказ найден и возвращён. |
400 Bad Request |
{"status":"ERR_VALIDATION","message":"Validation Exception", ...} |
Ошибка валидации (например, не передан destinationAddress или он некорректен). |
5xx |
— | Внутренняя ошибка сервера. |
Примечания
- Метод отдаёт публичные данные заказа; приватные детали недоступны.
- Если заказ ещё не создан/не найден по адресу, вернётся ошибка валидации или пустой результат.
- Структура разделов
deposits/withdrawalsи вспомогательных полей может меняться в зависимости от статуса заказа и провайдера ликвидности.
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
Присваивает email существующему заказу (обменной операции). Email используется для отправки уведомлений по статусу заказа и для связи с поддержкой.
URL
https://quickex.io/api/v1/orders/public/set-email
Требуется авторизация
Нет (публичный метод для существующего заказа).
Заголовки
Accept: application/jsonContent-Type: application/json
Тело запроса (JSON)
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
orderId |
number | да | Идентификатор заказа, к которому нужно привязать email. |
userEmail |
string (email) | да | Почтовый адрес пользователя для уведомлений. |
{
"orderId": 123456,
"userEmail": "user@example.com"
}Пример запроса (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"
}'Ответы
| Код | Тело | Описание |
|---|---|---|
200 OK |
JSON с публичной информацией о заказе (включая userEmail) |
Email успешно привязан к заказу. |
400 Bad Request |
{"status":"ERR_VALIDATION","message":"Validation Exception", ...} |
Ошибка валидации (например, userEmail не является валидным email). |
5xx |
— | Внутренняя ошибка сервера. |
Примечания
- Перед вызовом убедитесь, что указан корректный
orderIdсуществующего заказа.userEmailдолжен быть валидным адресом (пример ошибки:userEmail must be an email).- В успешном ответе возвращается актуальная публичная информация по заказу, где поле
userEmailбудет установленным адресом.
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
Возвращает список последних публичных заказов, созданных на платформе Quickex.
Этот метод не требует параметров и позволяет получить базовую информацию о недавно совершённых обменах (валюты, сети и объёмы).
Параметры
Отсутствуют
Пример запроса
curl -X 'GET' \
'https://quickex.io/api/v1/orders/public/latest' \
-H 'accept: application/json'Пример ответа (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"
}
]Примечания
Метод возвращает только публичную информацию (без персональных данных пользователей).
Может быть полезен для отображения виджета «последние обмены» на сайте.
Ответ содержит список с ограниченным количеством записей (например, последние 5–10 заказов).
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
Подтверждает смену режима курса для заказа. Используется в случаях, когда заказ был создан с фиксированным курсом,
но в процессе обмена произошёл переход на плавающий курс (например, из-за превышения лимита или высокой волатильности).
Метод позволяет пользователю принять новый режим и продолжить обработку заказа.
URL
https://quickex.io/api/v1/orders/public/accept-rate-mode-change
Заголовки
Accept: application/jsonContent-Type: application/json
Тело запроса (JSON)
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
orderId |
number | да | Идентификатор заказа, для которого необходимо подтвердить смену режима курса. |
destinationAddress |
string | да | Адрес назначения, связанный с заказом (используется как дополнительная проверка). |
{
"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 '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
Запрашивает возврат средств по заказу. Используется в ситуациях, когда обмен не был завершён или средства должны быть возвращены пользователю.
Для успешного выполнения необходимо указать сумму возврата и адрес для возврата.
URL
https://quickex.io/api/v1/orders/public/request-refund
Заголовки
Accept: application/jsonContent-Type: application/json
Тело запроса (JSON)
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
orderId |
number | да | Идентификатор заказа, по которому запрашивается возврат. |
destinationAddress |
string | да | Адрес назначения, указанный в исходном заказе (дополнительная проверка). |
refundAmount |
string | да | Сумма, которую требуется вернуть пользователю. |
refundAddress |
string | да | Кошелёк пользователя, на который будут возвращены средства. |
claimedNetworkFee |
string | нет | Размер комиссии сети, который пользователь соглашается оплатить при возврате. |
{
"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/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
Возвращает информацию о возврате средств для конкретного заказа.
Используется после создания запроса возврата, чтобы проверить детали (сумму, адрес возврата, статус).
URL
https://quickex.io/api/v1/orders/order-refund-info
Параметры запроса (Query)
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
orderId |
string | да | Идентификатор заказа, по которому необходимо получить данные о возврате. |
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 |
Внутренняя ошибка сервера. |
Примечания
- Метод возвращает данные только для заказов, по которым был инициирован возврат.
- В случае успешного ответа 200 JSON может содержать сумму возврата, адрес возврата и сетевые комиссии.
- При ошибках валидации (
400) сервер указывает причину в полеmessage.
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
Возвращает список заказов (ордеров), связанных с текущим аутентифицированным пользователем.
В ответе содержатся детали депозитов, выводов, параметры пары, статус заказа и другая информация.
URL
https://quickex.io/api/v1/orders/public/list
Требуется авторизация
Да — необходимо передать действительный access_token в заголовке .
Заголовки
Accept: application/jsonaccess_token = YOUR_TOKEN
Параметры
Отсутствуют
Пример запроса (cURL)
curl -X GET \
'https://quickex.io/api/v1/orders/public/list' \
-H 'Accept: application/json' \
--cookie "access_token=YOUR_TOKEN" \'Пример ответа (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"
}
]Ответы
| Код | Описание |
|---|---|
200 OK |
Возвращает массив заказов пользователя. |
401 Unauthorized |
Не передан или недействителен access_token. |
5xx |
Ошибка сервера при обработке запроса. |
Примечания
- Метод возвращает только заказы, созданные текущим авторизованным пользователем.
- Для получения публичной информации о конкретном заказе можно использовать метод
/api/v1/orders/public-info.- Рекомендуется кэшировать данные заказов на клиенте для уменьшения количества запросов.
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
Создаёт новый заказ (ордер) на обмен.
Метод принимает параметры пары (валюта отправления и получения), сумму, адреса пользователя, а также дополнительные данные
(курс, комиссии, партнёрские параметры). В ответ возвращает объект заказа с деталями депозита и вывода.
URL
https://quickex.io/api/v1/orders/public/create
Аутентификация
- Заголовок
B2B-Bearer-Tokenобязателен для B2B-интеграций (пример:-H "B2B-Bearer-Token: TOKEN"). - Для пользовательских сценариев может использоваться
access_tokenкак cookie.
Заголовки
Accept: application/jsonContent-Type: application/jsonB2B-Bearer-Token: <TOKEN>
Тело запроса (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"
}Пример запроса (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"
}'Пример ответа (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"
}Ответы
| Код | Описание |
|---|---|
200 OK |
Заказ успешно создан, возвращается объект заказа. |
401 Unauthorized |
Не указан или неверный B2B-Bearer-Token или cookie access_token. |
422 Unprocessable Entity |
Ошибка валидации входных данных (например, слишком маленькая сумма). |
501 |
Ошибка сервера («data is not iterable»). |
Примечания
- Перед созданием заказа рекомендуется получить курс методом
/api/v1/rates/public/one.- При указании
rateMode=FIXEDкурс будет зафиксирован на ограниченное время.- Параметры
referrerIdиmarkupAffiliateIdиспользуются для партнёрских интеграций.- Ответ может содержать пустые массивы
withdrawals, если средства ещё не отправлены.
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