Compra masiva

Compre el mismo contrato de opciones para múltiples cuentas de usuarios finales en una sola llamada. Este es el sucesor V2 del flujo heredado buy_contract_for_multiple_accounts utilizado por las plataformas de copy-trading. La autenticación es por cuenta: cada entrada en accounts asocia un token de acceso personal del usuario final con el alcance de trading con la cuenta que le pertenece, por lo que no se necesita un token OAuth separado para la llamada en sí. Usted envía un conjunto de parámetros de contrato con una lista de cuentas para las que desea comprar, y los mismos parámetros se aplican a cada cuenta. Se aceptan hasta 100 cuentas por solicitud. Cada ruta account_type acepta únicamente su propio tipo de cuenta: una cuenta demo enviada a la ruta real (o viceversa) se reporta como un fallo por cuenta, no como un error a nivel de solicitud. Cualquier entrada que no supere la validación de token, titularidad o tipo de cuenta se reporta de forma individual, sin afectar a las demás, pero la solicitud se rechaza si ninguna de las entradas supera la validación.

Endpoint

Códigos de Estado

Respuestas de Error

{
  "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
  }
}

Acerca de Compra masiva

El endpoint POST /trading/v1/options/contracts/bulk-purchase/{account_type}: Compre el mismo contrato de opciones para múltiples cuentas de usuarios finales en una sola llamada. Este es el sucesor V2 del flujo heredado buy_contract_for_multiple_accounts utilizado por las plataformas de copy-trading. La autenticación es por cuenta: cada entrada en accounts asocia un token de acceso personal del usuario final con el alcance de trading con la cuenta que le pertenece, por lo que no se necesita un token OAuth separado para la llamada en sí. Usted envía un conjunto de parámetros de contrato con una lista de cuentas para las que desea comprar, y los mismos parámetros se aplican a cada cuenta. Se aceptan hasta 100 cuentas por solicitud. Cada ruta account_type acepta únicamente su propio tipo de cuenta: una cuenta demo enviada a la ruta real (o viceversa) se reporta como un fallo por cuenta, no como un error a nivel de solicitud. Cualquier entrada que no supere la validación de token, titularidad o tipo de cuenta se reporta de forma individual, sin afectar a las demás, pero la solicitud se rechaza si ninguna de las entradas supera la validación.

Variantes de Endpoint

Hay dos endpoints específicos del tipo de cuenta. Reemplace {account_type} con real para cuentas de dinero real o demo para cuentas demo:

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

Los dos endpoints se comportan de manera idéntica aparte del tipo de cuenta que aceptan. Pasar una cuenta demo a la ruta /real (o viceversa) se reporta como un error por cuenta.

Autentificación

No se requiere un token de acceso OAuth para este endpoint. La autenticación se realiza mediante el encabezado Deriv-App-ID de su aplicación junto con los Tokens de Acceso Personal (PATs) por cuenta suministrados en el cuerpo de la solicitud. Cada PAT debe llevar el alcance trade y poseer la cuenta con la que está emparejado.