Documentación

Vender

TradingRequiere autenticación

Venda un contrato activo antes de su vencimiento para obtener una ganancia o limitar una pérdida. El parámetro loginid se eliminó; la respuesta no cambia.

Comparación rápida

AspectoLegacy APINew APIAcción
EndpointsellsellNinguno
Requiere autenticaciónSíSíNinguno
loginid parámetroOpcionalEliminadoEliminar de las solicitudes

Cambios importantes

1. loginid parámetro eliminado

En la Legacy API, loginid seleccionaba la cuenta desde la cual vender el contrato cuando autorizaba varias cuentas. La New API no lo acepta.

Cambio obligatorio: Elimine loginid de sus solicitudes de sell . Su token selecciona la cuenta.

Estructura de solicitud

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

Estructura de respuesta

Legacy APIejemplo de respuesta
{
  "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 APIejemplo de respuesta
{
  "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
  }
}

Ejemplos 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.