Documentação trade API

Nosso site fornece APIs que possibilitam os usuários consultar seu saldo, obter a lista de ordens e enviar e cancelar ordens de criptomoedas de forma automática.

API é um endereço de internet onde você pode enviar e receber dados via requisição HTTP. Confira a seguir como utilizá-la.

Para utilizar a Trade API você deverá gerar um par de chaves pública/privada que deverá ser utilizada para fazer as requisições.

Acesse aqui para gerar as suas chaves.

Acesse nossa ferramenta de teste da Trade API: Clique aqui

Repositório Oficial da ferramenta de teste da TradeAPI em .NET no GitHub

Para utilizar a Trade API você deverá gerar um par de chaves pública/privada que deverá ser utilizada para fazer as requisições.

Acesse aqui para gerar as suas chaves.

Cabeçalho de Autorização AMX (AMX Authorization Header)

O cabeçalho de autorização AMX é usado para proteger o acesso à nossa API de TRADE. Ele usa um token por chamada que é gerado usando o ID da API e a chave (API KEY) que foram fornecidos a você. Ele criptografa o conteúdo e usa um NONCE como segurança adicional.

Veja abaixo como utilizá-lo em nossos exemplos de código-fonte:

Exemplos de Código Fonte - Autenticação AMX

protected async override Task SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)

{

HttpResponseMessage response = null;

string requestContentBase64String = string.Empty;

string requestUri = HttpUtility.UrlEncode(request.RequestUri.AbsoluteUri.ToLower());

string requestHttpMethod = request.Method.Method;

DateTime epochStart = new DateTime(1970, 01, 01, 0, 0, 0, 0, DateTimeKind.Utc);

TimeSpan timeSpan = DateTime.UtcNow - epochStart;

string requestTimeStamp = Convert.ToUInt64(timeSpan.TotalSeconds).ToString();

ASCIIEncoding encoder = new ASCIIEncoding();

Byte[] code = encoder.GetBytes(APIKey);

HMACSHA256 hmSha1 = new HMACSHA256(code);

Byte[] hashMe = encoder.GetBytes(requestTimeStamp);

Byte[] hmBytes = hmSha1.ComputeHash(hashMe);

request.Headers.Add("APIKey", APPId);

request.Headers.Add("Nonce", requestTimeStamp);

request.Headers.Add("Signature", ToHexString(hmBytes));

response = await base.SendAsync(request, cancellationToken);

return response;

}

1. Estrutura das requisições

As requisições devem ser feitas para a URL: https://broker.negociecoins.com.br/tradeapi/v1/

1.1 Resposta

Todas as respostas são em fortado JSON

2. Requisições

Retorna o saldo em Reais e de criptomoedas do usuário

  • Formato da Requisição: GET
  • URL para Requisição: https://broker.negociecoins.com.br/tradeapi/v1/user/balance

Campos de retorno

  • BRL (Informações de saldo do usuário em Reais)
    • avaliable

      Decimal: saldo disponível do usuário

    • openOrders

      Decimal: total em ordens abertas de compra ou venda.

    • withdraw

      Decimal: total em saques solicitados.

    • total

      Decimal: saldo líquido atual.

  • BTC (Informações de saldo do usuário em Bitcoin)
    • avaliable

      Decimal: saldo disponível do usuário

    • openOrders

      Decimal: total em ordens abertas de compra ou venda.

    • withdraw

      Decimal: total em saques solicitados.

    • total

      Decimal: saldo líquido atual.

  • LTC (Informações de saldo do usuário em Litecoin)
    • avaliable

      Decimal: saldo disponível do usuário

    • openOrders

      Decimal: total em ordens abertas de compra ou venda.

    • withdraw

      Decimal: total em saques solicitados.

    • total

      Decimal: saldo líquido atual.

Exemplo de retorno

{

"BRL": {

"available": 500.002,

"openOrders": -400.0,

"withdraw": -52.75,

"total": 47.252

},

"BTC": {

"available": 100.00000001,

"openOrders": -50.0,

"withdraw": 0.0,

"total": 50.00000001

},

"LTC": {

"available": 200,00,

"openOrders": -100.0,

"withdraw": 0.0,

"total": 100.0

}, }