Documentation

Vendre

TradingAuthentification requise

Vendez un contrat actif avant son expiration afin de réaliser un profit ou de limiter une perte. Le paramètre loginid est supprimé ; la réponse reste inchangée.

Comparaison rapide

AspectLegacy APINew APIAction
Point de terminaisonsellsellAucun
Authentification requiseOuiOuiAucun
loginid paramètreFacultatifSuppriméRetirer des requêtes

Modifications majeures

1. loginid paramètre supprimé

Dans la Legacy API, loginid sélectionnait le compte à partir duquel vendre le contrat lorsque vous aviez autorisé plusieurs comptes. La New API ne l’accepte pas.

Modification requise : Supprimez loginid de vos requêtes sell . Votre token sélectionne le compte.

Structure de la demande

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

Structure de réponse

Legacy APIexemple de réponse
{
  "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 APIexemple de réponse
{
  "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
  }
}

Exemples de code

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