Как создать бизнес-ордер (руководство по интерфейсу и API)

Бизнес-ордеры от NiceHash предназначены для профессиональных покупателей хэшрейта, которым требуется стабильная и предсказуемая поставка хэшрейта, а также больший уровень контроля по сравнению со стандартными ордерами рынка хэшрейта. Для создания бизнес-ордера требуется верифицированная организация (KYB).

Существует два типа бизнес-ордеров:

Фиксированная скорость: Постоянная скорость; время завершения изменяется в зависимости от цены индекса хэшрейта и доступных средств.
Фиксированная длительность: Обратная логика; скорость подстраивается под фиксированную дату окончания и зависит от цены индекса хэшрейта и доступных средств.

ВАЖНО: Изменения применяются каждые 15 минут.

Что собой представляет бизнес-ордер?

Бизнес-ордер — это управляемый пакет хэшрейта, сформированный из доступных продавцов на рынке хэшрейта NiceHash. Он позволяет приобретать хэшрейт со следующими возможностями:

Приоритетная фиксированная скорость (стабильный хэшрейт).
Несколько алгоритмов (SHA256AsicBoost, Scrypt и KHeavyHash).
Выбор рынка (ЕС / США).
Майнинг напрямую на ваш собственный пул.
Повышенная предсказуемость для планирования и операций.

Перед началом

Для создания бизнес-ордера убедитесь, что у вас есть:

Настроенный на NiceHash пул для майнинга (понадобится poolId).
Выбран правильный алгоритм (например, SHA256AsicBoost).
Выбран целевой рынок (ЕС или США).
Проверены текущие ограничения алгоритма через API (рекомендуется).

Важно: проверка ограничений алгоритма через API

Настройки алгоритмов (ограничения, коэффициенты, доступные рынки) можно получить через официальную конечную точку API:

GET /main/api/v2/mining/algorithms

Используйте эту конечную точку API, чтобы проверить:

minimalOrderAmount (минимальная сумма в BTC).
minSpeedLimit и maxSpeedLimit (допустимый диапазон скорости).
displayMarketFactor и marketFactor (необходимые единицы измерения и масштабирование).

Документация (описание параметров): MINING ALGORITHMS – GET /main/api/v2/mining/algorithms.

Вариант 1: создание бизнес-ордера через интерфейс (UI)

Используйте интерфейс NiceHash, если вы предпочитаете пошаговую ручную настройку.

Войдите на NiceHash.
Перейдите на Рынок хэшрейта → Бизнес-ордеры.
Выберите рынок (ЕС / США).
Выберите алгоритм (например, SHA256AsicBoost).
Выберите или добавьте ваш пул для майнинга.
Выберите тип бизнес-ордера.
Для фиксированной скорости укажите сумму и ограничение скорости. Для фиксированной длительности укажите сумму, нижнее ограничение скорости и дату окончания.
Проверьте данные и подтвердите ордер.

Business orders UI

Вариант 2: создание бизнес-ордера с фиксированной скоростью через API

Метод через API рекомендуется, если вам необходимо:

Явно указать тип с фиксированной скоростью (подтип).
Точная настройка скорости (включая дробные значения выше минимума).
Автоматизация, повторные попытки, масштабирование и интеграция с внутренними инструментами.

Примеры реализации и HMAC-подписи доступны здесь: NiceHash REST Clients Demo (GitHub).

Запросы API, используемые в типичном процессе бизнес-ордера

Эти конечные точки API обычно используются при программном создании бизнес-ордеров:

Чтение ограничений и коэффициентов алгоритмов: GET /main/api/v2/mining/algorithms
Список пулов: GET /main/api/v2/pool
Создание пула (при необходимости): POST /main/api/v2/pool
Создание бизнес-ордера: POST /main/api/v2/hashpower/business/order
Мониторинг статуса ордера: GET /main/api/v2/hashpower/order/<orderId>

Основы фиксированной скорости (пример SHA256AsicBoost)

Для SHA256ASICBOOST бизнес-ордеры используют EH в качестве единицы скорости.

Правило минимальной скорости: значение limit должно быть больше или равно минимальному значению алгоритма (minSpeedLimit / вычисленному minLimit). Это ограничение минимальной скорости, а не ограничение на количество знаков после запятой.

Примеры (значения в EH):

0.0001 (пример минимального порога).
0.00011 (допустимо, выше минимума).
0.0001234 (допустимо, больше десятичных знаков).

Пример A: небольшой бизнес-ордер с фиксированной скоростью (эквивалент 1 PH)

Этот пример демонстрирует небольшую и точную фиксированную скорость с использованием дробных значений (значения скорости указаны в EH).

{
  "market": "EU",
  "algorithm": "SHA256ASICBOOST",
  "amount": 1,
  "displayMarketFactor": "EH",
  "marketFactor": 1000000000000000000,
  "limit": 0.0001,
  "displayPriceFactor": "EH",
  "priceFactor": 1000000000000000000,
  "poolId": "your_pool_id",
  "subType": "BUSINESS_FIXED_SPEED"
}

Пример B: бизнес-ордер с фиксированной скоростью (25 PH на 30 дней)

Для цели 25 PH на SHA256AsicBoost выполните перевод в EH:

1 PH = 0.001 EH
25 PH = 0.025 EH

Используйте диапазон скорости, включающий вашу цель. Например:

bottomLimit = 0.02 (20 PH)
limit = 0.03 (30 PH)

{
  "market": "EU",
  "algorithm": "SHA256ASICBOOST",
  "amount": 0.05,
  "displayMarketFactor": "EH",
  "marketFactor": 1000000000000000000,
  "displayPriceFactor": "EH",
  "priceFactor": 1000000000000000000,
  "poolId": "4007f83c-0b2d-49bc-b51c-584d27215f28",
  "bottomLimit": 0.02,
  "limit": 0.03,
  "subType": "BUSINESS_FIXED_SPEED"
}

Примечание: Если бэкенд не может выделить полный пакет в данный момент, вы можете получить ошибку распределения. В этом случае попробуйте позже, немного расширьте диапазон скорости, смените рынок (ЕС / США) или разделите ордер на несколько меньших.

Устранение распространённых ошибок

5068 – Invalid order market factor: неверная единица или коэффициент (должны соответствовать данным из /mining/algorithms).
2997 – Invalid order amount or limit or price: слишком малая сумма, неверный диапазон скорости или лимит ниже минимального.
5191 – Unable to allocate hashrate: запрос корректен, но недостаточно доступного хэшрейта; попробуйте повторить или разделить ордер.

Дополнительные ресурсы

Итог

Вы можете создавать бизнес-ордеры как через интерфейс NiceHash, так и через API. Подход с использованием API рекомендуется профессиональным покупателям, которым необходима автоматизация и больший контроль.

Всегда проверяйте ограничения алгоритмов с помощью GET /main/api/v2/mining/algorithms, а затем формируйте запрос соответствующим образом.