Configuración de Options REST

Gestione cuentas de trading de Options y establezca conexiones WebSocket para trading en tiempo real.

Descripción general

Las APIs de configuración de Options le permiten crear y gestionar cuentas de trading de Options utilizando endpoints REST. Estos endpoints gestionan la creación de cuentas, la gestión del saldo y la configuración de autenticación WebSocket.

Flujo de trabajo típico

1. Cree una cuenta de trading de Options usando POST /trading/v1/options/accounts.
2. Solicite una URL WebSocket mediante POST /trading/v1/options/accounts/{accountId}/otp.
3. Conéctese directamente a la URL WebSocket devuelta.
4. Comience operaciones de trading a través de la conexión WebSocket.

Endpoints Disponibles

Autentificación

Los endpoints autenticados requieren un encabezado Authorization: Bearer YOUR_AUTH_TOKEN. Al autenticarse con un Token de Acceso Personal (PAT), el encabezado Deriv-App-ID también es obligatorio (consulte Authentication).

Alcances de OAuth2

1curl -X POST https://api.derivws.com/trading/v1/options/accounts \
2  -H "Authorization: Bearer YOUR_OAUTH_TOKEN" \
3  -H "Content-Type: application/json" \
4  -d '{"currency": "USD", "group": "row", "account_type": "demo"}'
5# Add -H "Deriv-App-ID: YOUR_APP_ID" when authenticating with a Personal Access Token (PAT).

Códigos de estado de respuesta

La API utiliza códigos de estado HTTP estándar para indicar éxito o fallo:

Formato de respuesta de error

Todas las respuestas de error siguen una estructura consistente con un array de errores y metadatos:

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

Los códigos de error incluyen: ValidationError, FieldIsRequired, Unauthorized, UnauthorizedAccess, AccessDenied, AccountNotFound, BadInputRequest, RateLimit, InternalServerError