Achat en masse

Achetez le même contrat d'options pour plusieurs comptes d'utilisateurs finaux en un seul appel. Il s'agit du successeur V2 du flux legacy buy_contract_for_multiple_accounts utilisé par les plateformes de copy-trading. L'authentification est par compte : chaque entrée dans accounts associe un token d'accès personnel de l'utilisateur final portant le périmètre de trading au compte qu'il possède, de sorte qu'aucun token OAuth distinct n'est nécessaire pour l'appel lui-même. Vous envoyez un ensemble de paramètres de contrat avec une liste de comptes pour lesquels acheter, et les mêmes paramètres s'appliquent à chaque compte. Jusqu'à 100 comptes sont acceptés par requête. Chaque chemin account_type n'accepte que son propre type de compte — un compte démo soumis au chemin réel (ou vice versa) est signalé comme un échec par compte, et non comme une erreur au niveau de la requête. Toute entrée qui échoue à la validation du token, de la propriété ou du type de compte est signalée individuellement, sans affecter les autres, mais la requête est rejetée si aucune des entrées ne passe la validation.

Point de terminaison

Codes de statut

Réponses d'erreur

{
  "errors": [
    {
      "status": 400,
      "code": "ValidationError",
      "message": "No token/account pair passed validation",
      "field": "accounts.0.token"
    }
  ],
  "meta": {
    "endpoint": "/contracts/bulk-purchase/real",
    "method": "POST",
    "timing": 28
  }
}

{
  "errors": [
    {
      "status": 401,
      "code": "Unauthorized",
      "message": "Invalid or missing authentication credentials"
    }
  ],
  "meta": {
    "endpoint": "/contracts/bulk-purchase/real",
    "method": "POST",
    "timing": 12
  }
}

{
  "errors": [
    {
      "status": 502,
      "code": "InternalServerError",
      "message": "An upstream dependency was unavailable. Please retry."
    }
  ],
  "meta": {
    "endpoint": "/contracts/bulk-purchase/real",
    "method": "POST",
    "timing": 61
  }
}

À propos de Achat en masse

Le point de terminaison POST /trading/v1/options/contracts/bulk-purchase/{account_type} : Achetez le même contrat d'options pour plusieurs comptes d'utilisateurs finaux en un seul appel. Il s'agit du successeur V2 du flux legacy buy_contract_for_multiple_accounts utilisé par les plateformes de copy-trading. L'authentification est par compte : chaque entrée dans accounts associe un token d'accès personnel de l'utilisateur final portant le périmètre de trading au compte qu'il possède, de sorte qu'aucun token OAuth distinct n'est nécessaire pour l'appel lui-même. Vous envoyez un ensemble de paramètres de contrat avec une liste de comptes pour lesquels acheter, et les mêmes paramètres s'appliquent à chaque compte. Jusqu'à 100 comptes sont acceptés par requête. Chaque chemin account_type n'accepte que son propre type de compte — un compte démo soumis au chemin réel (ou vice versa) est signalé comme un échec par compte, et non comme une erreur au niveau de la requête. Toute entrée qui échoue à la validation du token, de la propriété ou du type de compte est signalée individuellement, sans affecter les autres, mais la requête est rejetée si aucune des entrées ne passe la validation.

Variantes de points de terminaison

Il existe deux points de terminaison spécifiques au type de compte. Remplacez {account_type} par real pour les comptes en argent réel ou demo pour les comptes de démonstration :

• POST /trading/v1/options/contracts/bulk-purchase/real
• POST /trading/v1/options/contracts/bulk-purchase/demo

Les deux points de terminaison se comportent de manière identique, à l'exception du type de compte qu'ils acceptent. Le passage d'un compte de démonstration au chemin /real (ou vice versa) est signalé comme une erreur par compte.

Authentification

Aucun token d'accès OAuth n'est requis pour ce point de terminaison. L'authentification se fait via l'en-tête Deriv-App-ID de votre application ainsi que les tokens d'accès personnels (PAT) par compte fournis dans le corps de la demande. Chaque PAT doit porter la portée trade et posséder le compte auquel il est associé.