Documentação

Vender

NegociaçãoAutenticação Obrigatória

Venda um contrato ativo antes do vencimento para realizar um lucro ou limitar uma perda. O loginid parâmetro foi removido; a resposta não foi alterada.

Comparação rápida

AspetoLegacy APINew APIAção
EndpointsellsellNenhum
Autenticação ObrigatóriaSimSimNenhum
loginid parâmetroOpcionalRemovidoRemover dos pedidos

Alterações de rutura

1. loginid parâmetro removido

Na Legacy API, loginid selecionava a conta a partir da qual vender o contrato quando autorizava várias contas. A New API não o aceita.

Alteração obrigatória: Remova loginid dos seus pedidos sell . O seu token seleciona a conta.

Estrutura de pedido

Legacy APIexemplo de pedido
{
  "sell": 11542203588,
  "price": 0,
  "loginid": "CR123456",
  "req_id": 1
}
New APIexemplo de pedido
{
  "sell": 11542203588,
  "price": 0,
  "req_id": 1
}

Estrutura de resposta

Legacy APIexemplo de resposta
{
  "echo_req": {
    "sell": 11542203588,
    "price": 0,
    "req_id": 1
  },
  "msg_type": "sell",
  "req_id": 1,
  "sell": {
    "balance_after": 10450.5,
    "contract_id": 11542203588,
    "reference_id": 11542203587,
    "sold_for": 23.45,
    "transaction_id": 11542203589
  }
}
New APIexemplo de resposta
{
  "echo_req": {
    "sell": 11542203588,
    "price": 0,
    "req_id": 1
  },
  "msg_type": "sell",
  "req_id": 1,
  "sell": {
    "balance_after": 10450.5,
    "contract_id": 11542203588,
    "reference_id": 11542203587,
    "sold_for": 23.45,
    "transaction_id": 11542203589
  }
}

Exemplos de código

// price 0 sells at the market price
function sellContract(contractId, loginId) {
  const request = { sell: contractId, price: 0, req_id: 1 };
  // Needed only when you authorised several accounts
  if (loginId) request.loginid = loginId;
  ws.send(JSON.stringify(request));

  ws.onmessage = (event) => {
    const response = JSON.parse(event.data);
    if (response.msg_type !== "sell") return;
    if (response.error) {
      console.error(response.error.message);
      return;
    }
    if (response.sell) {
      console.log("Sold for: " + response.sell.sold_for);
      console.log("New balance: " + response.sell.balance_after);
    }
  };
}
Click to open live chat support. Get instant help from our support team.