Compra em Volume

Compre o mesmo contrato de opções para múltiplas contas de utilizadores finais numa única chamada. Esta é a versão V2 sucessora do fluxo legado buy_contract_for_multiple_accounts utilizado pelas plataformas de copy-trading. A autenticação é por conta: cada entrada em accounts emparelha um token de acesso pessoal do utilizador final com o âmbito de negociação com a conta que lhe pertence, pelo que não é necessário um token OAuth separado para a própria chamada. Envia um conjunto de parâmetros de contrato com uma lista de contas para as quais comprar, e os mesmos parâmetros aplicam-se a todas as contas. São aceites até 100 contas por pedido. Cada caminho account_type aceita apenas o seu próprio tipo de conta — uma conta demo submetida ao caminho real (ou vice-versa) é reportada como uma falha por conta, não como um erro ao nível do pedido. Qualquer entrada que falhe na validação do token, titularidade ou tipo de conta é reportada individualmente, sem afetar as restantes, mas o pedido é rejeitado se nenhuma das entradas passar na validação.

Endpoint

Códigos de Estado

Respostas de Erro

{
  "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 em Volume

O endpoint POST /trading/v1/options/contracts/bulk-purchase/{account_type}: Compre o mesmo contrato de opções para múltiplas contas de utilizadores finais numa única chamada. Esta é a versão V2 sucessora do fluxo legado buy_contract_for_multiple_accounts utilizado pelas plataformas de copy-trading. A autenticação é por conta: cada entrada em accounts emparelha um token de acesso pessoal do utilizador final com o âmbito de negociação com a conta que lhe pertence, pelo que não é necessário um token OAuth separado para a própria chamada. Envia um conjunto de parâmetros de contrato com uma lista de contas para as quais comprar, e os mesmos parâmetros aplicam-se a todas as contas. São aceites até 100 contas por pedido. Cada caminho account_type aceita apenas o seu próprio tipo de conta — uma conta demo submetida ao caminho real (ou vice-versa) é reportada como uma falha por conta, não como um erro ao nível do pedido. Qualquer entrada que falhe na validação do token, titularidade ou tipo de conta é reportada individualmente, sem afetar as restantes, mas o pedido é rejeitado se nenhuma das entradas passar na validação.

Variantes de Endpoint

Existem dois endpoints específicos por tipo de conta. Substitua {account_type} por real para contas de dinheiro real ou demo para contas de demonstração:

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

Os dois endpoints comportam-se de forma idêntica, exceto no tipo de conta que aceitam. Passar uma conta de demonstração para o caminho /real (ou vice-versa) é reportado como um erro por conta.

Autenticação

Não é necessário um token de acesso OAuth para este endpoint. A autenticação é feita através do cabeçalho Deriv-App-ID da sua aplicação juntamente com os Tokens de Acesso Pessoal (PATs) por conta fornecidos no corpo do pedido. Cada PAT deve conter o âmbito trade e ser proprietário da conta com a qual está emparelhado.