Comment créer un ordre Business (guide UI et API)

Les Business Orders de NiceHash sont conçus pour les acheteurs professionnels de hashrate qui ont besoin d’une livraison de hashrate stable et prévisible ainsi que de plus de contrôle que les ordres standard du marketplace. Pour créer un Business Order, une organisation vérifiée (KYB) est requise.

Il existe deux types de Business Orders :

Fixed Speed : Vitesse constante ; la durée de complétion fluctue en fonction du prix de l’index de hashrate et des fonds disponibles.
Fixed Duration :Logique inversée ; la vitesse s’adapte à une date de fin fixe, influencée par le prix de l’index de hashrate et les fonds disponibles.

IMPORTANT : Les changements sont effectués toutes les 15 minutes

Qu’est-ce qu’un Business Order ?

Un Business Order est un package de hashrate géré, assemblé à partir des vendeurs disponibles sur le marketplace NiceHash. Il vous permet d’acheter du hashrate avec :

Livraison prioritaire à vitesse fixe (hashrate stable)
Plusieurs algorithmes (SHA256AsicBoost, Scrypt et KHeavyHash)
Une sélection du marché (UE / USA)
Un minage directement vers votre propre pool
Une meilleure prévisibilité pour la planification et les opérations

Avant de commencer

Pour créer un Business Order, assurez-vous d’avoir :

Un pool de minage configuré dans NiceHash (vous aurez besoin du poolId)
Sélectionné le bon algorithme (par exemple SHA256AsicBoost)
Choisi le marché cible (UE ou USA)
Vérifié les limites actuelles de l’algorithme via l’API (recommandé)

Important : vérifier les limites de l’algorithme via l’API

Les paramètres de l’algorithme (limites, facteurs, marchés activés) peuvent être récupérés via le endpoint officiel :

GET /main/api/v2/mining/algorithms

Utilisez ce endpoint pour vérifier :

minimalOrderAmount (montant minimum en BTC)
minSpeedLimit et maxSpeedLimit (valid speed range)
displayMarketFactor et marketFactor (unités requises et mise à l’échelle)

Documentation (détails des paramètres) : MINING ALGORITHMS – GET /main/api/v2/mining/algorithms.

Option 1 : créer un Business Order via l’interface (UI)

Utilisez l’interface NiceHash si vous souhaitez une configuration guidée et manuelle.

Connectez-vous à NiceHash.
Accédez à Hashrate Marketplace → Business Orders.
Sélectionnez votre marché (UE / USA).
Choisissez l’algorithme (par exemple SHA256AsicBoost).
Sélectionnez ou ajoutez votre pool de minage.
Sélectionnez le type de Business Order
Pour un fixed speed, définissez le montant et la limite de vitesse. Pour une durée déterminée, définissez le montant, la limite basse de vitesse et la date de fin.
Vérifiez et confirmez l’ordre.

Business orders UI

Option 2 : Créer un ordre Business à vitesse fixe via l'API

La méthode API est recommandée si vous souhaitez :

Sélection explicite de la vitesse fixe (subType)
Une configuration précise de la vitesse (y compris une précision décimale au-delà du minimum)
L’automatisation, les tentatives multiples, la mise à l’échelle et l’intégration dans des outils internes

Une implémentation de référence et des exemples de signature HMAC sont disponibles ici : NiceHash REST Clients Demo (GitHub).

API Calls utilisés dans un flux typique de Business Order

Ces endpoints sont couramment utilisés lors de la création de Business Orders par programmation :

Lire les limites et facteurs des algorithmes : GET /main/api/v2/mining/algorithms
Lister les pools : GET /main/api/v2/pool
Créer un pool (si nécessaire) : POST /main/api/v2/pool
Créer un Business Order : POST /main/api/v2/hashpower/business/order
Surveiller le statut de l’ordre : GET /main/api/v2/hashpower/order/<orderId>

Bases du Fixed Speed (exemple SHA256AsicBoost)

Pour SHA256ASICBOOST, les Business Orders utilisent EH comme unité de vitesse.

Règle de vitesse minimale : votre limit doit être supérieure ou égale au minimum de l’algorithme (minSpeedLimit / minLimit dérivé). Il s’agit d’une contrainte de vitesse minimale, et non d’une limitation de précision décimale.

Exemples (valeurs en EH) :

0.0001 (exemple de seuil minimum)
0.00011 (valide, supérieur au minimum)
0.0001234 (valide, avec plus de précision décimale)

Exemple A : petit Business Order à fixed speed (équivalent 1 PH)

Cet exemple illustre une petite vitesse fixe précise utilisant des décimales. (Les valeurs de vitesse sont exprimées en 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"
}

Exemple B : Business Order à fixed speed (25 PH pendant 30 jours)

Pour cibler 25 PH sur SHA256AsicBoost, convertissez en EH :

1 PH = 0.001 EH
25 PH = 0.025 EH

Utilisez une fenêtre de vitesse qui inclut votre cible. Par exemple :

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"
}

Note : Si le backend ne peut pas allouer l’intégralité du package à ce moment-là, vous pouvez recevoir une erreur d’allocation. Dans ce cas, réessayez plus tard, élargissez légèrement la fenêtre de vitesse, changez de marché (UE/USA) ou divisez l’ordre en ordres plus petits.

Dépannage des erreurs courantes

5068 – Invalid order market factor : unité ou facteur incorrect (doit correspondre à /mining/algorithms).
2997 – Invalid order amount or limit or price : montant trop faible, fenêtre de vitesse invalide ou limite inférieure au minimum.
5191 – Unable to allocate hashrate : requête valide, offre insuffisante ; réessayez ou divisez l’ordre.

Ressources supplémentaires

Résumé

Vous pouvez placer des Business Orders soit via l’interface NiceHash, soit via l’API. L’approche API est recommandée pour les acheteurs professionnels qui souhaitent de l’automatisation et un meilleur contrôle.

Validez toujours les limites de l’algorithme en utilisant GET /main/api/v2/mining/algorithms. Puis construisez la charge utile de votre ordre en conséquence.