Deriv API
Documentation
Points de terminaison de compte

Solde

Authentification requise

Obtenir le solde de compte actuel et éventuellement s'abonner aux mises à jour de solde en temps réel.

Comparaison rapide

AspectLegacy APINew APIStatut
Point de terminaisonbalancebalanceInchangé
Authentification requiseOuiOuiInchangé
Multi-comptesPris en chargeNon pris en chargeSupprimé

Changements majeurs

1. Paramètre Account supprimé

Le paramètre account (pour récupérer "tous" les comptes, "actuel", ou un ID de compte spécifique) a été supprimé.

2. Réponse multi-comptes supprimée

L'objet accounts dans la réponse qui contenait des informations détaillées sur tous les comptes actifs a été supprimé.

3. Soldes totaux supprimés

L'objet total qui fournissait les totaux de synthèse par type de compte (deriv, deriv_demo, mt5, mt5_demo) a été supprimé.

4. Paramètre Login ID supprimé

Le paramètre loginid a été supprimé. Ce paramètre était obligatoire lorsque plusieurs tokens étaient fournis lors de l'autorisation.

Structure de requête

Legacy APIexemple de demande
{
  "balance": 1,
  "account": "all",      // ❌ Removed in New
  "loginid": "CR123456", // ❌ Removed in New
  "subscribe": 1
}
New APIexemple de demande
{
  "balance": 1,
  "subscribe": 1
}

Structure de réponse

Legacy APIexemple de réponse
{
  "balance": {
    "balance": 10000.50,
    "currency": "USD",
    "loginid": "CR123456",
    "accounts": {  // ❌ Not in New
      "CR123456": {
        "balance": 10000.50,
        "converted_amount": 10000.50,
        "currency": "USD",
        "demo_account": 0,
        "status": 1,
        "type": "deriv"
      }
    }
  }
}
New APIexemple de réponse
{
  "balance": {
    "balance": 10000.50,
    "currency": "USD",
    "loginid": "CR123456"
  },
  "msg_type": "balance"
}

Exemples de codes

Legacy APIimplémentation
async function getCurrentBalance() {
  const request = {
    balance: 1,
    subscribe: 1
  };

  ws.send(JSON.stringify(request));

  ws.onmessage = (event) => {
    const response = JSON.parse(event.data);
    if (response.msg_type === 'balance') {
      console.log('Balance:', response.balance.balance);
      console.log('Currency:', response.balance.currency);
      console.log('Login ID:', response.balance.loginid);

      // Access multi-account data
      if (response.balance.accounts) {
        Object.keys(response.balance.accounts).forEach(id => {
          const acc = response.balance.accounts[id];
          console.log(`Account ${id}: ${acc.balance}`);
        });
      }
    }
  };
}
New APIimplémentation
async function getCurrentBalance() {
  const request = {
    balance: 1,
    subscribe: 1
  };

  ws.send(JSON.stringify(request));

  ws.onmessage = (event) => {
    const response = JSON.parse(event.data);
    if (response.msg_type === 'balance') {
      console.log('Balance:', response.balance.balance);
      console.log('Currency:', response.balance.currency);
      console.log('Login ID:', response.balance.loginid);

      // Multi-account data no longer available
      // Make separate calls for each account
    }
  };
}
Click to open live chat support. Get instant help from our support team.