Como criar uma ordem comercial (Guia de UI e API)

As Ordens Comerciais da NiceHash foram concebidas para compradores profissionais de hashrate que necessitam de uma entrega de hashrate estável e previsível e de mais controlo do que as ordens normais no mercado. Para fazer uma Ordem Comercial, é necessária uma organização verificada (KYB).

Existem dois tipos de ordens comerciais:

Velocidade Fixa: Velocidade constante; o tempo de conclusão varia com base no preço do índice de hashrate e nos fundos disponíveis.
Duração Fixa: Lógica inversa; a velocidade adapta-se a uma data de fim fixa, influenciada pelo preço do índice de hashrate e pelos fundos disponíveis.

IMPORTANTE: As alterações são efectuadas a cada 15 minutos

O que é uma Ordem Comercial?

Uma Ordem Comercial é um pacote de hashrate gerido, composto por vendedores disponíveis no mercado da NiceHash. Permite-lhe comprar hashrate com:

Entrega com Velocidade Fixa Prioritária (hashrate estável)
Múltiplos algoritmos (SHA256AsicBoost, Scrypt e KHeavyHash)
Selecção de mercado (UE / EUA)
Mineração directa para o seu próprio pool
Maior previsibilidade para planeamento e operações

Antes de Começar

Para criar uma Ordem Comercial, certifique-se de que tem:

Um pool de mineração configurado na NiceHash (irá precisar do poolId)
O algoritmo correcto seleccionado (por exemplo, SHA256AsicBoost)
O mercado de destino escolhido (UE ou EUA)
Verificado os limites actuais do algoritmo através da API (recomendado)

Importante: Verificar os Limites do Algoritmo via API

As definições do algoritmo (limites, factores, mercados activos) podem ser obtidas através do endpoint oficial:

GET /main/api/v2/mining/algorithms

Utilize este endpoint para verificar:

minimalOrderAmount (montante mínimo em BTC)
minSpeedLimit e maxSpeedLimit (intervalo válido de velocidade)
displayMarketFactor e marketFactor (unidades necessárias e escala)

Documentação (detalhes dos parâmetros): MINING ALGORITHMS – GET /main/api/v2/mining/algorithms.

Opção 1: Criar uma Ordem Comercial através da Interface (UI)

Utilize a interface da NiceHash se pretender uma configuração guiada e manual.

Inicie sessão na NiceHash.
Navegue até Mercado de Hashrate → Ordens Comerciais.
Seleccione o seu mercado (UE / EUA).
Escolha o algoritmo (por exemplo, SHA256AsicBoost).
Seleccione ou adicione o seu pool de mineração.
Seleccione o tipo de Ordem Comercial.
Para velocidade fixa, defina o montante e o limite de velocidade. Para duração fixa, defina o montante, o limite mínimo de velocidade e a data de fim.
Reveja e confirme a ordem.

Interface de business orders

Opção 2: Criar uma Ordem Comercial com velocidade fixa via API

O método via API é recomendado se pretender:

Selecção explícita de Velocidade Fixa (subType)
Configuração precisa da velocidade (incluindo precisão decimal acima do mínimo)
Automação, tentativas, escalabilidade e integração com ferramentas internas

Implementações de referência e exemplos de assinatura HMAC estão disponíveis aqui: NiceHash REST Clients Demo (GitHub).

Chamadas de API Utilizadas num Fluxo Típico de Business Order

Estes endpoints são normalmente utilizados ao criar Business Orders de forma programática:

Ler limites e factores do algoritmo: GET /main/api/v2/mining/algorithms
Listar pools: GET /main/api/v2/pool
Criar um pool (se necessário): POST /main/api/v2/pool
Criar uma Ordem Comercial: POST /main/api/v2/hashpower/business/order
Monitorizar o estado da ordem: GET /main/api/v2/hashpower/order/<orderId>

Noções Básicas de Velocidade Fixa (Exemplo SHA256AsicBoost)

Para SHA256ASICBOOST, as Ordens Comerciais utilizam EH como unidade de velocidade.

Regra de velocidade mínima: o seu limit deve ser maior ou igual ao mínimo do algoritmo (minSpeedLimit / minLimit derivado). Trata-se de uma restrição de velocidade mínima, e não de uma limitação de precisão decimal.

Exemplos (valores em EH):

0.0001 (exemplo de limiar mínimo)
0.00011 (válido, superior ao mínimo)
0.0001234 (válido, maior precisão decimal)

Exemplo A: Pequena Ordem Comercial de Velocidade Fixa (Equivalente a 1 PH)

Este exemplo demonstra uma velocidade fixa pequena e precisa utilizando decimais. (Os valores de velocidade são expressos em 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"
}

Exemplo B: Ordem Comercial de Velocidade Fixa (25 PH durante 30 Dias)

Para atingir 25 PH em SHA256AsicBoost, converta para EH:

1 PH = 0.001 EH
25 PH = 0.025 EH

Utilize uma janela de velocidade que inclua o seu objectivo. Por exemplo:

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: Se o backend não conseguir alocar o pacote completo nesse momento, poderá receber um erro de alocação. Nesse caso, tente novamente mais tarde, alargue ligeiramente a janela de velocidade, alterne entre mercados (UE/EUA) ou divida a ordem em ordens mais pequenas.

Resolução de Problemas Comuns

5068 – Invalid order market factor: Unidade ou factor incorrecto (deve corresponder a /mining/algorithms).
2997 – Invalid order amount or limit or price: Montante demasiado baixo, janela de velocidade inválida ou limite abaixo do mínimo.
5191 – Unable to allocate hashrate: Pedido válido, mas fornecimento insuficiente; tente novamente ou divida a ordem.

Recursos Adicionais

Resumo

Pode efectuar Business Orders através da interface da NiceHash ou via API. A abordagem via API é recomendada para compradores profissionais que pretendem automação e maior controlo.

Valide sempre os limites do algoritmo utilizando GET /main/api/v2/mining/algorithms e, em seguida, construa o payload da sua ordem em conformidade.