Deriv API
Documentación
Configuración de Options

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

Obtener todas las cuentasGet
Obtener todas las cuentas de trading de Options/trading/v1/options/accounts
Crear cuentaPost
Cree una nueva cuenta de trading de Options/trading/v1/options/accounts
Restablecer el saldo de la cuenta demoPost
Restablecer saldo para la cuenta demo de trading de Options/trading/v1/options/accounts/{account_id}/reset-demo-balance
WebSocketsPost
Emite una contraseña de un solo uso (OTP) de corta duración que autentica una conexión WebSocket posterior para la cuenta especificada. La respuesta incluye el OTP y una URL de WebSocket lista para usar con el OTP adjunto como parámetro de consulta. El OTP es válido durante 120 segundos y solo puede utilizarse una vez, por lo que abra la conexión WebSocket inmediatamente después de llamar a este endpoint./trading/v1/options/accounts/{accountId}/otp
Endpoint de Demo de WebSocketGet
Actualiza la conexión a un WebSocket vinculado a una cuenta demo de Options Trading. Requiere una contraseña de un solo uso (OTP) válida del endpoint OTP, pasada como el parámetro de consulta otp. Utilice este canal para suscribirse a datos de mercado, enviar instrucciones de trading y recibir actualizaciones de órdenes y posiciones para la cuenta demo./trading/v1/options/ws/demo
Endpoint real de WebSocketGet
Actualiza la conexión a un WebSocket vinculado a una cuenta de trading de opciones con dinero real. Requiere una contraseña de un solo uso (OTP) válida del endpoint OTP, pasada como el parámetro de consulta otp. Las operaciones realizadas Over este canal se liquidan contra el saldo real de la cuenta./trading/v1/options/ws/real
Endpoint público de WebSocketGet
Transmite datos de mercado públicos en tiempo real — cotizaciones, ticks y metadatos de contratos — sin necesidad de autenticación ni OTP. Las acciones vinculadas a la cuenta, como la realización de operaciones o la consulta de saldos, no están disponibles en este canal./trading/v1/options/ws/public

Autentificación

Todos los endpoints autenticados requieren el encabezado Deriv-App-ID y un encabezado Authorization: Bearer YOUR_AUTH_TOKEN.

Alcances de OAuth2

EndpointAlcance
GET /trading/v1/options/accountstrade
POST /trading/v1/options/accountsaccount_manage
POST /.../reset-demo-balancetrade
POST .../{accountId}/otptrade
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 de respuesta

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

2xx Éxito
200 OK — Solicitud exitosa (cuenta existente o OTP generado)
201 Created — Nuevo recurso creado con éxito
Errores 4xx/5xx
400 Bad Request — Parámetros o cuerpo de solicitud no válidos
401 Unauthorized — Autenticación no válida o faltante
403 Forbidden — Acceso denegado
404 Not Found — Recurso no encontrado
500 Internal Server Error — Error del lado del servidor
504 Gateway Timeout — Tiempo de espera del servicio upstream

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

Click to open live chat support. Get instant help from our support team.