Cómo crear una orden comercial (Guía de UI y API)

Las Órdenes Comerciales de NiceHash están diseñadas para compradores profesionales de hashrate que necesitan una entrega de hashrate estable y predecible y más control que las órdenes estándar del mercado. Para una Orden Comercial, se requiere una organización verificada (KYB).

Existen dos tipos de Órdenes Comerciales:

1. Velocidad Fija: Velocidad constante; el tiempo de finalización fluctúa en función del precio del índice de hashrate y de los fondos disponibles.
2. Duración Fija: Lógica inversa; la velocidad se adapta a una fecha de finalización fija, influenciada por el precio del índice de hashrate y los fondos disponibles.

IMPORTANTE: Los cambios se realizan cada 15 minutos

¿Qué es una Orden Comercial?

Una Orden Comercial es un paquete de hashrate gestionado, ensamblado a partir de vendedores disponibles en el mercado de NiceHash. Le permite comprar hashrate con:

• Entrega con Velocidad Fija Prioritaria (hashrate estable)
• Múltiples algoritmos (SHA256AsicBoost, Scrypt y KHeavyHash)
• Selección de mercado (UE / EE. UU.)
• Minería directa a su propio pool
• Mejor previsibilidad para la planificación y las operaciones

Antes de Empezar

Para crear una Orden Comercial, asegúrese de tener:

• Un pool de minería configurado en NiceHash (necesitará el poolId)
• El algoritmo correcto seleccionado (por ejemplo, SHA256AsicBoost)
• El mercado de destino elegido (UE o EE. UU.)
• Verificados los límites actuales del algoritmo mediante la API (recomendado)

Importante: Verificar los Límites del Algoritmo vía API

La configuración del algoritmo (límites, factores, mercados habilitados) puede obtenerse desde el endpoint oficial:

GET /main/api/v2/mining/algorithms

Utilice este endpoint para verificar:

• minimalOrderAmount (importe mínimo en BTC)
• minSpeedLimit y maxSpeedLimit (rango válido de velocidad)
• displayMarketFactor y marketFactor (unidades requeridas y escala)

Documentación (detalles de los parámetros): MINING ALGORITHMS – GET /main/api/v2/mining/algorithms.

Opción 1: Crear una Orden Comercial a través de la Interfaz (UI)

Utilice la interfaz de NiceHash si desea una configuración guiada y manual.

1. Inicie sesión en NiceHash.
2. Navegue a Mercado de Hashrate → Órdenes Comerciales.
3. Seleccione su mercado (UE / EE. UU.).
4. Elija el algoritmo (por ejemplo, SHA256AsicBoost).
5. Seleccione o añada su pool de minería.
6. Seleccione el tipo de Orden Comercial.
7. Para velocidad fija, establezca el importe y el límite de velocidad. Para duración fija, establezca el importe, el límite mínimo de velocidad y la fecha de finalización.
8. Revise y confirme la orden.

Opción 2: Crear una Orden Comercial con velocidad fija vía API

El método mediante API se recomienda si desea:

• Selección explícita de Velocidad Fija (subType)
• Configuración precisa de la velocidad (incluida la precisión decimal por encima del mínimo)
• Automatización, reintentos, escalado e integración con herramientas internas

Las implementaciones de referencia y los ejemplos de firma HMAC están disponibles aquí: NiceHash REST Clients Demo (GitHub).

Llamadas a la API Utilizadas en un Flujo Típico de Orden Comercial

Estos endpoints se utilizan habitualmente al crear Orden Comercial de forma programática:

• Leer límites y factores del algoritmo: GET /main/api/v2/mining/algorithms
• Listar pools: GET /main/api/v2/pool
• Crear una pool (si es necesario): POST /main/api/v2/pool
• Crear una Orden Comercial: POST /main/api/v2/hashpower/business/order
• Supervisar el estado de la orden: GET /main/api/v2/hashpower/order/<orderId>

Conceptos Básicos de Velocidad Fija (Ejemplo SHA256AsicBoost)

Para SHA256ASICBOOST, las Órdenes Comerciales utilizan EH como unidad de velocidad.

Regla de velocidad mínima: su limit debe ser mayor o igual al mínimo del algoritmo (minSpeedLimit / minLimit derivado). Se trata de una restricción de velocidad mínima, no de una limitación de precisión decimal.

Ejemplos (valores en EH):

• 0.0001 (ejemplo de umbral mínimo)
• 0.00011 (válido, superior al mínimo)
• 0.0001234 (válido, mayor precisión decimal)

Ejemplo A: Orden Comercial Pequeña de Velocidad Fija (Equivalente a 1 PH)

Este ejemplo demuestra una velocidad fija pequeña y precisa utilizando decimales. (Los valores de velocidad se expresan 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"
}

Ejemplo B: Orden Comercial de Velocidad Fija (25 PH durante 30 Días)

Para alcanzar 25 PH en SHA256AsicBoost, convierta a EH:

• 1 PH = 0.001 EH
• 25 PH = 0.025 EH

Utilice una ventana de velocidad que incluya su objetivo. Por ejemplo:

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

Nota: Si el backend no puede asignar el paquete completo en ese momento, puede recibir un error de asignación. En ese caso, intente nuevamente más tarde, amplíe ligeramente la ventana de velocidad, cambie de mercado (UE/EE. UU.) o divida la orden en órdenes más pequeñas.

Resolución de Problemas Comunes

• 5068 – Invalid order market factor: Unidad o factor incorrecto (debe coincidir con /mining/algorithms).
• 2997 – Invalid order amount or limit or price: Importe demasiado bajo, ventana de velocidad inválida o límite por debajo del mínimo.
• 5191 – Unable to allocate hashrate: Solicitud válida, suministro insuficiente; reintente o divida la orden.

Recursos Adicionales

• MINING ALGORITHMS – GET /main/api/v2/mining/algorithms
• NiceHash REST Clients Demo (GitHub)

Resumen

Puede realizar Órdenes Comerciales tanto a través de la interfaz de NiceHash como mediante la API. El enfoque mediante API se recomienda para compradores profesionales que desean automatización y mayor control.

Valide siempre los límites del algoritmo utilizando GET /main/api/v2/mining/algorithms y, a continuación, construya el payload de su orden en consecuencia.