Configuração de Options REST

Gerir contas de negociação de Options e estabelecer ligações WebSocket para negociação em tempo real.

Visão Geral

As APIs de Configuração de Options permitem criar e gerir contas de negociação de Options usando endpoints REST. Estes endpoints tratam da criação de contas, gestão de saldos e configuração de autenticação WebSocket.

Fluxo de Trabalho Típico

1. Crie uma conta de negociação Options usando POST /trading/v1/options/accounts.
2. Solicite um URL WebSocket via POST /trading/v1/options/accounts/{accountId}/otp.
3. Ligar diretamente ao URL WebSocket devolvido.
4. Iniciar operações de negociação através da ligação WebSocket.

Endpoints Disponíveis

Autenticação

Todos os endpoints autenticados requerem o cabeçalho Deriv-App-ID e um cabeçalho Authorization: Bearer YOUR_AUTH_TOKEN.

Âmbitos OAuth2

1curl -X POST https://api.derivws.com/trading/v1/options/accounts \
2  -H "Deriv-App-ID: YOUR_APP_ID" \
3  -H "Authorization: Bearer YOUR_OAUTH_TOKEN" \
4  -H "Content-Type: application/json" \
5  -d '{"currency": "USD", "group": "row", "account_type": "demo"}'

Códigos de Estado da Resposta

A API usa códigos de estado HTTP padrão para indicar sucesso ou falha:

Formato de Resposta de Erro

Todas as respostas de erro seguem uma estrutura consistente com um array de erros e metadados:

1{
2  "errors": [
3    {
4      "status": 400,
5      "code": "ValidationError",
6      "message": "currency field is required"
7    }
8  ],
9  "meta": {
10  }
11}

Os códigos de erro incluem: ValidationError, FieldIsRequired, Unauthorized, UnauthorizedAccess, AccessDenied, AccountNotFound, BadInputRequest, RateLimit, InternalServerError