Начать Begin

Введение Introduction

Аутентификация Authentication

REST Public Exchange REST Public Exchange

Криптовалюты Cryptocurrencies

Спотовые рынки Spot markets

Глубина ордеров Order depth

История торгов Trading history

История свечей Candles history

REST Public Pools REST Public Pools

Пулы ликвидности Liquidity pools

REST Public Scanner REST Public Scanner

Подключенные биржи Connected exchanges

Доступные сделки Available deals

REST Private Exchange REST Private Exchange

Создание ордера Create order

Отмена ордеров Cancel orders

Отмена всех ордеров Cancel all orders

Открытые ордера Open orders

Отложенные ордера Pending orders

История ордеров Order history

История сделок Trades history

REST Private Account REST Private Account

Балансы Balances

Адреса для депозитов Deposit addresses

История транзакций Transaction history

REST Private Scanner REST Private Scanner

Оплата просмотра Show deal

Оплаченные сделки Paid deals

Инфо Info

Лимиты Limits

Коды ошибок Error codes

Обратная связь Feedback

Запросить эндпоинт/поле Request an endpoint/field

Сообщить об ошибке Report an error

Получить помощь Get help

Введение Introduction

Данная API-документация предоставляет разработчикам инструменты для автоматизации взаимодействия с сервисами Qutrade и интеграции с ними. This API documentation provides developers with tools to automate interaction with Qutrade services and integrate with them.

Содержание документации Documentation content

Документация по каждому эндпоинту содержит: Each endpoint documentation includes:

Подробные примеры вызова на популярных языках программирования.

Подробное описание передаваемых параметров.

Подробное описание полей, содержащихся в ответах.

Подробное описание кодов ошибок.

Информацию о лимитах запросов и времени кэширования данных.

Detailed request examples in popular programming languages.

Detailed descriptions of request parameters.

Detailed descriptions of response fields.

Detailed descriptions of error codes.

Information about rate limits and data cache duration.

Базовый адрес Base address

Базовый адрес для всех API REST-эндпоинтов: https://qutrade.io/api/v2 The following base URL must be used for all API endpoints: https://qutrade.io/api/v2

Типы эндпоинтов Types of endpoints

Все эндпоинты делятся на два типа: All endpoints are divided into two types:

Публичные - не требуют аутентификации, вызываются только через GET-метод.
Приватные - требуют аутентификации, вызываются только через POST-метод.

Public — do not require authentication and are accessible only via the GET method.
Private — require authentication and are accessible only via the POST method.

Формат и структура ответов Format and structure of answers

Все ответы API возвращаются в формате JSON и имеют следующую структуру: All API responses are returned in JSON format and have the following structure:

Успешный ответ - всегда содержит поле result со значением success и поле payload с полезными данными.

Ответ с ошибкой - всегда содержит поле result со значением error, поле code с кодом ошибки, и поле message с описанием типа ошибки. В зависимости от эндпоинта ответ также может содержать дополнительные поля с более подробной информацией об ошибке.

A successful response always contains the result field with the value success and the payload field containing the response data.

An error response always contains the result field with the value error, the code field containing the error code, and the message field describing the error. Depending on the endpoint, the response may also contain additional fields with more detailed error information.

Базовый адрес Base address

Базовый URL для всех REST API-эндпоинтов: https://qutrade.io/api/v2 Base URL for all REST API endpoints: https://qutrade.io/api/v2

Аутентификация Authentication

Все приватные эндпоинты API требуют обязательной аутентификации запросов и доступны только через метод POST. All private API endpoints require request authentication and are accessible only via the POST method.

Выполнение аутентификации Performing authentication

Для аутентификации требуется передать HTTP-заголовки: To authenticate a request, the HTTP headers must be provided:

API-KEY: публичный API-ключ в формате Hex.

API-SIGN: цифровая подпись запроса в формате Hex, сгенерированная с использованием секретного API-ключа по алгоритму Ed25519.

API-KEY: Public API key in Hex format.

API-SIGN: Request signature in Hex format, generated using the secret API key and the Ed25519 algorithm.

Цифровая подпись должна вычисляться из строки, состоящей из: эндпоинта + POST-параметров, отсортированных по возрастанию и преобразованных в URL-кодированную строку запроса. The request signature must be generated from a string consisting of: the endpoint + POST parameters, sorted in ascending order and converted into a URL-encoded query string.

Создание API-ключей Creating API keys

Публичный и секретный API-ключи можно создать в разделе API-ключи. Public and secret API keys can be created in the API Keys section.

Криптовалюты Cryptocurrencies

Этот эндпоинт позволяет получать общие данные по криптовалютам. При успешном выполнении эндпоинт возвращает общие данные по криптовалютам и поддерживаемым сетям. This endpoint allows you to retrieve general data on cryptocurrencies. When successful, the endpoint returns general data on cryptocurrencies and supported networks.

Параметры Parameters

	Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.		Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.		Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
	field Нет No		String Все поля All fields		Явный выбор полей успешного ответа. name или name,deposits_can Explicit selection of success response fields. name or name,deposits_can

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
name	String	Название криптовалюты. Name of the cryptocurrency.
deposits_can	Boolean	Статус депозитов (true - депозиты работают, false - депозиты не работают). Deposit status (true - deposits are working, false - deposits are not working).
withdrawals_can	Boolean	Статус выводов средств (true - выводы средств работают, false - выводы средств не работают). Withdrawal status (true - withdrawals are working, false - withdrawals are not working).
site	String	Официальный сайт. Official website.
price_usd	String	Цена криптовалюты в USD. Cryptocurrency price in USD.
status	String	Статус криптовалюты. Cryptocurrency status.
chains	Array	Доступные сети. Available networks.
chains[].chain	String	Тикер сети. Network ticker.
chains[].deposit_can	Boolean	Статус депозита (true - депозит работает, false - депозит не работает). Deposit status (true - deposit is working, false - deposit is not working).
chains[].deposit_min	String	Минимальная сумма депозита. Minimum deposit amount.
chains[].deposit_fee	String	Комиссия депозита. Deposit commission.
chains[].deposit_confirmations	Integer	Количество подтверждений сети для зачисления депозита. The number of network confirmations required to credit the deposit.
chains[].withdraw_can	Boolean	Статус вывода средств (true - вывод средств работает, false - вывод средств не работает). Withdrawal status (true - withdrawal is working, false - withdrawal is not working).
chains[].withdraw_min	String	Минимальная сумма вывода средств. Minimum withdrawal amount.
chains[].withdraw_fee	String	Комиссия вывода средств. Withdrawal fee.
chains[].withdraw_fee_in_S11	String	Комиссия вывода средств в S11. Withdrawal fee in S11.
chains[].explorer	String	Обозреватель блоков. Block explorer.
chains[].fast_withdrawal_reserve	String	Резерв для быстрого вывода средств. Reserve for quick withdrawal of funds.
chains[].full_withdrawal_reserve	String	Общий резерв. General reserve.
chains[].type	String	Тип криптовалюты. Type of cryptocurrency.
chains[].address_regex	String	Регулярное выражение валидации адреса. Address validation regular expression.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "name", "deposits_can", "withdrawals_can", "site", "price_usd", "status", "chains" ] }
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the GET method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

GET

/cryptocurrencies

Аутентификация Authentication

не требуется not required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request GET \
  --url https://qutrade.io/api/v2/cryptocurrencies

$base_url = 'https://qutrade.io/api/v2';
$method = '/cryptocurrencies';
$ch = curl_init($base_url.$method);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

const options = {method: 'GET'};

fetch('https://qutrade.io/api/v2/cryptocurrencies', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": {
    "BTC": {
      "name": "Bitcoin",
      "deposits_can": true,
      "withdrawals_can": true,
      "site": "https://bitcoin.org",
      "price_usd": "79864",
      "status": "active",
      "chains": [
        {
          "chain": "BTC",
          "deposit_can": true,
          "deposit_min": "0.0001",
          "deposit_fee": "0",
          "deposit_confirmations": 1,
          "withdraw_can": true,
          "withdraw_min": "0.00002",
          "withdraw_fee": "0.00001",
          "withdraw_fee_in_S11": "36",
          "explorer": "https://www.blockchain.com/explorer",
          "fast_withdrawal_reserve": "0.0091336700",
          "full_withdrawal_reserve": "0.5391336700",
          "type": "coin",
          "address_regex": "^[13][a-km-zA-HJ-NP-Z1-9]{25,34}$|^[(bc1q)|(bc1p)][0-9A-Za-z]{37,62}$"
        },
        ...
      ]
    },
    ...
  }
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Спотовые рынки Spot markets

Этот эндпоинт позволяет получать общие данные по спотовым рынкам. При успешном выполнении эндпоинт возвращает цены, статистику и лимиты по спотовым рынкам. This endpoint allows you to retrieve general spot markets data. When executed successfully, the endpoint returns prices, statistics and limit data for the spot markets.

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. ask или ask,bid Explicit selection of success response fields. ask or ask,bid
pair Нет No	String Все пары All pairs	Тикер торговой пары. BTC_USDT или BTC_USDT,ETH_USDT Ticker of the trading pair. BTC_USDT or BTC_USDT,ETH_USDT

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
last	String	Цена последней сделки. Last trade price.
ask	String	Лучшая цена продажи. Best selling price.
bid	String	Лучшая цена покупки. Best purchase price.
trend	String	Изменение цены за последние 24 часа в процентах. Percentage change in the last trade price over the past 24 hours.
spread	String	Спред между лучшей ценой покупки/продажи в процентах. Spread between best buy/sell price in percent.
base_volume	String	Объем торговли за последние 24 часа в базовом активе. Trading volume over the last 24 hours in the base asset.
quote_volume	String	Объем торговли за последние 24 часа в котируемом активе. Trading volume over the last 24 hours in the quote asset.
volume_usd	String	Объем торгов за последние 24 часа в USD. Trading volume over the last 24 hours in USD.
traders	Integer	Количество активных трейдеров за последние 24 часа. Number of active traders over the last 24 hours.
trades	Integer	Количество торговых сделок за последние 24 часа. Number of trades in the last 24 hours.
step_price	String	Шаг цены. Price step.
decimal_price	Integer	Количество десятичных знаков цены. Number of decimal places in the price.
min_price_buy	String	Минимальная цена покупки. Minimum purchase price.
max_price_buy	String	Максимальная цена покупки. Maximum purchase price.
min_price_sell	String	Минимальная цена продажи. Minimum selling price.
max_price_sell	String	Максимальная цена продажи. Maximum selling price.
base_step_amount	String	Шаг базового актива. Step of the base asset.
base_decimal_amount	Integer	Количество десятичных знаков базового актива. The number of decimal places of the base asset.
base_min_amount	String	Минимальное количество базового актива. Minimum amount of the base asset.
quote_step_amount	String	Шаг котируемого актива. Step of the quote asset.
quote_decimal_amount	Integer	Количество десятичных знаков котируемого актива. The number of decimal places of the quote asset.
quote_min_amount	String	Минимальное количество котируемого актива. Minimum amount in the quote asset.
base_liquidity	String	Общая ликвидность базового актива. Total liquidity of the base asset.
base_liquidity_usd	String	Общая ликвидность базового актива в USD. Total liquidity of the base asset in USD.
quote_liquidity	String	Общая ликвидность котируемого актива. Total liquidity of the quote asset.
quote_liquidity_usd	String	Общая ликвидность котируемого актива в USD. Total liquidity of the quote asset in USD.
timestamp	Integer	Метка времени кэширования данных. Data cache timestamp.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "pair" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "last", "ask", "bid", "trend", "spread", "base_volume", "quote_volume", "volume_usd", "traders", "trades", "step_price", "decimal_price", "min_price_buy", "max_price_buy", "min_price_sell", "max_price_sell", "base_step_amount", "base_decimal_amount", "base_min_amount", "quote_step_amount", "quote_decimal_amount", "quote_min_amount", "base_liquidity", "base_liquidity_usd", "quote_liquidity", "quote_liquidity_usd", "timestamp" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,)." }
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the GET method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

GET

/spot_markets

Аутентификация Authentication

не требуется not required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request GET \
  --url https://qutrade.io/api/v2/spot_markets

$base_url = 'https://qutrade.io/api/v2';
$method = '/spot_markets';
$ch = curl_init($base_url.$method);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

const options = {method: 'GET'};

fetch('https://qutrade.io/api/v2/spot_markets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": {
    "BTC_USDT": {
      "last": "78053",
      "ask": "79100",
      "bid": "78006",
      "trend": "-0.9341405526",
      "spread": "1.40245622",
      "base_volume": "0.0009064383",
      "quote_volume": "71.18182925",
      "volume_usd": "71.18",
      "traders": 8,
      "trades": 154,
      "step_price": "1",
      "decimal_price": 0,
      "min_price_buy": "1",
      "max_price_buy": "117079",
      "min_price_sell": "39026",
      "max_price_sell": "10000000",
      "base_step_amount": "0.00000001",
      "base_decimal_amount": 8,
      "base_min_amount": "0.000001",
      "quote_step_amount": "0.00000001",
      "quote_decimal_amount": 8,
      "quote_min_amount": "0.1",
      "base_liquidity": "0.0926075159",
      "base_liquidity_usd": "7228.29",
      "quote_liquidity": "6673.6914083393",
      "quote_liquidity_usd": "6673.69",
      "timestamp": 1789041604
    },
    ...
  }
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Пулы ликвидности Liquidity pools

Этот эндпоинт позволяет получать общие данные по пулам ликвидности. При успешном выполнении эндпоинт возвращает цены, статистику и лимиты по пулам ликвидности. This endpoint allows you to retrieve general data on liquidity pools. When executed successfully, the endpoint returns prices, statistics, and limits data for liquidity pools.

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. price или price,providers Explicit selection of success response fields. price or price,providers
pair Нет No	String Все пары All pairs	Тикер торговой пары. BTC_USDT или BTC_USDT,ETH_USDT Ticker of the trading pair. BTC_USDT or BTC_USDT,ETH_USDT

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
price	String	Цена пула ликвидности. Liquidity pool price.
providers	Integer	Количество поставщиков ликвидности. Number of liquidity providers.
shares	Integer	Количество добавленных долей ликвидности. Number of added liquidity shares.
apy_1w	String	Годовая доходность за последние 7 дней в процентах. Annual return for the last 7 days in percent.
apy_1m	String	Годовая доходность за последние 30 дней в процентах. Annual return for the last 30 days in percent.
apy_1y	String	Годовая доходность за последние 365 дней в процентах. Annual return for the last 365 days in percent.
payouts_usd_1w	String	Выплаченная прибыль за последние 7 дней в USD. Paid profit for the last 7 days in USD.
payouts_usd_1m	String	Выплаченная прибыль за последние 30 дней в USD. Paid profit for the last 30 days in USD.
payouts_usd_1y	String	Выплаченная прибыль за последние 365 дней в USD. Paid profit for the last 365 days in USD.
base_liquidity	String	Общая ликвидность базового актива. Total liquidity of the base asset.
base_liquidity_usd	String	Общая ликвидность базового актива в USD. Total liquidity of the base asset in USD.
quote_liquidity	String	Общая ликвидность котируемого актива. Total liquidity of the quote asset.
quote_liquidity_usd	String	Общая ликвидность котируемого актива в USD. Total liquidity of the quote asset in USD.
timestamp	Integer	Метка времени кэширования данных. Data cache timestamp.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "pair" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "price", "providers", "shares", "apy_1w", "apy_1m", "apy_1y", "payouts_usd_1w", "payouts_usd_1m", "payouts_usd_1y", "base_liquidity", "base_liquidity_usd", "quote_liquidity", "quote_liquidity_usd", "timestamp" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,)." }
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the GET method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

GET

/liquidity_pools

Аутентификация Authentication

не требуется not required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request GET \
  --url https://qutrade.io/api/v2/liquidity_pools

$base_url = 'https://qutrade.io/api/v2';
$method = '/liquidity_pools';
$ch = curl_init($base_url.$method);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

const options = {method: 'GET'};

fetch('https://qutrade.io/api/v2/liquidity_pools', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": {
    "BTC_USDT": {
      "price": "78200",
      "providers": 116,
      "shares": 338,
      "apy_1w": "6.2729",
      "apy_1m": "2.4955",
      "apy_1y": "5.5449",
      "payouts_usd_1w": "8.85",
      "payouts_usd_1m": "15.11",
      "payouts_usd_1y": "398.83",
      "base_liquidity": "0.0406861976",
      "base_liquidity_usd": "3181.66",
      "quote_liquidity": "3203.0620832542",
      "quote_liquidity_usd": "3203.06",
      "timestamp": 1787747425
    }
  }
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Глубина ордеров Order depth

Этот эндпоинт позволяет получать глубину ордеров по рынкам. При успешном выполнении эндпоинт возвращает список лучших ордеров на покупку и продажу, сгруппированных по цене. This endpoint allows you to obtain order depth by market. If executed successfully, the endpoint returns a list of the best buy and sell orders, grouped by price.

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. asks или asks,bids Explicit selection of success response fields. asks or asks,bids
pair Нет No	String Все пары All pairs	Тикер торговой пары. BTC_USDT или BTC_USDT,ETH_USDT Ticker of the trading pair. BTC_USDT or BTC_USDT,ETH_USDT
limit Нет No	Integer 10 10	Количество ценовых уровней, возвращаемых для каждой стороны стакана. 25 (от 1 до 100) Number of price levels returned for each side of the order book. 25 (from 1 to 100)

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
asks	Array	Ордера на продажу, сгруппированные по цене [цена (String), количество (String)]. Sell orders grouped by price [price (String), amount (String)].
bids	Array	Ордера на покупку, сгруппированные по цене [цена (String), количество (String)]. Buy orders grouped by price [price (String), amount (String)].
timestamp	Integer	Метка времени кэширования данных. Data cache timestamp.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "pair", "limit" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "asks", "bids", "timestamp" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,)." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The limit parameter is invalid.", "allowed_format": "Integer \| from 1 to 100." }
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the GET method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 10 requests / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

GET

/depth

Аутентификация Authentication

не требуется not required

Кэширование Caching

в реальном времени in real time

Лимит Limit

10 запросов / 1 секунда 10 requests / 1 second

Пример запроса Example request

BASH

PHP

curl --request GET \
  --url https://qutrade.io/api/v2/depth

$base_url = 'https://qutrade.io/api/v2';
$method = '/depth';
$ch = curl_init($base_url.$method);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

const options = {method: 'GET'};

fetch('https://qutrade.io/api/v2/depth', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": {
    "BTC_USDT": {
      "asks": [
        [
          "77067",
          "0.00000143"
        ],
        [
          "77072",
          "0.00000133"
        ],
        ...
      ],
      "bids": [
        [
          "77056",
          "0.0000015"
        ],
        [
          "77051",
          "0.00000133"
        ],
        ...
      ],
      "timestamp": 1787553834
    },
    ...
  }
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

История торгов Trading history

Этот эндпоинт позволяет получать историю торгов по рынку. При успешном выполнении эндпоинт возвращает историю последних сделок по рынку. This endpoint allows you to retrieve the market's trading history. If executed successfully, the endpoint returns the history of the most recent trades for the market.

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. id или id,side Explicit selection of success response fields. id or id,side
pair Да Yes	String Нет No	Тикер торговой пары. BTC_USDT Ticker of the trading pair. BTC_USDT
min_timestamp Нет No	Integer 1 1	Начальная метка времени. 1787798000 (от 1 до 9999999999) Start timestamp. 1787798000 (from 1 to 9999999999)
max_timestamp Нет No	Integer 9999999999 9999999999	Конечная метка времени. 1787799000 (от 1 до 9999999999) End timestamp. 1787799000 (from 1 to 9999999999)
min_id Нет No	Integer 1 1	Начальный идентификатор сделки. 100 (от 1 до 9999999999) Initial trade identifier. 100 (from 1 to 9999999999)
max_id Нет No	Integer 9999999999 9999999999	Конечный идентификатор сделки. 1100 (от 1 до 9999999999) End trade identifier. 1100 (from 1 to 9999999999)
limit Нет No	Integer 10 10	Количество сделок. 25 (от 1 до 1000) Number of trades. 25 (from 1 to 1000)

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
id	Integer	Идентификатор сделки. Trade identifier.
side	String	Сторона сделки. Trade side.
price	String	Цена сделки. Trade price.
base_amount	String	Объем сделки в базовом активе. The volume of the trade in the base asset.
quote_amount	String	Объем сделки в котируемом активе. The volume of the trade in a quote asset.
volume_usd	String	Объем сделки в USD. The volume of the transaction in USD.
timestamp	Integer	Метка времени проведения сделки. Timestamp of the trade.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "pair", "min_timestamp", "max_timestamp", "min_id", "max_id", "limit" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "id", "side", "price", "base_amount", "quote_amount", "volume_usd", "timestamp" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter is invalid.", "allowed_format": "String." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_timestamp parameter is invalid.", "allowed_format": "Integer \| from 1 to 9999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The max_timestamp parameter is invalid.", "allowed_format": "Integer \| from 1 to 9999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_timestamp parameter must not be greater than the max_timestamp parameter." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_id parameter is invalid.", "allowed_format": "Integer \| from 1 to 9999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The max_id parameter is invalid.", "allowed_format": "Integer \| from 1 to 9999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_id parameter must not be greater than the max_id parameter." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The limit parameter is invalid.", "allowed_format": "Integer \| from 1 to 1000." }
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the GET method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

GET

/trading_history

Аутентификация Authentication

не требуется not required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request GET \
  --url https://qutrade.io/api/v2/trading_history?pair=BTC_USDT

$base_url = 'https://qutrade.io/api/v2';
$method = '/trading_history';
$parameter['pair'] = 'BTC_USDT';
$parameters = '?'.http_build_query($parameter);
$ch = curl_init($base_url.$method.$parameters);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

const options = {method: 'GET'};

fetch('https://qutrade.io/api/v2/trading_history?pair=BTC_USDT', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": [
    {
      "id": 3805571,
      "side": "buy",
      "price": "78900",
      "base_amount": "0.00000147",
      "quote_amount": "0.115983",
      "volume_usd": "0.12",
      "timestamp": 1787798051
    },
    ...
  ]
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

История свечей Candles history

Этот эндпоинт позволяет получать историю свечей по рынку. This endpoint allows you to retrieve candlestick history for the market.

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. open или open,close Explicit selection of success response fields. open or open,close
pair Да Yes	String Нет No	Тикер торговой пары. BTC_USDT Ticker of the trading pair. BTC_USDT
resolution Да Yes	String Нет No	Таймфрейм свечи. 1H (допустимые значения: 15, 1H, 1D, 1W, 1M) Candlestick timeframe. 1H (valid values: 15, 1H, 1D, 1W, 1M)
min_timestamp Нет No	Integer 1 1	Начальная метка времени. 1787798000 (от 1 до 9999999999) Start timestamp. 1787798000 (from 1 to 9999999999)
max_timestamp Нет No	Integer 9999999999 9999999999	Конечная метка времени. 1787799000 (от 1 до 9999999999) End timestamp. 1787799000 (from 1 to 9999999999)
limit Нет No	Integer 10 10	Количество свечей. 25 (от 1 до 1000) Number of candles. 25 (from 1 to 1000)

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
open	String	Цена открытия. Opening price.
close	String	Цена закрытия. Closing price.
high	String	Максимальная цена. Maximum price.
low	String	Минимальная цена. Minimum price.
base_volume	String	Объем в базовом активе. The volume in the base asset.
quote_volume	String	Объем в котируемом активе. The volume in a quote asset.
volume_usd	String	Объем в USD. The volume in USD.
timestamp	Integer	Метка времени начала свечи. Candle start timestamp.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "pair", "resolution", "min_timestamp", "max_timestamp", "limit" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "open", "close", "high", "low", "base_volume", "quote_volume", "volume_usd", "timestamp" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter is invalid.", "allowed_format": "String." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The resolution parameter is invalid.", "allowed_format": "String.", "allowed_values": [ "15", "1H", "1D", "1W", "1M" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_timestamp parameter is invalid.", "allowed_format": "Integer \| from 1 to 9999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The max_timestamp parameter is invalid.", "allowed_format": "Integer \| from 1 to 9999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_timestamp parameter must not be greater than the max_timestamp parameter." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The limit parameter is invalid.", "allowed_format": "Integer \| from 1 to 1000." }
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the GET method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

GET

/candles_history

Аутентификация Authentication

не требуется not required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request GET \
  --url https://qutrade.io/api/v2/candles_history?pair=BTC_USDT&resolution=1H

$base_url = 'https://qutrade.io/api/v2';
$method = '/candles_history';
$parameter['pair'] = 'BTC_USDT';
$parameter['resolution'] = '1H';
$parameters = '?'.http_build_query($parameter);
$ch = curl_init($base_url.$method.$parameters);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

const options = {method: 'GET'};

fetch('https://qutrade.io/api/v2/candles_history?pair=BTC_USDT&resolution=1H', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": [
    {
      "open": "85367",
      "close": "85337",
      "high": "85367",
      "low": "85337",
      "base_volume": "0.0000072",
      "quote_volume": "0.61454952",
      "volume_usd": "0.61",
      "timestamp": 1791259200
    },
    ...
  ]
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Создание ордера Create order

Этот эндпоинт позволяет создавать новые ордера на спотовых рынках. При успешном выполнении эндпоинт возвращает объект ордера. This endpoint allows you to create new orders on spot markets. If executed successfully, the endpoint returns an order object.

Заголовки Headers

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название заголовка и его обязательность. The «Name / Required» column displays the title of the heading and whether it is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип заголовка и его значение по умолчанию. The «Type / Default» column displays the header type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание заголовка и примеры указания заголовка. The «Description / Examples of specification» column displays the title description and examples of how to specify the title.
API-KEY Да Yes	String Нет No	Публичный API-ключ. HEX 64 символа Public API key. HEX 64 characters
API-SIGN Да Yes	String Нет No	Цифровая подпись запроса. HEX 128 символов Digital signature of the request. HEX 128 characters

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. order_id или order_id,pair Explicit selection of success response fields. order_id or order_id,pair
tonce Да Yes	Integer Нет No	Метка времени UNIX в миллисекундах. 1489617308123 (должна быть уникальной для каждого запроса) UNIX timestamp in milliseconds. 1489617308123 (must be unique for each request)
label Нет No	String Нет No	Метка ордера. Strategy Grid 1 Order label. Strategy Grid 1
pair Да Yes	String Нет No	Тикер торговой пары. BTC_USDT Ticker of the trading pair. BTC_USDT
type Да Yes	String Нет No	Тип ордера (limit, market, stop_limit, stop_market). limit Order type (limit, market, stop_limit, stop_market). limit
side Да Yes	String Нет No	Сторона ордера (buy, sell). buy Order side (buy, sell). buy
stop_price Да/нет Yes/no	String Нет No	Цена активации отложенного ордера. Обязательный для ордеров с типом stop_limit и stop_market. 0.0001 (от 0.0000000001 до 999999999999999). The price to activate a pending order. Mandatory for stop_limit and stop_market order types. 0.0001 (from 0.0000000001 to 999999999999999).
requested_price Да/нет Yes/no	String Нет No	Запрошенная лимитная цена. Обязательный для ордеров с типом limit и stop_limit. 1000 (от 0.0000000001 до 999999999999999). Requested limit price. Mandatory for limit and stop_limit order types. 1000 (from 0.0000000001 to 999999999999999).
requested_base_amount Да/нет Yes/no	String Нет No	Запрошенный лимитный/рыночный объем в базовом активе. Обязательный для ордеров с типом limit и stop_limit, а также для market и stop_market, если требуется выполнить покупку/продажу в базовом активе по рынку. 1000 (от 0.0000000001 до 999999999999999). Requested limit/market volume in the base asset. Required for the limit and stop_limit order types, as well as for market and stop_market if a buy/sell order in the base asset is required at the market. 1000 (from 0.0000000001 to 999999999999999).
requested_quote_amount Да/нет Yes/no	String Нет No	Запрошенный рыночный объем в котируемом активе. Обязательный для ордеров с типом market и stop_market, если требуется выполнить покупку/продажу в котируемом активе по рынку. 1000 (от 0.0000000001 до 999999999999999). The requested market volume in the quote asset. Required for the market and stop_market order types if a buy/sell order in the quote asset is required at the market price. 1000 (from 0.0000000001 to 999999999999999).

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
order_id	Integer	Идентификатор ордера. Order identifier.
label	String	Метка ордера. Order label.
status	String	Статус ордера. Order status.
pair	String	Тикер торговой пары. Ticker of the trading pair.
type	String	Тип ордера. Order type.
side	String	Сторона ордера. Order side.
stop_price	String	Цена активации отложенного ордера. The price to activate a pending order.
requested_price	String	Запрошенная (лимитная) цена ордера. Requested (limit) order price.
average_price	String	Средняя цена заполненного объема. Average price of filled volume.
requested_base_amount	String	Запрошенный объем в базовом активе. The requested volume in the base asset.
filled_base_amount	String	Заполненный объем в базовом активе. The filled volume in the base asset.
unfilled_base_amount	String	Незаполненный объем в базовом активе. Unfilled volume in the base asset.
requested_quote_amount	String	Запрошенный объем в котируемом активе. Requested volume in the quote asset.
filled_quote_amount	String	Заполненный объем в котируемом активе. The filled volume in the quote asset.
unfilled_quote_amount	String	Незаполненный объем в котируемом активе. Unfilled volume in the quote asset.
filled_percent	String	Заполненный объем в процентах. Filled volume in percent.
trades_count	Integer	Количество торговых сделок. Number of trades.
timestamp_create	Integer	Метка времени создания ордера. Order creation timestamp.
timestamp_update	Integer	Метка времени обновления ордера. Order update timestamp.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "tonce", "label", "pair", "type", "side", "stop_price", "requested_price", "requested_base_amount", "requested_quote_amount" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "order_id", "label", "status", "pair", "type", "side", "stop_price", "requested_price", "average_price", "requested_base_amount", "filled_base_amount", "unfilled_base_amount", "requested_quote_amount", "filled_quote_amount", "unfilled_quote_amount", "filled_percent", "trades_count", "timestamp_create", "timestamp_update" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter is invalid.", "allowed_format": "Integer \| UNIX timestamp in milliseconds" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter exceeds the server time." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The label parameter is invalid.", "allowed_format": "String \| a-zA-Z0-9 \| from 1 to 25 characters." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter is invalid." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The type parameter is invalid.", "allowed_format": "String.", "allowed_values": [ "limit", "market", "stop_limit", "stop_market" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The side parameter is invalid.", "allowed_format": "String.", "allowed_values": [ "buy", "sell" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The stop_price parameter is invalid.", "allowed_format": "String \| from 0.0000000001 to 999999999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The requested_price parameter is invalid.", "allowed_format": "String \| from 0.0000000001 to 999999999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The requested_base_amount parameter is invalid.", "allowed_format": "String \| from 0.0000000001 to 999999999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The requested_quote_amount parameter is invalid.", "allowed_format": "String \| from 0.0000000001 to 999999999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "For market and stop_market orders, you must specify exactly one of the requested_base_amount or requested_quote_amount parameters.", "allowed_format": "String \| from 0.0000000001 to 999999999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "Insufficient funds" }
	401	Unauthorized	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-KEY header is invalid.", "allowed_format": "String \| 64 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The tonce parameter must be greater than the last accepted tonce." } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is invalid.", "allowed_format": "String \| 128 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is wrong." }
	403	Forbidden	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 403, "message": "Forbidden", "details": "The API key does not have permission to call this endpoint." } { "result": "error", "code": 403, "message": "Forbidden", "details": "The IP address is not allowed for this API key." }`
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the POST method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 10 requests / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

POST

/create_order

Аутентификация Authentication

требуется required

Кэширование Caching

в реальном времени in real time

Лимит Limit

10 запросов / 1 секунда 10 requests / 1 second

Пример запроса Example request

BASH

PHP

curl --request POST \
  --url https://qutrade.io/api/v2/create_order \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "API-KEY: MY_API_KEY_HEX" \
  --header "API-SIGN: MY_SIGNATURE_HEX" \
  --data tonce=1753180000000 \
  --data pair=BTC_USDT \
  --data type=limit \
  --data side=buy \
  --data requested_price=100000 \
  --data requested_base_amount=1

$api_key_hex = 'MY_API_KEY_HEX';
$api_secret_hex = 'MY_API_SECRET_HEX';
$base_url = 'https://qutrade.io/api/v2';
$endpoint = '/create_order';
$parameter['tonce'] = (int) (microtime(true) * 1000);
$parameter['pair'] = 'BTC_USDT';
$parameter['type'] = 'limit';
$parameter['side'] = 'buy';
$parameter['requested_price'] = 100000;
$parameter['requested_base_amount'] = 1;
ksort($parameter);
$parameters = http_build_query($parameter);
$signature_hex = bin2hex(sodium_crypto_sign_detached($endpoint.$parameters, hex2bin($api_secret_hex)));
$headers = [
  'API-KEY: ' . $api_key_hex,
  'API-SIGN: ' . $signature_hex
];
$ch = curl_init($base_url.$endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
echo $result = curl_exec($ch);
curl_close($ch);

const apiKeyHex = 'MY_API_KEY_HEX';
const apiSecretHex = 'MY_API_SECRET_HEX';
const baseUrl = 'https://qutrade.io/api/v2';
const endpoint = '/create_order';
const parameters = {
    tonce: Date.now(),
    pair: 'BTC_USDT',
    type: 'limit',
    side: 'buy',
    requested_price: 100000,
    requested_base_amount: 1
};
const sortedParameters = Object.keys(parameters)
    .sort()
    .reduce((obj, key) => {
        obj[key] = parameters[key];
        return obj;
    }, {});
const queryString = new URLSearchParams(sortedParameters).toString();
const message = new TextEncoder().encode(endpoint + queryString);
const secretKey = hexToUint8Array(apiSecretHex);
const signature = nacl.sign.detached(message, secretKey);
const signatureHex = uint8ArrayToHex(signature);
fetch(baseUrl + endpoint, {
    method: 'POST',
    headers: {
        'API-KEY': apiKeyHex,
        'API-SIGN': signatureHex,
        'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: queryString
})
.then(response => response.json())
.then(console.log)
.catch(console.error);
function hexToUint8Array(hex) {
    return Uint8Array.from(hex.match(/.{2}/g).map(byte => parseInt(byte, 16)));
}
function uint8ArrayToHex(bytes) {
    return Array.from(bytes)
        .map(b => b.toString(16).padStart(2, '0'))
        .join('');
}

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": {
    "order_id": 3401940,
    "label": "bot 1",
    "status": "opened",
    "pair": "BTC_USDT",
    "type": "limit",
    "side": "buy",
    "stop_price": null,
    "requested_price": "50000",
    "average_price": null,
    "requested_base_amount": "0.000003",
    "filled_base_amount": "0",
    "unfilled_base_amount": "0.000003",
    "requested_quote_amount": null,
    "filled_quote_amount": "0",
    "unfilled_quote_amount": "0.15",
    "filled_percent": "0",
    "trades_count": 0,
    "timestamp_create": 1788862763,
    "timestamp_update": 1788862763
  }
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Отмена ордеров Cancel orders

Этот эндпоинт позволяет отменять открытые и отложенные ордера по идентификаторам ордеров. При успешном выполнении эндпоинт возвращает данные по запрошенным ордерам в формате истории ордеров. This endpoint allows you to cancel open and pending orders by order identifiers. If executed successfully, the endpoint returns data on the requested orders in order history format.

Заголовки Headers

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название заголовка и его обязательность. The «Name / Required» column displays the title of the heading and whether it is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип заголовка и его значение по умолчанию. The «Type / Default» column displays the header type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание заголовка и примеры указания заголовка. The «Description / Examples of specification» column displays the title description and examples of how to specify the title.
API-KEY Да Yes	String Нет No	Публичный API-ключ. HEX 64 символа Public API key. HEX 64 characters
API-SIGN Да Yes	String Нет No	Цифровая подпись запроса. HEX 128 символов Digital signature of the request. HEX 128 characters

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. order_id или order_id,pair Explicit selection of success response fields. order_id or order_id,pair
tonce Да Yes	Integer Нет No	Метка времени UNIX в миллисекундах. 1489617308123 (должна быть уникальной для каждого запроса) UNIX timestamp in milliseconds. 1489617308123 (must be unique for each request)
order_id Да Yes	Integer Нет No	Идентификатор ордера. 1 или 1,2 Order identifier. 1 or 1,2

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
order_id	Integer	Идентификатор ордера. Order identifier.
label	String	Метка ордера. Order label.
status	String	Статус ордера (canceled - отменен только что, already_canceled - уже был отменен ранее). Order status (canceled - just canceled, already_canceled - was already canceled earlier).
pair	String	Тикер торговой пары. Ticker of the trading pair.
type	String	Тип ордера. Order type.
side	String	Сторона ордера. Order side.
stop_price	String	Цена активации отложенного ордера. The price to activate a pending order.
requested_price	String	Запрошенная (лимитная) цена ордера. Requested (limit) order price.
average_price	String	Средняя цена заполненного объема. Average price of filled volume.
requested_base_amount	String	Запрошенный объем в базовом активе. The requested volume in the base asset.
filled_base_amount	String	Заполненный объем в базовом активе. The filled volume in the base asset.
unfilled_base_amount	String	Незаполненный объем в базовом активе. Unfilled volume in the base asset.
requested_quote_amount	String	Запрошенный объем в котируемом активе. Requested volume in the quote asset.
filled_quote_amount	String	Заполненный объем в котируемом активе. The filled volume in the quote asset.
unfilled_quote_amount	String	Незаполненный объем в котируемом активе. Unfilled volume in the quote asset.
filled_percent	String	Заполненный объем в процентах. Filled volume in percent.
trades_count	Integer	Количество торговых сделок. Number of trades.
timestamp_create	Integer	Метка времени создания ордера. Order creation timestamp.
timestamp_update	Integer	Метка времени обновления ордера. Order update timestamp.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "tonce", "order_id" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "order_id", "label", "status", "pair", "type", "side", "stop_price", "requested_price", "average_price", "requested_base_amount", "filled_base_amount", "unfilled_base_amount", "requested_quote_amount", "filled_quote_amount", "unfilled_quote_amount", "filled_percent", "trades_count", "timestamp_create", "timestamp_update" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter is invalid.", "allowed_format": "Integer \| UNIX timestamp in milliseconds" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter exceeds the server time." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The order_id parameter is invalid.", "allowed_format": "Integer \| you can specify multiple values separated by commas (,)." }
	401	Unauthorized	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-KEY header is invalid.", "allowed_format": "String \| 64 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The tonce parameter must be greater than the last accepted tonce." } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is invalid.", "allowed_format": "String \| 128 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is wrong." }
	403	Forbidden	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 403, "message": "Forbidden", "details": "The API key does not have permission to call this endpoint." } { "result": "error", "code": 403, "message": "Forbidden", "details": "The IP address is not allowed for this API key." }`
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the POST method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

POST

/cancel_orders

Аутентификация Authentication

требуется required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request POST \
  --url https://qutrade.io/api/v2/cancel_orders \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "API-KEY: MY_API_KEY_HEX" \
  --header "API-SIGN: MY_SIGNATURE_HEX" \
  --data tonce=1753180000000 \
  --data order_id=1932519

$api_key_hex = 'MY_API_KEY_HEX';
$api_secret_hex = 'MY_API_SECRET_HEX';
$base_url = 'https://qutrade.io/api/v2';
$endpoint = '/cancel_orders';
$parameter['tonce'] = (int) (microtime(true) * 1000);
$parameter['order_id'] = (int) 1932519;
ksort($parameter);
$parameters = http_build_query($parameter);
$signature_hex = bin2hex(sodium_crypto_sign_detached($endpoint.$parameters, hex2bin($api_secret_hex)));
$headers = [
  'API-KEY: ' . $api_key_hex,
  'API-SIGN: ' . $signature_hex
];
$ch = curl_init($base_url.$endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
echo $result = curl_exec($ch);
curl_close($ch);

const apiKeyHex = 'MY_API_KEY_HEX';
const apiSecretHex = 'MY_API_SECRET_HEX';
const baseUrl = 'https://qutrade.io/api/v2';
const endpoint = '/cancel_orders';
const parameters = {
    tonce: Date.now(),
    order_id: 1932519,
};
const sortedParameters = Object.keys(parameters)
    .sort()
    .reduce((obj, key) => {
        obj[key] = parameters[key];
        return obj;
    }, {});
const queryString = new URLSearchParams(sortedParameters).toString();
const message = new TextEncoder().encode(endpoint + queryString);
const secretKey = hexToUint8Array(apiSecretHex);
const signature = nacl.sign.detached(message, secretKey);
const signatureHex = uint8ArrayToHex(signature);
fetch(baseUrl + endpoint, {
    method: 'POST',
    headers: {
        'API-KEY': apiKeyHex,
        'API-SIGN': signatureHex,
        'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: queryString
})
.then(response => response.json())
.then(console.log)
.catch(console.error);
function hexToUint8Array(hex) {
    return Uint8Array.from(hex.match(/.{2}/g).map(byte => parseInt(byte, 16)));
}
function uint8ArrayToHex(bytes) {
    return Array.from(bytes)
        .map(b => b.toString(16).padStart(2, '0'))
        .join('');
}

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": [
    {
      "order_id": 3393736,
      "label": null,
      "status": "canceled",
      "pair": "BTC_USDT",
      "type": "limit",
      "side": "buy",
      "stop_price": null,
      "requested_price": "79300",
      "average_price": null,
      "requested_base_amount": "0.00001261",
      "filled_base_amount": "0",
      "unfilled_base_amount": "0.00001261",
      "requested_quote_amount": null,
      "filled_quote_amount": "0",
      "unfilled_quote_amount": "0.999973",
      "filled_percent": "0",
      "trades_count": 0,
      "timestamp_create": 1788702442,
      "timestamp_update": 1788702862
    }
  ]
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Отмена всех ордеров Cancel all orders

Этот эндпоинт позволяет отменять все открытые и отложенные ордера по фильтрам. При успешном выполнении эндпоинт возвращает данные по отмененным ордерам в формате истории ордеров. This endpoint allows you to cancel all open and pending orders based on filters. If executed successfully, the endpoint returns data on canceled orders in order history format.

Заголовки Headers

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название заголовка и его обязательность. The «Name / Required» column displays the title of the heading and whether it is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип заголовка и его значение по умолчанию. The «Type / Default» column displays the header type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание заголовка и примеры указания заголовка. The «Description / Examples of specification» column displays the title description and examples of how to specify the title.
API-KEY Да Yes	String Нет No	Публичный API-ключ. HEX 64 символа Public API key. HEX 64 characters
API-SIGN Да Yes	String Нет No	Цифровая подпись запроса. HEX 128 символов Digital signature of the request. HEX 128 characters

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. order_id или order_id,pair Explicit selection of success response fields. order_id or order_id,pair
tonce Да Yes	Integer Нет No	Метка времени UNIX в миллисекундах. 1489617308123 (должна быть уникальной для каждого запроса) UNIX timestamp in milliseconds. 1489617308123 (must be unique for each request)
pair Нет No	String Все пары All pairs	Тикер торговой пары. BTC_USDT или BTC_USDT,ETH_USDT Ticker of the trading pair. BTC_USDT or BTC_USDT,ETH_USDT
type Нет No	String Все типы ордеров All order types	Тип ордера (limit, stop_limit, stop_market). limit или limit,stop_limit Order type (limit, stop_limit, stop_market). limit or limit,stop_limit
side Нет No	String Все стороны ордеров All order sides	Сторона ордера. buy или buy,sell Order side (buy, sell). buy or buy,sell
min_price Нет No	String 0.0000000001 0.0000000001	Минимальная цена. 0.0001 (от 0.0000000001 до 999999999999999). Minimum price. 0.0001 (from 0.0000000001 to 999999999999999).
max_price Нет No	String 999999999999999 999999999999999	Максимальная цена. 1000 (от 0.0000000001 до 999999999999999). Maximum price. 1000 (from 0.0000000001 to 999999999999999).

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
order_id	Integer	Идентификатор ордера. Order identifier.
label	String	Метка ордера. Order label.
status	String	Статус ордера. Order status.
pair	String	Тикер торговой пары. Ticker of the trading pair.
type	String	Тип ордера. Order type.
side	String	Сторона ордера. Order side.
stop_price	String	Цена активации отложенного ордера. The price to activate a pending order.
requested_price	String	Запрошенная (лимитная) цена ордера. Requested (limit) order price.
average_price	String	Средняя цена заполненного объема. Average price of filled volume.
requested_base_amount	String	Запрошенный объем в базовом активе. The requested volume in the base asset.
filled_base_amount	String	Заполненный объем в базовом активе. The filled volume in the base asset.
unfilled_base_amount	String	Незаполненный объем в базовом активе. Unfilled volume in the base asset.
requested_quote_amount	String	Запрошенный объем в котируемом активе. Requested volume in the quote asset.
filled_quote_amount	String	Заполненный объем в котируемом активе. The filled volume in the quote asset.
unfilled_quote_amount	String	Незаполненный объем в котируемом активе. Unfilled volume in the quote asset
filled_percent	String	Заполненный объем в процентах. Filled volume in percent.
trades_count	Integer	Количество торговых сделок. Number of trades.
timestamp_create	Integer	Метка времени создания ордера. Order creation timestamp.
timestamp_update	Integer	Метка времени обновления ордера. Order update timestamp.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "tonce", "pair", "type", "side", "min_price", "max_price" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "order_id", "label", "status", "pair", "type", "side", "stop_price", "requested_price", "average_price", "requested_base_amount", "filled_base_amount", "unfilled_base_amount", "requested_quote_amount", "filled_quote_amount", "unfilled_quote_amount", "filled_percent", "trades_count", "timestamp_create", "timestamp_update" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter is invalid.", "allowed_format": "Integer \| UNIX timestamp in milliseconds" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter exceeds the server time." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,)." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The type parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The type parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "limit", "stop_limit", "stop_market" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The side parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The side parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "buy", "sell" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_price parameter is invalid.", "allowed_format": "Integer \| from 0.0000000001 to 999999999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The max_price parameter is invalid.", "allowed_format": "Integer \| from 0.0000000001 to 999999999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_price parameter must not be greater than the max_price parameter." }
	401	Unauthorized	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-KEY header is invalid.", "allowed_format": "String \| 64 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The tonce parameter must be greater than the last accepted tonce." } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is invalid.", "allowed_format": "String \| 128 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is wrong." }
	403	Forbidden	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 403, "message": "Forbidden", "details": "The API key does not have permission to call this endpoint." } { "result": "error", "code": 403, "message": "Forbidden", "details": "The IP address is not allowed for this API key." }`
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the POST method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

POST

/cancel_all_orders

Аутентификация Authentication

требуется required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request POST \
  --url https://qutrade.io/api/v2/cancel_all_orders \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "API-KEY: MY_API_KEY_HEX" \
  --header "API-SIGN: MY_SIGNATURE_HEX" \
  --data tonce=1753180000000

$api_key_hex = 'MY_API_KEY_HEX';
$api_secret_hex = 'MY_API_SECRET_HEX';
$base_url = 'https://qutrade.io/api/v2';
$endpoint = '/cancel_all_orders';
$parameter['tonce'] = (int) (microtime(true) * 1000);
ksort($parameter);
$parameters = http_build_query($parameter);
$signature_hex = bin2hex(sodium_crypto_sign_detached($endpoint.$parameters, hex2bin($api_secret_hex)));
$headers = [
  'API-KEY: ' . $api_key_hex,
  'API-SIGN: ' . $signature_hex
];
$ch = curl_init($base_url.$endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
echo $result = curl_exec($ch);
curl_close($ch);

const apiKeyHex = 'MY_API_KEY_HEX';
const apiSecretHex = 'MY_API_SECRET_HEX';
const baseUrl = 'https://qutrade.io/api/v2';
const endpoint = '/cancel_all_orders';
const parameters = {
    tonce: Date.now()
};
const sortedParameters = Object.keys(parameters)
    .sort()
    .reduce((obj, key) => {
        obj[key] = parameters[key];
        return obj;
    }, {});
const queryString = new URLSearchParams(sortedParameters).toString();
const message = new TextEncoder().encode(endpoint + queryString);
const secretKey = hexToUint8Array(apiSecretHex);
const signature = nacl.sign.detached(message, secretKey);
const signatureHex = uint8ArrayToHex(signature);
fetch(baseUrl + endpoint, {
    method: 'POST',
    headers: {
        'API-KEY': apiKeyHex,
        'API-SIGN': signatureHex,
        'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: queryString
})
.then(response => response.json())
.then(console.log)
.catch(console.error);
function hexToUint8Array(hex) {
    return Uint8Array.from(hex.match(/.{2}/g).map(byte => parseInt(byte, 16)));
}
function uint8ArrayToHex(bytes) {
    return Array.from(bytes)
        .map(b => b.toString(16).padStart(2, '0'))
        .join('');
}

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": [
    {
      "order_id": 3393736,
      "label": null,
      "status": "canceled",
      "pair": "BTC_USDT",
      "type": "limit",
      "side": "buy",
      "stop_price": null,
      "requested_price": "79300",
      "average_price": null,
      "requested_base_amount": "0.00001261",
      "filled_base_amount": "0",
      "unfilled_base_amount": "0.00001261",
      "requested_quote_amount": null,
      "filled_quote_amount": "0",
      "unfilled_quote_amount": "0.999973",
      "filled_percent": "0",
      "trades_count": 0,
      "timestamp_create": 1788702442,
      "timestamp_update": 1788702862
    }
  ]
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Открытые ордера Open orders

Этот эндпоинт позволяет получать открытые ордера. This endpoint allows you to retrieve open orders.

Заголовки Headers

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название заголовка и его обязательность. The «Name / Required» column displays the title of the heading and whether it is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип заголовка и его значение по умолчанию. The «Type / Default» column displays the header type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание заголовка и примеры указания заголовка. The «Description / Examples of specification» column displays the title description and examples of how to specify the title.
API-KEY Да Yes	String Нет No	Публичный API ключ. HEX 64 символа Public API key. HEX 64 characters
API-SIGN Да Yes	String Нет No	Цифровая подпись запроса. HEX 128 символов Digital signature of the request. HEX 128 characters

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. order_id или order_id,pair Explicit selection of success response fields. order_id or order_id,pair
tonce Да Yes	Integer Нет No	Метка времени UNIX в миллисекундах. 1489617308123 (должна быть уникальной для каждого запроса) UNIX timestamp in milliseconds. 1489617308123 (must be unique for each request)
pair Нет No	String Все пары All pairs	Тикер торговой пары. BTC_USDT или BTC_USDT,ETH_USDT Ticker of the trading pair. BTC_USDT or BTC_USDT,ETH_USDT

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
order_id	Integer	Идентификатор ордера. Order identifier.
label	String	Метка ордера. Order label.
status	String	Статус ордера (opened - новый, filling - частично заполненный). Order status (opened - new, filling - partially filled).
pair	String	Тикер торговой пары. Ticker of the trading pair.
type	String	Тип ордера. Order type.
side	String	Сторона ордера. Order side.
stop_price	String	Цена активации отложенного ордера. The price to activate a pending order.
requested_price	String	Запрошенная (лимитная) цена. Requested (limit) price.
average_price	String	Средняя цена заполненного объема. Average price of filled volume.
requested_base_amount	String	Запрошенный объем в базовом активе. Requested volume in the base asset.
filled_base_amount	String	Заполненный объем в базовом активе. The filled volume in the base asset.
unfilled_base_amount	String	Незаполненный объем в базовом активе. Unfilled volume in the base asset.
requested_quote_amount	String	Запрошенный объем в котируемом активе. Requested volume in the quote asset.
filled_quote_amount	String	Заполненный объем в котируемом активе. The filled volume in the quote asset.
unfilled_quote_amount	String	Незаполненный объем в котируемом активе. Unfilled volume in the quote asset.
filled_percent	String	Заполненный объем в процентах. Filled volume in percent.
trades_count	Integer	Количество торговых сделок. Number of trades.
timestamp_create	Integer	Метка времени создания ордера. Order creation timestamp.
timestamp_update	Integer	Метка времени обновления ордера. Order update timestamp.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "tonce", "pair" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "order_id", "label", "status", "pair", "type", "side", "stop_price", "requested_price", "average_price", "requested_base_amount", "filled_base_amount", "unfilled_base_amount", "requested_quote_amount", "filled_quote_amount", "unfilled_quote_amount", "filled_percent", "trades_count", "timestamp_create", "timestamp_update" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter is invalid.", "allowed_format": "Integer \| UNIX timestamp in milliseconds" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter exceeds the server time." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,)." }
	401	Unauthorized	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-KEY header is invalid.", "allowed_format": "String \| 64 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The tonce parameter must be greater than the last accepted tonce." } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is invalid.", "allowed_format": "String \| 128 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is wrong." }
	403	Forbidden	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 403, "message": "Forbidden", "details": "The API key does not have permission to call this endpoint." } { "result": "error", "code": 403, "message": "Forbidden", "details": "The IP address is not allowed for this API key." }`
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the POST method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

POST

/open_orders

Аутентификация Authentication

требуется required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request POST \
  --url https://qutrade.io/api/v2/open_orders \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "API-KEY: MY_API_KEY_HEX" \
  --header "API-SIGN: MY_SIGNATURE_HEX" \
  --data tonce=1753180000000

$api_key_hex = 'MY_API_KEY_HEX';
$api_secret_hex = 'MY_API_SECRET_HEX';
$base_url = 'https://qutrade.io/api/v2';
$endpoint = '/open_orders';
$parameter['tonce'] = (int) (microtime(true) * 1000);
ksort($parameter);
$parameters = http_build_query($parameter);
$signature_hex = bin2hex(sodium_crypto_sign_detached($endpoint.$parameters, hex2bin($api_secret_hex)));
$headers = [
  'API-KEY: ' . $api_key_hex,
  'API-SIGN: ' . $signature_hex
];
$ch = curl_init($base_url.$endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
echo $result = curl_exec($ch);
curl_close($ch);

const apiKeyHex = 'MY_API_KEY_HEX';
const apiSecretHex = 'MY_API_SECRET_HEX';
const baseUrl = 'https://qutrade.io/api/v2';
const endpoint = '/open_orders';
const parameters = {
    tonce: Date.now()
};
const sortedParameters = Object.keys(parameters)
    .sort()
    .reduce((obj, key) => {
        obj[key] = parameters[key];
        return obj;
    }, {});
const queryString = new URLSearchParams(sortedParameters).toString();
const message = new TextEncoder().encode(endpoint + queryString);
const secretKey = hexToUint8Array(apiSecretHex);
const signature = nacl.sign.detached(message, secretKey);
const signatureHex = uint8ArrayToHex(signature);
fetch(baseUrl + endpoint, {
    method: 'POST',
    headers: {
        'API-KEY': apiKeyHex,
        'API-SIGN': signatureHex,
        'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: queryString
})
.then(response => response.json())
.then(console.log)
.catch(console.error);
function hexToUint8Array(hex) {
    return Uint8Array.from(hex.match(/.{2}/g).map(byte => parseInt(byte, 16)));
}
function uint8ArrayToHex(bytes) {
    return Array.from(bytes)
        .map(b => b.toString(16).padStart(2, '0'))
        .join('');
}

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": [
    {
      "order_id": 3365853,
      "label": null,
      "status": "opened",
      "pair": "DASH_USDT",
      "type": "limit",
      "side": "buy",
      "stop_price": null,
      "requested_price": "45.38",
      "average_price": null,
      "requested_base_amount": "0.022036",
      "filled_base_amount": "0",
      "unfilled_base_amount": "0.022036",
      "requested_quote_amount": "0.99996039",
      "filled_quote_amount": "0",
      "unfilled_quote_amount": "0.99999368",
      "filled_percent": "0",
      "trades_count": 0,
      "timestamp_create": 1788185315,
      "timestamp_update": 1788185315
    },
    ...
  ]
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Отложенные ордера Pending orders

Этот эндпоинт позволяет получать отложенные ордера. This endpoint allows you to receive pending orders.

Заголовки Headers

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название заголовка и его обязательность. The «Name / Required» column displays the title of the heading and whether it is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип заголовка и его значение по умолчанию. The «Type / Default» column displays the header type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание заголовка и примеры указания заголовка. The «Description / Examples of specification» column displays the title description and examples of how to specify the title.
API-KEY Да Yes	String Нет No	Публичный API-ключ. HEX 64 символа Public API key. HEX 64 characters
API-SIGN Да Yes	String Нет No	Цифровая подпись запроса. HEX 128 символов Digital signature of the request. HEX 128 characters

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. order_id или order_id,pair Explicit selection of success response fields. order_id or order_id,pair
tonce Да Yes	Integer Нет No	Метка времени UNIX в миллисекундах. 1489617308123 (должна быть уникальной для каждого запроса) UNIX timestamp in milliseconds. 1489617308123 (must be unique for each request)
pair Нет No	String Все пары All pairs	Тикер торговой пары. BTC_USDT или BTC_USDT,ETH_USDT Ticker of the trading pair. BTC_USDT or BTC_USDT,ETH_USDT

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
order_id	Integer	Идентификатор ордера. Order identifier.
label	String	Метка ордера. Order label.
status	String	Статус ордера (waiting - ожидает достижения стоп-цены). Order status (waiting - waiting for the stop price to be reached).
pair	String	Тикер торговой пары. Ticker of the trading pair.
type	String	Тип ордера. Order type.
side	String	Сторона ордера. Order side.
stop_price	String	Цена активации отложенного ордера. Pending order activation price.
requested_price	String	Запрошенная (лимитная) цена ордера. Requested (limit) order price.
average_price	String	Средняя цена заполненного объема. Average price of filled volume.
requested_base_amount	String	Запрошенный объем в базовом активе. Requested volume in the base asset.
filled_base_amount	String	Заполненный объем в базовом активе. The filled volume in the base asset.
unfilled_base_amount	String	Незаполненный объем в базовом активе. Unfilled volume in the base asset.
requested_quote_amount	String	Запрошенный объем в котируемом активе. Requested volume in the quote asset.
filled_quote_amount	String	Заполненный объем в котируемом активе. The filled volume in the quote asset.
unfilled_quote_amount	String	Незаполненный объем в котируемом активе. Unfilled volume in the quote asset.
filled_percent	String	Заполненный объем в процентах. Filled volume in percent.
trades_count	Integer	Количество торговых сделок. Number of trades.
timestamp_create	Integer	Метка времени создания ордера. Order creation timestamp.
timestamp_update	Integer	Метка времени обновления ордера. Order update timestamp.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "tonce", "pair" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "order_id", "label", "status", "pair", "type", "side", "stop_price", "requested_price", "average_price", "requested_base_amount", "filled_base_amount", "unfilled_base_amount", "requested_quote_amount", "filled_quote_amount", "unfilled_quote_amount", "filled_percent", "trades_count", "timestamp_create", "timestamp_update" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter is invalid.", "allowed_format": "Integer \| UNIX timestamp in milliseconds" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter exceeds the server time." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,)." }
	401	Unauthorized	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-KEY header is invalid.", "allowed_format": "String \| 64 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The tonce parameter must be greater than the last accepted tonce." } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is invalid.", "allowed_format": "String \| 128 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is wrong." }
	403	Forbidden	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 403, "message": "Forbidden", "details": "The API key does not have permission to call this endpoint." } { "result": "error", "code": 403, "message": "Forbidden", "details": "The IP address is not allowed for this API key." }`
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the POST method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

POST

/pending_orders

Аутентификация Authentication

требуется required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request POST \
  --url https://qutrade.io/api/v2/pending_orders \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "API-KEY: MY_API_KEY_HEX" \
  --header "API-SIGN: MY_SIGNATURE_HEX" \
  --data tonce=1753180000000

$api_key_hex = 'MY_API_KEY_HEX';
$api_secret_hex = 'MY_API_SECRET_HEX';
$base_url = 'https://qutrade.io/api/v2';
$endpoint = '/pending_orders';
$parameter['tonce'] = (int) (microtime(true) * 1000);
ksort($parameter);
$parameters = http_build_query($parameter);
$signature_hex = bin2hex(sodium_crypto_sign_detached($endpoint.$parameters, hex2bin($api_secret_hex)));
$headers = [
  'API-KEY: ' . $api_key_hex,
  'API-SIGN: ' . $signature_hex
];
$ch = curl_init($base_url.$endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
echo $result = curl_exec($ch);
curl_close($ch);

const apiKeyHex = 'MY_API_KEY_HEX';
const apiSecretHex = 'MY_API_SECRET_HEX';
const baseUrl = 'https://qutrade.io/api/v2';
const endpoint = '/pending_orders';
const parameters = {
    tonce: Date.now()
};
const sortedParameters = Object.keys(parameters)
    .sort()
    .reduce((obj, key) => {
        obj[key] = parameters[key];
        return obj;
    }, {});
const queryString = new URLSearchParams(sortedParameters).toString();
const message = new TextEncoder().encode(endpoint + queryString);
const secretKey = hexToUint8Array(apiSecretHex);
const signature = nacl.sign.detached(message, secretKey);
const signatureHex = uint8ArrayToHex(signature);
fetch(baseUrl + endpoint, {
    method: 'POST',
    headers: {
        'API-KEY': apiKeyHex,
        'API-SIGN': signatureHex,
        'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: queryString
})
.then(response => response.json())
.then(console.log)
.catch(console.error);
function hexToUint8Array(hex) {
    return Uint8Array.from(hex.match(/.{2}/g).map(byte => parseInt(byte, 16)));
}
function uint8ArrayToHex(bytes) {
    return Array.from(bytes)
        .map(b => b.toString(16).padStart(2, '0'))
        .join('');
}

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": [
    {
      "order_id": 3393655,
      "label": null,
      "status": "waiting",
      "pair": "BTC_USDT",
      "type": "stop_limit",
      "side": "buy",
      "stop_price": "1",
      "requested_price": "79299",
      "average_price": null,
      "requested_base_amount": "0.00001261",
      "filled_base_amount": "",
      "unfilled_base_amount": "0.00001261",
      "requested_quote_amount": "0.99996039",
      "filled_quote_amount": "0",
      "unfilled_quote_amount": "0.99996039",
      "filled_percent": "0",
      "trades_count": 0,
      "timestamp_create": 1788701280,
      "timestamp_update": 1788701280
    }
  ]
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required field in responses. This speeds up response times and reduces data traffic.

История ордеров Order history

Этот эндпоинт позволяет получать историю ордеров. This endpoint allows you to retrieve order history.

Заголовки Headers

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название заголовка и его обязательность. The «Name / Required» column displays the title of the heading and whether it is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип заголовка и его значение по умолчанию. The «Type / Default» column displays the header type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание заголовка и примеры указания заголовка. The «Description / Examples of specification» column displays the title description and examples of how to specify the title.
API-KEY Да Yes	String Нет No	Публичный API-ключ. HEX 64 символа Public API key. HEX 64 characters
API-SIGN Да Yes	String Нет No	Цифровая подпись запроса. HEX 128 символов Digital signature of the request. HEX 128 characters

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. order_id или order_id,pair Explicit selection of success response fields. order_id or order_id,pair
tonce Да Yes	Integer Нет No	Метка времени UNIX в миллисекундах. 1489617308123 (должна быть уникальной для каждого запроса) UNIX timestamp in milliseconds. 1489617308123 (must be unique for each request)
pair Нет No	String Все пары All pairs	Тикер торговой пары. BTC_USDT или BTC_USDT,ETH_USDT Ticker of the trading pair. BTC_USDT or BTC_USDT,ETH_USDT
min_timestamp_create Нет No	Integer 1 1	Минимальная метка времени создания ордера. 1787798000 (от 1 до 9999999999) Minimum order creation timestamp. 1787798000 (from 1 to 9999999999)
max_timestamp_create Нет No	Integer 9999999999 9999999999	Максимальная метка времени создания ордера. 1787799000 (от 1 до 9999999999) Maximum order creation timestamp. 1787799000 (from 1 to 9999999999)
limit Нет No	Integer 10 10	Количество ордеров. 25 (от 1 до 1000) Number of orders. 25 (from 1 to 1000)

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
order_id	Integer	Идентификатор ордера. Order identifier.
label	String	Метка ордера. Order label.
status	String	Статус ордера. Order status.
pair	String	Тикер торговой пары. Ticker of the trading pair.
type	String	Тип ордера. Order type.
side	String	Сторона ордера. Order side.
stop_price	String	Цена активации отложенного ордера. The price to activate a pending order.
requested_price	String	Запрошенная (лимитная) цена ордера. Requested (limit) order price.
average_price	String	Средняя цена заполненного объема. Average price of filled volume.
requested_base_amount	String	Запрошенный объем в базовом активе. The requested volume in the base asset.
filled_base_amount	String	Заполненный объем в базовом активе. The filled volume in the base asset.
unfilled_base_amount	String	Незаполненный объем в базовом активе. Unfilled volume in the base asset.
requested_quote_amount	String	Запрошенный объем в котируемом активе. Requested volume in the quote asset.
filled_quote_amount	String	Заполненный объем в котируемом активе. The filled volume in the quote asset.
unfilled_quote_amount	String	Незаполненный объем в котируемом активе. Unfilled volume in the quote asset.
filled_percent	String	Заполненный объем в процентах. Filled volume in percent.
trades_count	Integer	Количество торговых сделок. Number of trades.
timestamp_create	Integer	Метка времени создания ордера. Order creation timestamp.
timestamp_update	Integer	Метка времени обновления ордера. Order update timestamp.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "tonce", "pair", "min_timestamp_create", "max_timestamp_create", "limit" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "order_id", "label", "status", "pair", "type", "side", "stop_price", "requested_price", "average_price", "requested_base_amount", "filled_base_amount", "unfilled_base_amount", "requested_quote_amount", "filled_quote_amount", "unfilled_quote_amount", "filled_percent", "trades_count", "timestamp_create", "timestamp_update" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter is invalid.", "allowed_format": "Integer \| UNIX timestamp in milliseconds" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter exceeds the server time." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter is invalid." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_timestamp_create parameter is invalid.", "allowed_format": "Integer \| from 1 to 9999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The max_timestamp_create parameter is invalid.", "allowed_format": "Integer \| from 1 to 9999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_timestamp_create parameter must not be greater than the max_timestamp_create parameter." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The limit parameter is invalid.", "allowed_format": "Integer \| from 1 to 1000." }
	401	Unauthorized	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-KEY header is invalid.", "allowed_format": "String \| 64 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The tonce parameter must be greater than the last accepted tonce." } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is invalid.", "allowed_format": "String \| 128 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is wrong." }
	403	Forbidden	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 403, "message": "Forbidden", "details": "The API key does not have permission to call this endpoint." } { "result": "error", "code": 403, "message": "Forbidden", "details": "The IP address is not allowed for this API key." }`
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the POST method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

POST

/order_history

Аутентификация Authentication

требуется required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request POST \
  --url https://qutrade.io/api/v2/order_history \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "API-KEY: MY_API_KEY_HEX" \
  --header "API-SIGN: MY_SIGNATURE_HEX" \
  --data tonce=1753180000000

$api_key_hex = 'MY_API_KEY_HEX';
$api_secret_hex = 'MY_API_SECRET_HEX';
$base_url = 'https://qutrade.io/api/v2';
$endpoint = '/order_history';
$parameter['tonce'] = (int) (microtime(true) * 1000);
ksort($parameter);
$parameters = http_build_query($parameter);
$signature_hex = bin2hex(sodium_crypto_sign_detached($endpoint.$parameters, hex2bin($api_secret_hex)));
$headers = [
  'API-KEY: ' . $api_key_hex,
  'API-SIGN: ' . $signature_hex
];
$ch = curl_init($base_url.$endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
echo $result = curl_exec($ch);
curl_close($ch);

const apiKeyHex = 'MY_API_KEY_HEX';
const apiSecretHex = 'MY_API_SECRET_HEX';
const baseUrl = 'https://qutrade.io/api/v2';
const endpoint = '/order_history';
const parameters = {
    tonce: Date.now()
};
const sortedParameters = Object.keys(parameters)
    .sort()
    .reduce((obj, key) => {
        obj[key] = parameters[key];
        return obj;
    }, {});
const queryString = new URLSearchParams(sortedParameters).toString();
const message = new TextEncoder().encode(endpoint + queryString);
const secretKey = hexToUint8Array(apiSecretHex);
const signature = nacl.sign.detached(message, secretKey);
const signatureHex = uint8ArrayToHex(signature);
fetch(baseUrl + endpoint, {
    method: 'POST',
    headers: {
        'API-KEY': apiKeyHex,
        'API-SIGN': signatureHex,
        'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: queryString
})
.then(response => response.json())
.then(console.log)
.catch(console.error);
function hexToUint8Array(hex) {
    return Uint8Array.from(hex.match(/.{2}/g).map(byte => parseInt(byte, 16)));
}
function uint8ArrayToHex(bytes) {
    return Array.from(bytes)
        .map(b => b.toString(16).padStart(2, '0'))
        .join('');
}

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": [
    {
      "order_id": 3393380,
      "label": null,
      "status": "filled",
      "pair": "BTC_USDT",
      "type": "limit",
      "side": "sell",
      "stop_price": null,
      "requested_price": "79500",
      "average_price": "79566.8437094937",
      "requested_base_amount": "0.00025459",
      "filled_base_amount": "0.00025459",
      "unfilled_base_amount": "0",
      "requested_quote_amount": "20.25692274",
      "filled_quote_amount": "20.25692274",
      "unfilled_quote_amount": "0",
      "filled_percent": "100",
      "trades_count": 1,
      "timestamp_create": 1788696817,
      "timestamp_update": 1788696817
    },
    ...
  ]
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

История сделок Trades history

Этот эндпоинт позволяет получать историю последних сделок. This endpoint allows you to get the history of recent trades.

Заголовки Headers

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название заголовка и его обязательность. The «Name / Required» column displays the title of the heading and whether it is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип заголовка и его значение по умолчанию. The «Type / Default» column displays the header type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание заголовка и примеры указания заголовка. The «Description / Examples of specification» column displays the title description and examples of how to specify the title.
API-KEY Да Yes	String Нет No	Публичный API-ключ. HEX 64 символа Public API key. HEX 64 characters
API-SIGN Да Yes	String Нет No	Цифровая подпись запроса. HEX 128 символов Digital signature of the request. HEX 128 characters

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. pair или pair,side Explicit selection of success response fields. pair or pair,side
tonce Да Yes	Integer Нет No	Метка времени UNIX в миллисекундах. 1489617308123 (должна быть уникальной для каждого запроса) UNIX timestamp in milliseconds. 1489617308123 (must be unique for each request)
pair Нет No	String Все пары All pairs	Тикер торговой пары. BTC_USDT или BTC_USDT,ETH_USDT Ticker of the trading pair. BTC_USDT or BTC_USDT,ETH_USDT
min_timestamp Нет No	Integer 1 1	Начальная метка времени. 1787798000 (от 1 до 9999999999) Start timestamp. 1787798000 (from 1 to 9999999999)
max_timestamp Нет No	Integer 9999999999 9999999999	Конечная метка времени. 1787799000 (от 1 до 9999999999) End timestamp. 1787799000 (from 1 to 9999999999)
limit Нет No	Integer 10 10	Количество сделок. 25 (от 1 до 1000) Number of trades. 25 (from 1 to 1000)

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
pair	String	Тикер торговой пары. Ticker of the trading pair.
side	String	Сторона сделки. Trade side.
price	String	Цена сделки. Trade price.
base_amount	String	Объем сделки в базовом активе. The volume of the trade in the base asset.
quote_amount	String	Объем сделки в котируемом активе. The volume of the trade in a quote asset.
volume_usd	String	Объем сделки в USD. The volume of the transaction in USD.
fee_asset_ticker	String	Тикер актива оплаты комиссии. Ticker of the fee payment asset.
fee	String	Комиссия сделки. Trade commission.
fee_usd	String	Комиссия сделки в USD. Trade commission in the USD.
fee_percent	String	Комиссия сделки в процентах. Trade commission in the percent.
role	String	Роль сделки. The role of the trade.
timestamp	Integer	Метка времени проведения сделки. Timestamp of the trade.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "tonce", "pair", "min_timestamp", "max_timestamp", "limit" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "pair", "side", "price", "base_amount", "quote_amount", "volume_usd", "fee_asset_ticker", "fee", "fee_usd", "fee_percent", "role", "timestamp" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter is invalid.", "allowed_format": "Integer \| UNIX timestamp in milliseconds" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter exceeds the server time." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The pair parameter is invalid." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_timestamp parameter is invalid.", "allowed_format": "Integer \| from 1 to 9999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The max_timestamp parameter is invalid.", "allowed_format": "Integer \| from 1 to 9999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_timestamp parameter must not be greater than the max_timestamp parameter." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The limit parameter is invalid.", "allowed_format": "Integer \| from 1 to 1000." }
	401	Unauthorized	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-KEY header is invalid.", "allowed_format": "String \| 64 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The tonce parameter must be greater than the last accepted tonce." } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is invalid.", "allowed_format": "String \| 128 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is wrong." }
	403	Forbidden	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 403, "message": "Forbidden", "details": "The API key does not have permission to call this endpoint." } { "result": "error", "code": 403, "message": "Forbidden", "details": "The IP address is not allowed for this API key." }`
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the POST method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

POST

/trades_history

Аутентификация Authentication

требуется required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request POST \
  --url https://qutrade.io/api/v2/trades_history \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "API-KEY: MY_API_KEY_HEX" \
  --header "API-SIGN: MY_SIGNATURE_HEX" \
  --data tonce=1753180000000

$api_key_hex = 'MY_API_KEY_HEX';
$api_secret_hex = 'MY_API_SECRET_HEX';
$base_url = 'https://qutrade.io/api/v2';
$endpoint = '/trades_history';
$parameter['tonce'] = (int) (microtime(true) * 1000);
ksort($parameter);
$parameters = http_build_query($parameter);
$signature_hex = bin2hex(sodium_crypto_sign_detached($endpoint.$parameters, hex2bin($api_secret_hex)));
$headers = [
  'API-KEY: ' . $api_key_hex,
  'API-SIGN: ' . $signature_hex
];
$ch = curl_init($base_url.$endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
echo $result = curl_exec($ch);
curl_close($ch);

const apiKeyHex = 'MY_API_KEY_HEX';
const apiSecretHex = 'MY_API_SECRET_HEX';
const baseUrl = 'https://qutrade.io/api/v2';
const endpoint = '/trades_history';
const parameters = {
    tonce: Date.now()
};
const sortedParameters = Object.keys(parameters)
    .sort()
    .reduce((obj, key) => {
        obj[key] = parameters[key];
        return obj;
    }, {});
const queryString = new URLSearchParams(sortedParameters).toString();
const message = new TextEncoder().encode(endpoint + queryString);
const secretKey = hexToUint8Array(apiSecretHex);
const signature = nacl.sign.detached(message, secretKey);
const signatureHex = uint8ArrayToHex(signature);
fetch(baseUrl + endpoint, {
    method: 'POST',
    headers: {
        'API-KEY': apiKeyHex,
        'API-SIGN': signatureHex,
        'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: queryString
})
.then(response => response.json())
.then(console.log)
.catch(console.error);
function hexToUint8Array(hex) {
    return Uint8Array.from(hex.match(/.{2}/g).map(byte => parseInt(byte, 16)));
}
function uint8ArrayToHex(bytes) {
    return Array.from(bytes)
        .map(b => b.toString(16).padStart(2, '0'))
        .join('');
}

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": [
    {
      "pair": "BNB_USDT",
      "side": "buy",
      "price": "703.4997555946",
      "base_amount": "0.0013093",
      "quote_amount": "0.92109223",
      "volume_usd": "0.92109223",
      "fee_asset_ticker": "BNB",
      "fee": "0.0000013093",
      "fee_usd": "0.00092031",
      "fee_percent": "0.1",
      "role": "taker",
      "timestamp": 1788235394
    },
    ...
  ]
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Балансы Balances

Этот эндпоинт позволяет получать информацию о балансах. При успешном выполнении запроса эндпоинт возвращает доступные балансы, зарезервированные балансы в ордерах и пулах ликвидности. This endpoint allows you to retrieve balance information. If the request is successful, the endpoint returns available balances, reserved balances in orders, and liquidity pools.

Заголовки Headers

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название заголовка и его обязательность. The «Name / Required» column displays the title of the heading and whether it is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип заголовка и его значение по умолчанию. The «Type / Default» column displays the header type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание заголовка и примеры указания заголовка. The «Description / Examples of specification» column displays the title description and examples of how to specify the title.
API-KEY Да Yes	String Нет No	Публичный API-ключ. HEX 64 символа Public API key. HEX 64 characters
API-SIGN Да Yes	String Нет No	Цифровая подпись запроса. HEX 128 символов Digital signature of the request. HEX 128 characters

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. total или total,available Explicit selection of success response fields. total or total,available
tonce Да Yes	Integer Нет No	Метка времени UNIX в миллисекундах. 1489617308123 (должна быть уникальной для каждого запроса) UNIX timestamp in milliseconds. 1489617308123 (must be unique for each request)
currency Нет No	String Все валюты All currencies	Тикер валюты. BTC или BTC,ETH Currency ticker. BTC or BTC,ETH
hide_zeros Нет No	Boolean false false	Скрыть нулевые балансы. true Hide zero balances. true

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
total	String	Общая сумма активов. Total assets.
available	String	Сумма доступных активов. Amount of available assets.
in_orders	String	Активы, замороженные в ордерах. Assets frozen in orders.
in_pools	String	Активы, замороженные в пулах ликвидности. Assets frozen in pools.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "total", "available", "in_orders", "in_pools" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter is invalid.", "allowed_format": "Integer \| UNIX timestamp in milliseconds" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter exceeds the server time." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The currency parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The currency parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,)." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The hide_zeros parameter is invalid.", "allowed_format": "Boolean." }
	401	Unauthorized	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "tonce", "currency", "hide_zeros" ] } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-KEY header is invalid.", "allowed_format": "String \| 64 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The tonce parameter must be greater than the last accepted tonce." } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is invalid.", "allowed_format": "String \| 128 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is wrong." }
	403	Forbidden	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 403, "message": "Forbidden", "details": "The API key does not have permission to call this endpoint." } { "result": "error", "code": 403, "message": "Forbidden", "details": "The IP address is not allowed for this API key." }`
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the POST method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

POST

/balances

Аутентификация Authentication

требуется required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request POST \
  --url https://qutrade.io/api/v2/balances \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "API-KEY: MY_API_KEY_HEX" \
  --header "API-SIGN: MY_SIGNATURE_HEX" \
  --data tonce=1753180000000

$api_key_hex = 'MY_API_KEY_HEX';
$api_secret_hex = 'MY_API_SECRET_HEX';
$base_url = 'https://qutrade.io/api/v2';
$endpoint = '/balances';
$parameter['tonce'] = (int) (microtime(true) * 1000);
ksort($parameter);
$parameters = http_build_query($parameter);
$signature_hex = bin2hex(sodium_crypto_sign_detached($endpoint.$parameters, hex2bin($api_secret_hex)));
$headers = [
  'API-KEY: ' . $api_key_hex,
  'API-SIGN: ' . $signature_hex
];
$ch = curl_init($base_url.$endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
echo $result = curl_exec($ch);
curl_close($ch);

const apiKeyHex = 'MY_API_KEY_HEX';
const apiSecretHex = 'MY_API_SECRET_HEX';
const baseUrl = 'https://qutrade.io/api/v2';
const endpoint = '/balances';
const parameters = {
    tonce: Date.now()
};
const sortedParameters = Object.keys(parameters)
    .sort()
    .reduce((obj, key) => {
        obj[key] = parameters[key];
        return obj;
    }, {});
const queryString = new URLSearchParams(sortedParameters).toString();
const message = new TextEncoder().encode(endpoint + queryString);
const secretKey = hexToUint8Array(apiSecretHex);
const signature = nacl.sign.detached(message, secretKey);
const signatureHex = uint8ArrayToHex(signature);
fetch(baseUrl + endpoint, {
    method: 'POST',
    headers: {
        'API-KEY': apiKeyHex,
        'API-SIGN': signatureHex,
        'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: queryString
})
.then(response => response.json())
.then(console.log)
.catch(console.error);
function hexToUint8Array(hex) {
    return Uint8Array.from(hex.match(/.{2}/g).map(byte => parseInt(byte, 16)));
}
function uint8ArrayToHex(bytes) {
    return Array.from(bytes)
        .map(b => b.toString(16).padStart(2, '0'))
        .join('');
}
<script src="/js/nacl-fast.min.js"></script>

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": {
    "BTC": {
      "total": "0.0444604761",
      "available": "0.0444541357",
      "in_orders": "0",
      "in_pools": "0.0000063404"
    },
    ...
  }
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Адреса для депозитов Deposit addresses

Этот эндпоинт позволяет получать сгенерированные адреса для пополнения баланса для монет и сетей. This endpoint allows you to receive generated addresses for replenishing the balance for coins and networks.

Заголовки Headers

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название заголовка и его обязательность. The «Name / Required» column displays the title of the heading and whether it is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип заголовка и его значение по умолчанию. The «Type / Default» column displays the header type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание заголовка и примеры указания заголовка. The «Description / Examples of specification» column displays the title description and examples of how to specify the title.
API-KEY Да Yes	String Нет No	Публичный API-ключ. HEX 64 символа Public API key. HEX 64 characters
API-SIGN Да Yes	String Нет No	Цифровая подпись запроса. HEX 128 символов Digital signature of the request. HEX 128 characters

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
tonce Да Yes	Integer Нет No	Метка времени UNIX в миллисекундах. 1489617308123 (должна быть уникальной для каждого запроса) UNIX timestamp in milliseconds. 1489617308123 (must be unique for each request)
currency Нет No	String Все валюты All currencies	Тикер валюты. BTC или BTC,ETH Currency ticker. BTC or BTC,ETH

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
chain	String	Тикер сети. Network ticker.
address	String	Адрес для депозита. Deposit address.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter is invalid.", "allowed_format": "Integer \| UNIX timestamp in milliseconds" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter exceeds the server time." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The currency parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The currency parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,)." }
	401	Unauthorized	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "tonce", "currency" ] } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-KEY header is invalid.", "allowed_format": "String \| 64 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The tonce parameter must be greater than the last accepted tonce." } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is invalid.", "allowed_format": "String \| 128 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is wrong." }
	403	Forbidden	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 403, "message": "Forbidden", "details": "The API key does not have permission to call this endpoint." } { "result": "error", "code": 403, "message": "Forbidden", "details": "The IP address is not allowed for this API key." }`
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the POST method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

POST

/deposit_addresses

Аутентификация Authentication

требуется required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request POST \
  --url https://qutrade.io/api/v2/deposit_addresses \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "API-KEY: MY_API_KEY_HEX" \
  --header "API-SIGN: MY_SIGNATURE_HEX" \
  --data tonce=1753180000000

$api_key_hex = 'MY_API_KEY_HEX';
$api_secret_hex = 'MY_API_SECRET_HEX';
$base_url = 'https://qutrade.io/api/v2';
$endpoint = '/deposit_addresses';
$parameter['tonce'] = (int) (microtime(true) * 1000);
ksort($parameter);
$parameters = http_build_query($parameter);
$signature_hex = bin2hex(sodium_crypto_sign_detached($endpoint.$parameters, hex2bin($api_secret_hex)));
$headers = [
  'API-KEY: ' . $api_key_hex,
  'API-SIGN: ' . $signature_hex
];
$ch = curl_init($base_url.$endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
echo $result = curl_exec($ch);
curl_close($ch);

const apiKeyHex = 'MY_API_KEY_HEX';
const apiSecretHex = 'MY_API_SECRET_HEX';
const baseUrl = 'https://qutrade.io/api/v2';
const endpoint = '/deposit_addresses';
const parameters = {
    tonce: Date.now()
};
const sortedParameters = Object.keys(parameters)
    .sort()
    .reduce((obj, key) => {
        obj[key] = parameters[key];
        return obj;
    }, {});
const queryString = new URLSearchParams(sortedParameters).toString();
const message = new TextEncoder().encode(endpoint + queryString);
const secretKey = hexToUint8Array(apiSecretHex);
const signature = nacl.sign.detached(message, secretKey);
const signatureHex = uint8ArrayToHex(signature);
fetch(baseUrl + endpoint, {
    method: 'POST',
    headers: {
        'API-KEY': apiKeyHex,
        'API-SIGN': signatureHex,
        'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: queryString
})
.then(response => response.json())
.then(console.log)
.catch(console.error);
function hexToUint8Array(hex) {
    return Uint8Array.from(hex.match(/.{2}/g).map(byte => parseInt(byte, 16)));
}
function uint8ArrayToHex(bytes) {
    return Array.from(bytes)
        .map(b => b.toString(16).padStart(2, '0'))
        .join('');
}
<script src="/js/nacl-fast.min.js"></script>

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": {
    "BTC": [
      {
        "chain": "BTC",
        "address": "bc1qw8syhvqrj5yq0z98j62w3s9jxmggmjtv0s96v5"
      },
      ...
    ],
    ...
  }
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

История транзакций Transaction history

Этот эндпоинт позволяет получать историю последних транзакций. This endpoint allows you to retrieve the history of recent transactions.

Заголовки Headers

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название заголовка и его обязательность. The «Name / Required» column displays the title of the heading and whether it is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип заголовка и его значение по умолчанию. The «Type / Default» column displays the header type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание заголовка и примеры указания заголовка. The «Description / Examples of specification» column displays the title description and examples of how to specify the title.
API-KEY Да Yes	String Нет No	Публичный API-ключ. HEX 64 символа Public API key. HEX 64 characters
API-SIGN Да Yes	String Нет No	Цифровая подпись запроса. HEX 128 символов Digital signature of the request. HEX 128 characters

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. id или id,type Explicit selection of success response fields. id or id,type
tonce Да Yes	Integer Нет No	Метка времени UNIX в миллисекундах. 1489617308123 (должна быть уникальной для каждого запроса) UNIX timestamp in milliseconds. 1489617308123 (must be unique for each request)
asset_ticker Нет No	String Все активы All tickers	Тикер актива. BTC или BTC,ETH Asset ticker. BTC or BTC,ETH
type Нет No	String Все типы All types	Тип транзакции. onchain или offchain Transaction type. onchain or offchain
direction Нет No	String Все направления All directions	Направление транзакции. deposit или withdrawal Transaction direction. deposit or withdrawal
min_timestamp Нет No	Integer 1 1	Начальная метка времени в секундах. 1787798000 (от 1 до 9999999999) Start timestamp in seconds. 1787798000 (from 1 to 9999999999)
max_timestamp Нет No	Integer 9999999999 9999999999	Конечная метка времени. 1787799000 (от 1 до 9999999999) End timestamp. 1787799000 (from 1 to 9999999999)
limit Нет No	Integer 10 10	Количество транзакций. 25 (от 1 до 1000) Number of transactions. 25 (from 1 to 1000)

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
id	Integer	Идентификатор транзакции внутри биржи. Transaction identifier within the exchange.
type	String	Тип транзакции (onchain - на блокчейне, offchain - внутри биржи). Transaction type (onchain - on the blockchain, offchain - inside the exchange).
txid	String	Идентификатор транзакции в блокчейне. Transaction identifier in the blockchain.
asset_ticker	String	Тикер актива. Asset ticker.
chain_ticker	String	Тикер сети. Network ticker.
direction	String	Направление транзакции (deposit - пополнение баланса, withdrawal - вывод средств). Transaction direction (deposit – balance replenishment, withdrawal – funds withdrawal).
amount	String	Сумма транзакции. Transaction amount.
amount_usd	String	Сумма транзакции в USD. Transaction amount in the USD.
fee_asset_ticker	String	Тикер актива, в котором взимается комиссия биржи. Ticker of the asset for which the exchange fee is charged.
fee	String	Комиссия биржи. Exchange commission.
fee_usd	String	Комиссия биржи в USD. Exchange commission in the USD.
address	String	Адрес в блокчейне. Blockchain address.
sender_user_id	Integer	Идентификатор пользователя-отправителя. Sender user identifier.
receiver_user_id	Integer	Идентификатор пользователя-получателя. Recipient user identifier.
status	String	Статус транзакции (completed - транзакция выполнена, processing - в процессе выполнения). Transaction status (completed - the transaction is completed, processing - in the process of execution).
timestamp	Integer	Метка времени создания транзакции. Transaction creation timestamp.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "tonce", "asset_ticker", "type", "direction", "min_timestamp", "max_timestamp", "limit" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "id", "type", "txid", "asset_ticker", "chain_ticker", "direction", "amount", "amount_usd", "fee_asset_ticker", "fee", "fee_usd", "address", "sender_user_id", "receiver_user_id", "status", "timestamp" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter is invalid.", "allowed_format": "Integer \| UNIX timestamp in milliseconds" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter exceeds the server time." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The asset_ticker parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The asset_ticker parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,)." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The type parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The type parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "onchain", "offchain" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The direction parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The direction parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "deposit", "withdrawal" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_timestamp parameter is invalid.", "allowed_format": "Integer \| from 1 to 9999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The max_timestamp parameter is invalid.", "allowed_format": "Integer \| from 1 to 9999999999." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_timestamp parameter must not be greater than the max_timestamp parameter." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The limit parameter is invalid.", "allowed_format": "Integer \| from 1 to 1000." }
	401	Unauthorized	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-KEY header is invalid.", "allowed_format": "String \| 64 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The tonce parameter must be greater than the last accepted tonce." } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is invalid.", "allowed_format": "String \| 128 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is wrong." }
	403	Forbidden	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 403, "message": "Forbidden", "details": "The API key does not have permission to call this endpoint." } { "result": "error", "code": 403, "message": "Forbidden", "details": "The IP address is not allowed for this API key." }`
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the POST method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

POST

/transaction_history

Аутентификация Authentication

требуется required

Кэширование Caching

в реальном времени in real time

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request POST \
  --url https://qutrade.io/api/v2/transaction_history \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "API-KEY: MY_API_KEY_HEX" \
  --header "API-SIGN: MY_SIGNATURE_HEX" \
  --data tonce=1753180000000

$api_key_hex = 'MY_API_KEY_HEX';
$api_secret_hex = 'MY_API_SECRET_HEX';
$base_url = 'https://qutrade.io/api/v2';
$endpoint = '/transaction_history';
$parameter['tonce'] = (int) (microtime(true) * 1000);
ksort($parameter);
$parameters = http_build_query($parameter);
$signature_hex = bin2hex(sodium_crypto_sign_detached($endpoint.$parameters, hex2bin($api_secret_hex)));
$headers = [
  'API-KEY: ' . $api_key_hex,
  'API-SIGN: ' . $signature_hex
];
$ch = curl_init($base_url.$endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
echo $result = curl_exec($ch);
curl_close($ch);

const apiKeyHex = 'MY_API_KEY_HEX';
const apiSecretHex = 'MY_API_SECRET_HEX';
const baseUrl = 'https://qutrade.io/api/v2';
const endpoint = '/transaction_history';
const parameters = {
    tonce: Date.now()
};
const sortedParameters = Object.keys(parameters)
    .sort()
    .reduce((obj, key) => {
        obj[key] = parameters[key];
        return obj;
    }, {});
const queryString = new URLSearchParams(sortedParameters).toString();
const message = new TextEncoder().encode(endpoint + queryString);
const secretKey = hexToUint8Array(apiSecretHex);
const signature = nacl.sign.detached(message, secretKey);
const signatureHex = uint8ArrayToHex(signature);
fetch(baseUrl + endpoint, {
    method: 'POST',
    headers: {
        'API-KEY': apiKeyHex,
        'API-SIGN': signatureHex,
        'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: queryString
})
.then(response => response.json())
.then(console.log)
.catch(console.error);
function hexToUint8Array(hex) {
    return Uint8Array.from(hex.match(/.{2}/g).map(byte => parseInt(byte, 16)));
}
function uint8ArrayToHex(bytes) {
    return Array.from(bytes)
        .map(b => b.toString(16).padStart(2, '0'))
        .join('');
}
<script src="/js/nacl-fast.min.js"></script>

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": [
    {
      "id": 1327776,
      "type": "onchain",
      "txid": "0xd50ed487af6eb049e45dcef1ccbfc1bc33cfb7b4b4d050a5ba1d2159fe30b447",
      "asset_ticker": "USDT",
      "chain_ticker": "BEP20",
      "direction": "withdrawal",
      "amount": "200.5",
      "amount_usd": "200.5",
      "fee_asset_ticker": "USDT",
      "fee": "0.5",
      "fee_usd": "0.5",
      "address": "0x6afd9e3a94337a1a800b19b4905e162740a6afd7",
      "receiver_user_id": null,
      "sender_user_id": null,
      "status": "completed",
      "timestamp": 1787979125
    },
    ...
  ]
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Подключенные биржи Connected exchanges

Этот эндпоинт позволяет получить список бирж, подключенных к арбитражному сканеру. При успешном выполнении эндпоинт возвращает полный список бирж, включая общую информацию по ним. This endpoint allows you to retrieve the exchanges connected to the arbitrage scanner. Upon a successful request, the endpoint returns the complete list of exchanges, including general information about each exchange.

Параметры Parameters

	Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.		Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.		Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
	field Нет No		String Все поля All fields		Явный выбор полей успешного ответа. exchange_id или exchange_id,trade_fee Explicit selection of success response fields. exchange_id or exchange_id,trade_fee

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
exchange_id	Integer	Идентификатор биржи. Exchange identifier.
exchange_name	String	Название биржи. Exchange name.
kyc	Boolean	Верификация: false - не требуется, true - требуется. Verification: false - not required, true - required.
trade_fee	String	Максимальная торговая комиссия на споте. Maximum trading commission on spot.
tracked_markets	Integer	Количество отслеживаемых рынков. Number of markets monitored.
tracked_coins	Integer	Количество отслеживаемых монет. Number of coins monitored.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "exchange_id", "exchange_name", "kyc", "trade_fee", "tracked_markets", "tracked_coins" ] }
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the GET method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 300 seconds." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

GET

/connected_exchanges

Аутентификация Authentication

не требуется not required

Кэширование Caching

каждые 300 секунд every 300 seconds

Лимит Limit

1 запрос / 300 секунд 1 request / 300 seconds

Пример запроса Example request

BASH

PHP

curl --request GET \
  --url https://qutrade.io/api/v2/connected_exchanges

$base_url = 'https://qutrade.io/api/v2';
$method = '/connected_exchanges';
$ch = curl_init($base_url.$method);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

const options = {method: 'GET'};

fetch('https://qutrade.io/api/v2/connected_exchanges', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": [
    {
      "exchange_id": 1,
      "exchange_name": "Binance",
      "kyc": true,
      "trade_fee": "0.1",
      "tracked_markets": 878,
      "tracked_coins": 416
    },
    ...
  ]
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Доступные сделки Available deals

Этот эндпоинт позволяет получать доступные арбитражные сделки. При успешном выполнении запроса эндпоинт возвращает полный список доступных сделок, включая общую информацию по ним. This endpoint allows you to retrieve available arbitrage deals. Upon a successful request, the endpoint returns the complete list of available deals, including general information about each deal.

Обратите внимание, что данный эндпоинт возвращает только предварительную информацию о доступных сделках без необходимых деталей для дальнейшего проведения арбитража. Просмотр деталей является платным, оплата осуществляется через эндпоинт Оплата просмотра. При вызове эндпоинта Оплата просмотра требуется указать идентификатор нужной сделки из списка доступных сделок, предварительно полученного с помощью эндпоинта Доступные сделки, в котором также указаны цены и доступные варианты оплаты. Please note that this endpoint returns only preliminary information about available deals without the details required to perform arbitrage. Access to deal details is paid, and payment is made through the Show deal endpoint. When calling the Show deal endpoint, you must specify the identifier of the desired deal from the list of available deals previously obtained through the Available deals endpoint, which also includes pricing and available payment options.

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. deal_id или deal_id,profit_usd Explicit selection of success response fields. deal_id or deal_id,profit_usd
disabled_buy_exchanges Нет No	Integer Не используется Not used	Скрытые биржи для покупки. 1 или 1,2 Hidden exchanges for buying. 1 or 1,2
disabled_sell_exchanges Нет No	Integer Не используется Not used	Скрытые биржи для продажи. 1 или 1,2 Hidden exchanges for selling. 1 or 1,2
min_profit_usd Нет No	Decimal 0.1 0.1	Минимальная прибыль сделки в USD. 10 (от 0.1 до 1000000) Minimum deal profit in USD. 10 (from 0.1 to 1000000)
max_profit_usd Нет No	Decimal 1000000 1000000	Максимальная прибыль сделки в USD. 1000 (от 0.1 до 1000000) Maximum deal profit in USD. 1000 (from 0.1 to 1000000)
min_profit_percent Нет No	Decimal 0.1 0.1	Минимальная доходность сделки в %. 10 (от 0.1 до 1000000) Minimum deal profitability in %. 10 (from 0.1 to 1000000)
max_profit_percent Нет No	Decimal 1000000 1000000	Максимальная доходность сделки в %. 1000 (от 0.1 до 1000000) Maximum deal profitability in %. 1000 (from 0.1 to 1000000)
min_volume_usd Нет No	Decimal 0.1 0.1	Минимальный объем сделки. 10 (от 0.1 до 1000000) Minimum deal volume. 10 (from 0.1 to 1000000)
max_volume_usd Нет No	Decimal 1000000 1000000	Максимальный объем сделки. 1000 (от 0.1 до 1000000) Maximum transaction volume. 1000 (from 0.1 to 1000000)
min_lifetime_seconds Нет No	Integer 10 10	Минимальное время жизни в секундах. 300 (от 10 до 864000) Minimum lifetime in seconds. 300 (from 10 to 864000)
max_lifetime_seconds Нет No	Integer 864000 864000	Максимальное время жизни в секундах. 3600 (от 10 до 864000) Maximum lifetime in seconds. 3600 (from 10 to 864000)

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
deal_id	Integer	Идентификатор сделки. Deal identifier.
profit_usd	String	Прибыль сделки в USD. Deal profit in USD.
profit_percent	String	Доходность сделки в %. Deal profitability in %.
volume_usd	String	Объем сделки в USD. Deal volume in USD.
buy_exchange_name	String	Название биржи для покупки. Exchange name for buying.
sell_exchange_name	String	Название биржи для продажи. Exchange name for selling.
best_transfer_fee_usd	String	Лучшая комиссия за перевод в USD. Best transfer fee in USD.
lifetime_seconds	Integer	Время существования сделки в секундах. Deal lifetime in seconds.
best_pay_asset_ticker	String	Лучший тикер актива для оплаты показа сделки. Best asset ticker for deal payment.
best_pay_cost	String	Лучшая цена оплаты показа сделки. Best deal payment cost.
best_pay_cost_usd	String	Лучшая цена оплаты показа сделки в USD. Best deal payment cost in USD.
best_pay_discount_percent	Integer	Лучшая скидка на оплату показа сделки в %. Best deal payment discount in %.
payments.asset_ticker	String	Тикер актива для оплаты показа сделки. Asset ticker for deal payment.
payments.cost	String	Цена оплаты показа сделки. Deal payment cost.
payments.cost_usd	String	Цена оплаты показа сделки в USD. Deal payment cost in USD.
payments.discount_percent	Integer	Скидка на оплату показа сделки в %. Deal payment discount in %.
payments	Array	Варианты оплаты показа сделки. Deal payment options.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "disabled_buy_exchanges", "disabled_sell_exchanges", "min_profit_usd", "max_profit_usd", "min_profit_percent", "max_profit_percent", "min_volume_usd", "max_volume_usd", "min_lifetime_seconds", "max_lifetime_seconds" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "deal_id", "profit_usd", "profit_percent", "volume_usd", "buy_exchange_name", "sell_exchange_name", "best_transfer_fee_usd", "lifetime_seconds", "best_pay_asset_ticker", "best_pay_cost", "best_pay_cost_usd", "best_pay_discount_percent", "payments" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The disabled_buy_exchanges parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The disabled_buy_exchanges parameter is invalid.", "allowed_format": "Integer \| you can specify multiple values separated by commas (,).", "allowed_values": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, ...] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The disabled_sell_exchanges parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The disabled_sell_exchanges parameter is invalid.", "allowed_format": "Integer \| you can specify multiple values separated by commas (,).", "allowed_values": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, ...] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_profit_usd parameter is invalid.", "allowed_format": "Decimal \| from 0.1 to 1000000" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The max_profit_usd parameter is invalid.", "allowed_format": "Decimal \| from 0.1 to 1000000" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_profit_usd parameter must not be greater than the max_profit_usd parameter." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_profit_percent parameter is invalid.", "allowed_format": "Decimal \| from 0.1 to 1000000" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The max_profit_percent parameter is invalid.", "allowed_format": "Decimal \| from 0.1 to 1000000" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_profit_percent parameter must not be greater than the max_profit_percent parameter." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_volume_usd parameter is invalid.", "allowed_format": "Decimal \| from 0.1 to 1000000" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The max_volume_usd parameter is invalid.", "allowed_format": "Decimal \| from 0.1 to 1000000" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_volume_usd parameter must not be greater than the max_volume_usd parameter." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_lifetime_seconds parameter is invalid.", "allowed_format": "Integer \| from 10 to 864000" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The max_lifetime_seconds parameter is invalid.", "allowed_format": "Integer \| from 10 to 864000" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The min_lifetime_seconds parameter must not be greater than the max_lifetime_seconds parameter." }
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the GET method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 10 seconds." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

GET

/available_deals

Аутентификация Authentication

не требуется not required

Кэширование Caching

каждые 10 секунд every 10 seconds

Лимит Limit

1 запрос / 10 секунд 1 request / 10 seconds

Пример запроса Example request

BASH

PHP

curl --request GET \
  --url https://qutrade.io/api/v2/available_deals

$base_url = 'https://qutrade.io/api/v2';
$method = '/available_deals';
$ch = curl_init($base_url.$method);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

const options = {method: 'GET'};

fetch('https://qutrade.io/api/v2/available_deals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": [
    {
      "deal_id": 81609,
      "profit_usd": "15.97",
      "profit_percent": "0.542",
      "volume_usd": "2946",
      "buy_exchange_name": "Mexc",
      "sell_exchange_name": "Bybit",
      "best_transfer_fee_usd": "0.09",
      "lifetime_seconds": 479,
      "best_pay_asset_ticker": "LS",
      "best_pay_cost": "0.029",
      "best_pay_cost_usd": "0.014",
      "best_pay_discount_percent": 25,
      "payments": [
        {
          "cost": "0.029",
          "cost_usd": "0.014",
          "asset_ticker": "LS",
          "discount_percent": 25
        },
        {
          "cost": "1.3",
          "cost_usd": "0.019",
          "asset_ticker": "S11",
          "discount_percent": 0
        }
      ]
    },
    ...
  ]
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Оплата просмотра Show deal

Этот эндпоинт позволяет оплачивать просмотр деталей сделок. При успешном выполнении запроса эндпоинт возвращает все необходимые детали сделки для дальнейшего проведения арбитража. Эндпоинт также может возвращать детали сразу по нескольким сделкам, а именно по всем существующим сделкам с идентичной торговой парой на других биржах. This endpoint allows you to pay for access to deal details. Upon a successful request, the endpoint returns all the details required to perform arbitrage. The endpoint may also return details for multiple deals at once, specifically for all existing deals with the same trading pair on other exchanges.

Обратите внимание, что данный эндпоинт требует указания идентификатора сделки, который необходимо получить из списка доступных сделок, предварительно полученного с помощью эндпоинта Доступные сделки. Please note that this endpoint requires the deal identifier, which must be obtained from the list of available deals previously retrieved through the Available deals endpoint.

Заголовки Headers

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название заголовка и его обязательность. The «Name / Required» column displays the title of the heading and whether it is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип заголовка и его значение по умолчанию. The «Type / Default» column displays the header type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание заголовка и примеры указания заголовка. The «Description / Examples of specification» column displays the title description and examples of how to specify the title.
API-KEY Да Yes	String Нет No	Публичный API-ключ. HEX 64 символа Public API key. HEX 64 characters
API-SIGN Да Yes	String Нет No	Цифровая подпись запроса. HEX 128 символов Digital signature of the request. HEX 128 characters

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. deal_id или deal_id,profit_usd Explicit selection of success response fields. deal_id or deal_id,profit_usd
tonce Да Yes	Integer Нет No	Метка времени UNIX в миллисекундах. 1489617308123 (должна быть уникальной для каждого запроса) UNIX timestamp in milliseconds. 1489617308123 (must be unique for each request)
deal_id Да Yes	Integer Нет No	Идентификатор сделки. 81609 Deal identifier. 81609
asset_ticker Да Yes	String Нет No	Тикер актива оплаты показа деталей сделки. S11 Asset ticker used to pay for viewing deal details. S11

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
deal_id	Integer	Идентификатор сделки. Deal identifier.
profit_usd	String	Прибыль сделки в USD. Deal profit in USD.
profit_percent	String	Доходность сделки в %. Deal profitability in %.
volume	String	Объем в базовом активе. Volume in the base asset.
volume_usd	String	Объем сделки в USD. Deal volume in USD.
buy_exchange_name	String	Название биржи для покупки. Exchange name for buying.
buy_exchange_pair	String	Торговая пара на бирже для покупки. Trading pair on the exchange for buying.
buy_exchange_ask	String	Цена покупки на бирже для покупки. Buying price on the exchange for buying.
sell_exchange_name	String	Название биржи для продажи. Exchange name for selling.
sell_exchange_pair	String	Торговая пара на бирже для продажи. Trading pair on the exchange for selling.
sell_exchange_bid	String	Цена продажи на бирже для продажи. Selling price on the exchange for selling.
best_transfer_fee	String	Лучшая комиссия за перевод. Best transfer fee.
best_transfer_fee_usd	String	Лучшая комиссия за перевод в USD. Best transfer fee in USD.
best_transfer_chain_ticker	String	Лучшая сеть перевода. Best transfer chain.
best_transfer_time_seconds	Integer	Лучшее время перевода в секундах. Best transfer time in seconds.
transfers	Array	Варианты перевода. Transfer options.
lifetime_seconds	Integer	Время существования сделки в секундах. Deal lifetime in seconds.
lifetime_count	Integer	Количество существований сделки. Deal existence count.
average_lifetime_seconds	Integer	Среднее время существования сделки в секундах. Average deal lifetime in seconds.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "tonce", "deal_id", "asset_ticker" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "deal_id", "profit_usd", "profit_percent", "volume", "volume_usd", "buy_exchange_name", "buy_exchange_pair", "buy_exchange_ask", "sell_exchange_name", "sell_exchange_pair", "sell_exchange_bid", "best_transfer_fee", "best_transfer_fee_usd", "best_transfer_chain_ticker", "best_transfer_time_seconds", "transfers", "lifetime_seconds", "lifetime_count", "average_lifetime_seconds" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter is invalid.", "allowed_format": "Integer \| UNIX timestamp in milliseconds" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter exceeds the server time." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The deal_id parameter is invalid.", "allowed_format": "Integer" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The asset_ticker parameter is invalid.", "allowed_format": "String" }
	401	Unauthorized	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-KEY header is invalid.", "allowed_format": "String \| 64 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The tonce parameter must be greater than the last accepted tonce." } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is invalid.", "allowed_format": "String \| 128 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is wrong." }
	402	Payment Required	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 402, "message": "Payment Required", "details": "Insufficient funds for payment of deal details review." }`
	403	Forbidden	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 403, "message": "Forbidden", "details": "The API key does not have permission to call this endpoint." } { "result": "error", "code": 403, "message": "Forbidden", "details": "The IP address is not allowed for this API key." }`
	404	Not Found	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 404, "message": "Not Found", "details": "The deal with the identifier specified in the deal_id parameter was not found." }`
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the POST method for this endpoint." }`
	409	Conflict	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 409, "message": "Conflict", "details": "The deal with the identifier specified in the deal_id parameter is already paid." }`
	410	Gone	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 410, "message": "Gone", "details": "The deal with the identifier specified in the deal_id parameter is not available." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

POST

/show_deal

Аутентификация Authentication

требуется required

Кэширование Caching

каждые 10 секунд every 10 seconds

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request POST \
  --url https://qutrade.io/api/v2/show_deal \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "API-KEY: MY_API_KEY_HEX" \
  --header "API-SIGN: MY_SIGNATURE_HEX" \
  --data asset_ticker=S11 \
  --data deal_id=9 \
  --data tonce=1753180000000

$api_key_hex = 'MY_API_KEY_HEX';
$api_secret_hex = 'MY_API_SECRET_HEX';
$base_url = 'https://qutrade.io/api/v2';
$endpoint = '/show_deal';
$parameter['deal_id'] = 9;
$parameter['asset_ticker'] = 'S11';
$parameter['tonce'] = (int) (microtime(true) * 1000);
ksort($parameter);
$parameters = http_build_query($parameter);
$signature_hex = bin2hex(sodium_crypto_sign_detached($endpoint.$parameters, hex2bin($api_secret_hex)));
$headers = [
  'API-KEY: ' . $api_key_hex,
  'API-SIGN: ' . $signature_hex
];
$ch = curl_init($base_url.$endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
echo $result = curl_exec($ch);
curl_close($ch);

const apiKeyHex = 'MY_API_KEY_HEX';
const apiSecretHex = 'MY_API_SECRET_HEX';
const baseUrl = 'https://qutrade.io/api/v2';
const endpoint = '/show_deal';
const parameters = {
    deal_id: 9,
    asset_ticker: 'S11',
    tonce: Date.now()
};
const sortedParameters = Object.keys(parameters)
    .sort()
    .reduce((obj, key) => {
        obj[key] = parameters[key];
        return obj;
    }, {});
const queryString = new URLSearchParams(sortedParameters).toString();
const message = new TextEncoder().encode(endpoint + queryString);
const secretKey = hexToUint8Array(apiSecretHex);
const signature = nacl.sign.detached(message, secretKey);
const signatureHex = uint8ArrayToHex(signature);
fetch(baseUrl + endpoint, {
    method: 'POST',
    headers: {
        'API-KEY': apiKeyHex,
        'API-SIGN': signatureHex,
        'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: queryString
})
.then(response => response.json())
.then(console.log)
.catch(console.error);
function hexToUint8Array(hex) {
    return Uint8Array.from(hex.match(/.{2}/g).map(byte => parseInt(byte, 16)));
}
function uint8ArrayToHex(bytes) {
    return Array.from(bytes)
        .map(b => b.toString(16).padStart(2, '0'))
        .join('');
}
<script src="/js/nacl-fast.min.js"></script>

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": [
    {
      "deal_id": 6190,
      "profit_usd": "0.58",
      "profit_percent": "0.661",
      "volume": "17696.6",
      "volume_usd": "87.15",
      "buy_exchange_name": "KuCoin",
      "buy_exchange_pair": "PUBLIC/USDT",
      "buy_exchange_ask": "0.00495",
      "sell_exchange_name": "Mexc",
      "sell_exchange_pair": "PUBLIC/USDT",
      "sell_exchange_bid": "0.004935",
      "best_transfer_fee": "90",
      "best_transfer_fee_usd": "0.44",
      "best_transfer_chain_ticker": "NEAR",
      "best_transfer_time_seconds": 60,
      "transfers": [
        {
          "fee": "90",
          "fee_usd": "0.44",
          "chain_ticker": "NEAR",
          "time_seconds": 60
        }
      ],
      "lifetime_seconds": 414,
      "lifetime_count": 7,
      "average_lifetime_seconds": 400
    },
    ...
  ]
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Оплаченные сделки Paid deals

Этот эндпоинт позволяет получать доступные сделки с оплаченным просмотром деталей. При успешном выполнении запроса эндпоинт возвращает все доступные сделки с необходимыми деталями для дальнейшего проведения арбитража, просмотр которых был оплачен через эндпоинт Оплата просмотра. This endpoint allows you to retrieve available deals with paid access to their details. Upon a successful request, the endpoint returns all available deals with the details required to perform arbitrage, for which access has been paid through the Show deal endpoint.

Заголовки Headers

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название заголовка и его обязательность. The «Name / Required» column displays the title of the heading and whether it is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип заголовка и его значение по умолчанию. The «Type / Default» column displays the header type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание заголовка и примеры указания заголовка. The «Description / Examples of specification» column displays the title description and examples of how to specify the title.
API-KEY Да Yes	String Нет No	Публичный API-ключ. HEX 64 символа Public API key. HEX 64 characters
API-SIGN Да Yes	String Нет No	Цифровая подпись запроса. HEX 128 символов Digital signature of the request. HEX 128 characters

Параметры Parameters

Название Обязательный Name Required ? Столбец «Название / Обязательный» отображает название параметра и является ли параметр обязательным. The «Name / Required» column displays the parameter name and indicates whether the parameter is required.	Тип По умолчанию Type Default ? Столбец «Тип / По умолчанию» отображает тип параметра и значение параметра по умолчанию. The "Type / Default" column displays the parameter data type and its default value.	Описание Примеры указания Description Examples of specification ? Столбец «Описание / Примеры указания» отображает описание параметра и примеры указания параметра. The «Description / Examples of specification» column provides a description of the parameter and examples of how to specify it.
field Нет No	String Все поля All fields	Явный выбор полей успешного ответа. deal_id или deal_id,profit_usd Explicit selection of success response fields. deal_id or deal_id,profit_usd
tonce Да Yes	Integer Нет No	Метка времени UNIX в миллисекундах. 1489617308123 (должна быть уникальной для каждого запроса) UNIX timestamp in milliseconds. 1489617308123 (must be unique for each request)
deal_id Нет No	Integer Все сделки All deals	Идентификатор сделки. 1 или 1,2 Deal identifier. 1 or 1,2

Поля полезной нагрузки Payload fields

Название Name ? Столбец «Название» отображает название возвращаемого поля при успешном ответе. The «Name» column displays the name of the field returned in a successful response.	Тип Type ? Столбец «Тип» отображает тип возвращаемого поля при успешном ответе. The «Type» column displays the data type of the returned field.	Описание Description ? Столбец «Описание» отображает описание возвращаемого поля. The «Description» column provides a description of the returned field.
deal_id	Integer	Идентификатор сделки. Deal identifier.
profit_usd	String	Прибыль сделки в USD. Deal profit in USD.
profit_percent	String	Доходность сделки в %. Deal profitability in %.
volume	String	Объем в базовом активе. Volume in the base asset.
volume_usd	String	Объем сделки в USD. Deal volume in USD.
buy_exchange_name	String	Название биржи для покупки. Exchange name for buying.
buy_exchange_pair	String	Торговая пара на бирже для покупки. Trading pair on the exchange for buying.
buy_exchange_ask	String	Цена покупки на бирже для покупки. Buying price on the exchange for buying.
sell_exchange_name	String	Название биржи для продажи. Exchange name for selling.
sell_exchange_pair	String	Торговая пара на бирже для продажи. Trading pair on the exchange for selling.
sell_exchange_bid	String	Цена продажи на бирже для продажи. Selling price on the exchange for selling.
best_transfer_fee	String	Лучшая комиссия за перевод. Best transfer fee.
best_transfer_fee_usd	String	Лучшая комиссия за перевод в USD. Best transfer fee in USD.
best_transfer_chain_ticker	String	Лучшая сеть перевода. Best transfer chain.
best_transfer_time_seconds	Integer	Лучшее время перевода в секундах. Best transfer time in seconds.
transfers	Array	Варианты перевода. Transfer options.
lifetime_seconds	Integer	Время существования сделки в секундах. Deal lifetime in seconds.
lifetime_count	Integer	Количество существований сделки. Deal existence count.
average_lifetime_seconds	Integer	Среднее время существования сделки в секундах. Average deal lifetime in seconds.

Коды ошибок Error codes

	Код Code ? Столбец «Код» отображает HTTP-код ответа. The «Code» column displays the HTTP response status code.	Описание Description ? Столбец «Описание» отображает описание HTTP-кода ответа. The «Description» column provides a description of the HTTP response status code.	Детали Details ? Столбец «Детали» отображает наличие деталей об ошибке в ответе. The «Details» column indicates whether the response includes additional error details.	Пример ответа Example response ? Столбец «Пример ответа» отображает примеры JSON ответов. The «Example response» column provides example JSON responses.
	400	Bad Request	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 400, "message": "Bad Request", "details": "The UNRESOLVED_PARAMETER parameter does not exist.", "allowed_parameters": [ "field", "tonce", "deal_id" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter must not contain duplicate values." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The field parameter is invalid.", "allowed_format": "String \| you can specify multiple values separated by commas (,).", "allowed_values": [ "deal_id", "profit_usd", "profit_percent", "trade_amount", "trade_usd", "buy_exchange_name", "buy_exchange_pair", "buy_exchange_ask", "sell_exchange_name", "sell_exchange_pair", "sell_exchange_bid", "best_transfer_fee", "best_transfer_fee_usd", "best_transfer_chain_ticker", "best_transfer_time_seconds", "transfers", "lifetime_seconds", "lifetime_count", "average_lifetime_seconds" ] } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter is invalid.", "allowed_format": "Integer \| UNIX timestamp in milliseconds" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The tonce parameter exceeds the server time." } { "result": "error", "code": 400, "message": "Bad Request", "details": "The deal_id parameter is invalid.", "allowed_format": "Integer" } { "result": "error", "code": 400, "message": "Bad Request", "details": "The deal_id parameter must not contain duplicate values." }
	401	Unauthorized	Есть Yes	Показать Show Скрыть Hide
{ "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-KEY header is invalid.", "allowed_format": "String \| 64 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The tonce parameter must be greater than the last accepted tonce." } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is invalid.", "allowed_format": "String \| 128 characters" } { "result": "error", "code": 401, "message": "Unauthorized", "details": "The API-SIGN header is wrong." }
	403	Forbidden	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 403, "message": "Forbidden", "details": "The API key does not have permission to call this endpoint." } { "result": "error", "code": 403, "message": "Forbidden", "details": "The IP address is not allowed for this API key." }`
	405	Method Not Allowed	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 405, "message": "Method Not Allowed", "details": "Use only the POST method for this endpoint." }`
	429	Too Many Requests	Есть Yes	Показать Show Скрыть Hide
`{ "result": "error", "code": 429, "message": "Too Many Requests", "details": "The limit for this endpoint is 1 request / 1 second." }`
	500	Internal Server Error	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 500, "message": "Internal Server Error" }`
	503	Service Unavailable	Нет No	Показать Show Скрыть Hide
`{ "result": "error", "code": 503, "message": "Service Unavailable" }`

Эндпоинт Endpoint

POST

/paid_deals

Аутентификация Authentication

требуется required

Кэширование Caching

каждые 10 секунд every 10 seconds

Лимит Limit

1 запрос / 1 секунда 1 request / 1 second

Пример запроса Example request

BASH

PHP

curl --request POST \
  --url https://qutrade.io/api/v2/paid_deals \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "API-KEY: MY_API_KEY_HEX" \
  --header "API-SIGN: MY_SIGNATURE_HEX" \
  --data tonce=1753180000000

$api_key_hex = 'MY_API_KEY_HEX';
$api_secret_hex = 'MY_API_SECRET_HEX';
$base_url = 'https://qutrade.io/api/v2';
$endpoint = '/paid_deals';
$parameter['tonce'] = (int) (microtime(true) * 1000);
ksort($parameter);
$parameters = http_build_query($parameter);
$signature_hex = bin2hex(sodium_crypto_sign_detached($endpoint.$parameters, hex2bin($api_secret_hex)));
$headers = [
  'API-KEY: ' . $api_key_hex,
  'API-SIGN: ' . $signature_hex
];
$ch = curl_init($base_url.$endpoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
echo $result = curl_exec($ch);
curl_close($ch);

const apiKeyHex = 'MY_API_KEY_HEX';
const apiSecretHex = 'MY_API_SECRET_HEX';
const baseUrl = 'https://qutrade.io/api/v2';
const endpoint = '/paid_deals';
const parameters = {
    tonce: Date.now()
};
const sortedParameters = Object.keys(parameters)
    .sort()
    .reduce((obj, key) => {
        obj[key] = parameters[key];
        return obj;
    }, {});
const queryString = new URLSearchParams(sortedParameters).toString();
const message = new TextEncoder().encode(endpoint + queryString);
const secretKey = hexToUint8Array(apiSecretHex);
const signature = nacl.sign.detached(message, secretKey);
const signatureHex = uint8ArrayToHex(signature);
fetch(baseUrl + endpoint, {
    method: 'POST',
    headers: {
        'API-KEY': apiKeyHex,
        'API-SIGN': signatureHex,
        'Content-Type': 'application/x-www-form-urlencoded'
    },
    body: queryString
})
.then(response => response.json())
.then(console.log)
.catch(console.error);
function hexToUint8Array(hex) {
    return Uint8Array.from(hex.match(/.{2}/g).map(byte => parseInt(byte, 16)));
}
function uint8ArrayToHex(bytes) {
    return Array.from(bytes)
        .map(b => b.toString(16).padStart(2, '0'))
        .join('');
}
<script src="/js/nacl-fast.min.js"></script>

Пример ответа Example response

200 OK

{
  "result": "success",
  "payload": [
    {
      "deal_id": 6190,
      "profit_usd": "0.58",
      "profit_percent": "0.661",
      "volume": "17696.6",
      "volume_usd": "87.15",
      "buy_exchange_name": "KuCoin",
      "buy_exchange_pair": "PUBLIC/USDT",
      "buy_exchange_ask": "0.00495",
      "sell_exchange_name": "Mexc",
      "sell_exchange_pair": "PUBLIC/USDT",
      "sell_exchange_bid": "0.004935",
      "best_transfer_fee": "90",
      "best_transfer_fee_usd": "0.44",
      "best_transfer_chain_ticker": "NEAR",
      "best_transfer_time_seconds": 60,
      "transfers": [
        {
          "fee": "90",
          "fee_usd": "0.44",
          "chain_ticker": "NEAR",
          "time_seconds": 60
        }
      ],
      "lifetime_seconds": 414,
      "lifetime_count": 7,
      "average_lifetime_seconds": 500
    },
    ...
  ]
}

429 Too many requests

{
  "result": "error",
  "message": "Too many requests",
  "code": 429
}

СОВЕТ

Используйте параметр field для получения только нужных полей из ответов. Это ускорит ответы и снизит трафик.

ADVICE

Use the field parameter to retrieve only the required fields in responses. This speeds up response times and reduces data traffic.

Лимиты Limits

Для каждого эндпоинта установлены индивидуальные лимиты на частоту запросов. В большинстве случаев вызывать эндпоинты чаще установленного лимита не имеет смысла, так как время кэширования данных равно или превышает значение лимита. Individual rate limits are defined for each endpoint. In most cases, sending requests more frequently than the specified rate limit provides no benefit, as the data cache duration is equal to or longer than the rate limit interval.

Превышение лимитов Rate limit exceeded

При превышении лимита API будет возвращать ошибку 429 Too Many Requests. Систематическое или многократное превышение лимитов может привести к временной блокировке доступа к API. If the rate limit is exceeded, the API returns a 429 Too Many Requests error. Repeated or systematic rate limit violations may result in a temporary suspension of API access.

Лимиты и кэширование эндпоинтов Limits and endpoint caching

Эндпоинт Endpoint ? Столбец «Эндпоинт» отображает название эндпоинта. The «Endpoint» column displays the name of the endpoint.	Лимит Limit ? Столбец «Лимит» отображает максимальную частоту вызовов эндпоинта. The «Limit» column displays the maximum frequency of endpoint calls.	Кэширование Caching ? Столбец «Кэширование» отображает частоту кэширования возвращаемых данных эндпоинта. The «Caching» column displays how often the endpoint's returned data is cached.
/cryptocurrencies	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/spot_markets	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/liquidity_pools	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/depth	10 запросов / 1 секунда / 1 IP 10 requests / 1 second / 1 IP	В реальном времени In real time
/trading_history	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/candles_history	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/create_order	10 запросов / 1 секунда / 1 IP 10 requests / 1 second / 1 IP	В реальном времени In real time
/cancel_orders	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/cancel_all_orders	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/open_orders	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/pending_orders	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/order_history	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/trades_history	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/balances	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/deposit_addresses	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/transaction_history	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	В реальном времени In real time
/connected_exchanges	1 запрос / 300 секунд / 1 IP 1 request / 300 seconds / 1 IP	Каждые 300 секунд Every 300 seconds
/available_deals	1 запрос / 10 секунд / 1 IP 1 request / 10 seconds / 1 IP	Каждые 10 секунд Every 10 seconds
/show_deal	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	Каждые 10 секунд Every 10 seconds
/paid_deals	1 запрос / 1 секунда / 1 IP 1 request / 1 second / 1 IP	Каждые 10 секунд Every 10 seconds

Коды ошибок Error codes

Коды ошибок позволяют быстро определить тип ошибки. Ниже в таблице приведены все возможные возвращаемые HTTP-коды ошибок по всем эндпоинтам. Error codes allow you to quickly identify the type of error. The table below lists all possible HTTP error codes returned for all endpoints.

Коды ошибок Error codes

400 Bad Request

401 Unauthorized

402 Payment Required

403 Forbidden

404 Not Found

405 Method Not Allowed

409 Conflict

410 Gone

429 Too Many Requests

500 Internal Server Error

503 Service Unavailable

Коды ошибок эндпоинтов Endpoint error codes

Раздел Section ? Столбец «Раздел» отображает раздел эндпоинта. The «Section» column displays the endpoint section.	Эндпоинт Endpoint ? Столбец «Эндпоинт» отображает эндпоинт. The «Endpoint» column displays the endpoint.	Коды Codes ? Столбец «Коды» отображает HTTP-коды ответа. The «Codes» column displays the HTTP response status codes.
REST Public Exchange	/cryptocurrencies	400 405 429 500 503
REST Public Exchange	/spot_markets	400 405 429 500 503
REST Public Exchange	/depth	400 405 429 500 503
REST Public Exchange	/trading_history	400 405 429 500 503
REST Public Exchange	/candles_history	400 405 429 500 503
REST Public Pools	/liquidity_pools	400 405 429 500 503
REST Public Scanner	/connected_exchanges	400 405 429 500 503
REST Public Scanner	/available_deals	400 405 429 500 503
REST Private Exchange	/create_order	400 401 403 405 429 500 503
REST Private Exchange	/cancel_orders	400 401 403 405 429 500 503
REST Private Exchange	/cancel_all_orders	400 401 403 405 429 500 503
REST Private Exchange	/open_orders	400 401 403 405 429 500 503
REST Private Exchange	/pending_orders	400 401 403 405 429 500 503
REST Private Exchange	/order_history	400 401 403 405 429 500 503
REST Private Exchange	/trades_history	400 401 403 405 429 500 503
REST Private Account	/balances	400 401 403 405 429 500 503
REST Private Account	/deposit_addresses	400 401 403 405 429 500 503
REST Private Account	/transaction_history	400 401 403 405 429 500 503
REST Private Scanner	/show_deal	400 401 402 403 404 405 409 410 429 500 503
REST Private Scanner	/paid_deals	400 401 403 405 429 500 503

Запросить эндпоинт/поле Request an endpoint/field

Нужно добавить новый эндпоинт или дополнительное поле в уже существующем эндпоинте? Создайте Тикет с подробным описанием того, что именно вам нужно, и обоснованием того, для чего именно это необходимо. Мы рассмотрим запрос в обязательном порядке и в кратчайшие сроки, после чего дадим ответ в созданном тикете о принятом решении. Need a new endpoint or an additional field in an existing endpoint?
Create a Ticket describing exactly what you need and why it is required. We will review your request as soon as possible and provide our decision in the ticket.

Сообщить об ошибке Report an error

Обнаружили в документации API или в работе API баги, несоответствия, опечатки? Создайте Тикет с описанием найденных проблем. Мы обязательно все тщательно проверим и постараемся устранить проблему как можно скорее. Have you found any bugs, inconsistencies, or typos in the API documentation or the API's operation? Create a Ticket describing the issue you found. We will thoroughly investigate your report and do our best to resolve the issue as quickly as possible.

Получить помощь Get help

Возникли вопросы по работе с API? Обращайтесь за помощью через Тикет или в официальный телеграм чат разработчиков Qutrade API. Need help with the API? Contact us by creating a Ticket or through the official Qutrade API developers telegram chat.