Група методів Orders in Quickex API

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

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

POST

set-email

Endpoint URL

/api/v1/orders/public/set-email

Documentation

Прив’язує адресу електронної пошти до наявного замовлення (операції обміну). Електронна пошта використовується для надсилання сповіщень про статус замовлення та для зв’язку зі службою підтримки.

URL

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

Потрібна авторизація?

Ні (публічний метод для наявного замовлення).

Заголовки

Accept: application/json
Content-Type: application/json

Тіло запиту (JSON)

Поле	Тип	Обов’язково	Опис
`orderId`	number	так	Ідентифікатор замовлення, до якого потрібно прив’язати електронну пошту.
`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`)	Електронну пошту успішно прив’язано до замовлення.
`400 Bad Request`	`{"status":"ERR_VALIDATION","message":"Validation Exception", ...}`	Помилка валідації (наприклад, якщо `userEmail` не є дійсною адресою електронної пошти).
`5xx`	—	Внутрішня помилка сервера.

Примітки

Перед викликом методу переконайтеся, що вказано дійсний orderId наявного замовлення.

userEmail має бути дійсною адресою електронної пошти (приклад помилки: userEmail must be an email).

У разі успіху відповідь повертає актуальну публічну інформацію про замовлення, де поле userEmail міститиме призначену адресу.

Code Sample

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

GET

latest

Endpoint URL

https://quickex.io/api/v1/orders/public/latest

Documentation

Code Sample

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

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/json
Content-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

Try it out

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/json
Content-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

Try it out

GET

order-refund-info

Endpoint URL

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

Documentation

Параметр	Тип	Обов’язково	Опис
`orderId`	string	так	Ідентифікатор замовлення, для якого потрібно отримати дані про повернення.

Код	Опис
`200 OK`	Повертає JSON з інформацією про повернення (сума, адреса, статус, комісії).
`400 Bad Request`	Помилка валідації або недійсні дані замовлення (`{"status":"ERR_BAD_REQUEST","message":"Unknown liquidity provider title: ..."}`).
`404 Not Found`	Замовлення не знайдено.
`5xx`	Внутрішня помилка сервера.

Code Sample

Try it out

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/json
access_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

Try it out

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/json
Content-Type: application/json
B2B-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

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
}

API V1 Orders

Documentation

URL

Параметри запиту (query)

Приклад запиту (cURL)

Приклад відповіді (успішно)

Відповіді

Примітки

Code Sample

Response Example

Try it out

Headers

Documentation

URL

Потрібна авторизація?

Заголовки

Тіло запиту (JSON)

Приклад запиту (cURL)

Відповіді

Примітки

Code Sample

Response Example

Try it out

Request Body

Headers

Documentation

Параметри

Приклад запиту

Приклад відповіді (200)

Примітки

Code Sample

Response Example

Try it out

Headers

Documentation

URL

Заголовки

Тіло запиту (JSON)

Приклад запиту (cURL)

Відповіді

Примітки

Code Sample

Try it out

Request Body

Headers

Documentation

URL

Заголовки

Тіло запиту (JSON)

Приклад запиту (cURL)

Відповіді

Примітки

Code Sample

Try it out

Request Body

Headers

Documentation

URL

Параметри запиту (query)

Відповіді

Примітки

Code Sample

Try it out

Headers

Documentation

URL

Потрібна авторизація?

Заголовки

Параметри

Приклад запиту (cURL)

Приклад відповіді (200)

Відповіді

Примітки

Code Sample

Try it out

Headers

Documentation

URL

Автентифікація

Заголовки