Documentación

Cancelar

TradingRequiere autenticación

Cancele un contrato activo proporcionando el ID del contrato. El loginid parámetro se eliminó; la respuesta no cambió.

Comparación rápida

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

Cambios importantes

1. loginid parámetro eliminado

En la API heredada, loginid seleccionaba la cuenta desde la que se cancelaba el contrato cuando autorizaba varias cuentas. La nueva API no lo acepta.

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

Estructura de solicitud

Legacy APIejemplo de solicitud
{
  "cancel": 11542203588,
  "loginid": "CR123456",
  "passthrough": {
    "user_action": "manual_cancel"
  },
  "req_id": 1
}
New APIejemplo de solicitud
{
  "cancel": 11542203588,
  "passthrough": {
    "user_action": "manual_cancel"
  },
  "req_id": 1
}

Estructura de respuesta

Legacy APIejemplo de respuesta
{
  "cancel": {
    "balance_after": 10450.5,
    "contract_id": 11542203588,
    "reference_id": 11542203587,
    "sold_for": 23.45,
    "transaction_id": 11542203589
  },
  "echo_req": {
    "cancel": 11542203588,
    "passthrough": {
      "user_action": "manual_cancel"
    },
    "req_id": 1
  },
  "msg_type": "cancel",
  "req_id": 1
}
New APIejemplo de respuesta
{
  "cancel": {
    "balance_after": 10450.5,
    "contract_id": 11542203588,
    "reference_id": 11542203587,
    "sold_for": 23.45,
    "transaction_id": 11542203589
  },
  "echo_req": {
    "cancel": 11542203588,
    "passthrough": {
      "user_action": "manual_cancel"
    },
    "req_id": 1
  },
  "msg_type": "cancel",
  "req_id": 1
}

Ejemplos de código

function cancelContract(contractId, loginId) {
  const request = { cancel: contractId, req_id: 1 };
  // Needed only when you authorised several accounts
  if (loginId) request.loginid = loginId;
  ws.send(JSON.stringify(request));

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