Deriv API
Documentación
Options Trading (Legacy)

Options Trading (Legacy) REST

Acceso de solo lectura a los datos de trading de opciones pre-actualización de un usuario migrado: estado de cuenta histórico, cuentas legacy y estado de actualización de plataforma.

Descripción general

Después de que la cuenta de un usuario ha sido actualizada desde la plataforma de opciones legacy, estos endpoints muestran su estado de cuenta de transacciones pre-actualización y mapeo de cuentas para que el registro histórico permanezca disponible. Los tres son de solo lectura, requieren un token OAuth2 con el alcance trade, y están limitados al usuario que realiza la llamada. Mientras la migración de un usuario aún esté pendiente o haya fallado, los endpoints de estado de cuenta y cuentas devuelven HTTP 409.

Flujo de trabajo típico

  1. Llame a GET /trading/v1/options/legacy/migration-status para confirmar que la migración del usuario ha alcanzado complete. Mientras el estado sea pending o failed, los otros dos endpoints devuelven HTTP 409.
  2. Liste los loginids y cuentas pre-actualización del usuario a través de GET /trading/v1/options/legacy/accounts.
  3. Obtenga el historial de transacciones pre-actualización por loginid a través de GET /trading/v1/options/legacy/statement?loginid=..., paginando con limit y offset.
  4. Para todas las operaciones de trading en vivo y operaciones de cuenta, continúe utilizando los endpoints estándar de Options Trading; estas rutas legacy sirven únicamente datos históricos.

Endpoints Disponibles

Autentificación

Todos los endpoints en esta sección requieren el encabezado Deriv-App-ID y un encabezado Authorization: Bearer YOUR_AUTH_TOKEN con el alcance OAuth2 trade.

Alcances de OAuth2

EndpointAlcance
GET /trading/v1/options/legacy/migration-statustrade
GET /trading/v1/options/legacy/accountstrade
GET /trading/v1/options/legacy/statementtrade
1curl -X GET "https://api.derivws.com/trading/v1/options/legacy/migration-status" \
2  -H "Deriv-App-ID: YOUR_APP_ID" \
3  -H "Authorization: Bearer YOUR_OAUTH_TOKEN"

Códigos de estado de respuesta

Se devuelven códigos de estado HTTP estándar. Un 409 indica que la migración del llamador está pendiente o ha fallado; esto es específico de los endpoints legacy.

2xx Éxito
200 OK — Solicitud exitosa. Para migration-status, todos los estados conocidos (incluyendo pending, failed, not_applicable) se devuelven con 200.
Errores 4xx/5xx
400 Bad Request — Entrada incorrecta (por ejemplo, loginid mal formado)
404 Not Found — Usuario o cuenta predeterminada no encontrado
409 Conflict — La migración del usuario está pendiente o ha fallado
422 Unprocessable Entity — Error de validación de solicitud
500 Internal Server Error — Error del lado del servidor
503 Service Unavailable — Servicio temporalmente no disponible

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": 409,
5      "code": "MigrationPending",
6      "message": "User migration is pending or has failed"
7    }
8  ],
9  "meta": {
10    "endpoint": "/trading/v1/options/legacy/statement",
11    "method": "GET",
12    "timing": 21
13  }
14}
Click to open live chat support. Get instant help from our support team.