Descripción General de la API

Comprendiendo el ecosistema de Deriv API y sus capacidades principales.

Introducción

Deriv API proporciona acceso programático a servicios de trading, gestión de cuentas y datos de mercado para la plataforma de trading de Options. La API permite a los desarrolladores integrar la robusta infraestructura de trading de Deriv en sus aplicaciones usando endpoints REST para configuración de cuentas y conexiones WebSocket para trading en tiempo real.

Características clave

Creación y gestión de cuentas de Options (REST)
Depósitos, retiros y búsquedas de agentes de pago (REST)
Transmisión de datos de mercado en tiempo real (WebSocket)
Trading de contratos (comprar, vender, actualizar) (WebSocket)
Supervisión de cartera y cuenta (WebSocket)
Acceso a datos históricos (WebSocket)
Actualizaciones en tiempo real basadas en suscripción (WebSocket)
Acceso seguro mediante OAuth 2.0 o Personal Access Token (PAT)

Arquitectura de la API

Deriv API consta de dos componentes complementarios diseñados para funcionar juntos sin problemas:

APIs REST

Creación y gestión de cuentas
Depósitos, retiros y búsquedas de directorio de agentes de pago
Generación de OTP para autenticación WebSocket
Supervisión de salud del sistema
Métodos HTTP estándar (GET, POST)
Solicitudes sin estado
Autenticación mediante encabezado Deriv-App-ID + token Authorization: Bearer (OAuth 2.0 o PAT)

APIs WebSocket

Operaciones de trading en tiempo real (comprar, vender, propuestas)
Estrategias de trading automatizadas (ejecutar, pausar, reanudar, detener)
Transmisión de datos de mercado en vivo (ticks, símbolos)
Suscripciones de datos de cuenta (saldo, cartera)
Conexión bidireccional persistente
Notificaciones push en tiempo real
Tres tipos de endpoints: public (sin autenticación), demo y real (ambos autenticados mediante OTP)

Cuándo usar REST vs WebSocket

Característica	REST API	API WebSocket
Caso de uso	Configuración y gestión de cuenta	Trading en tiempo real y datos de mercado
Tipo de Conexión	Solicitudes HTTP sin estado	Conexión persistente
Autentificación	Encabezado Deriv-App-ID + token Bearer (OAuth 2.0 o PAT)	Basado en OTP (obtenido mediante REST API); el endpoint público no requiere autenticación
Actualizaciones en tiempo real	No (solo solicitud-respuesta)	Sí (suscripciones)
Ejemplos	`POST /trading/v1/options/accounts`, `POST .../{accountId}/otp`, `GET /v1/health`	Comprar contrato, transmitir ticks, obtener saldo

Flujo de trabajo típico

REST: Obtenga una URL WebSocket autenticada mediante el endpoint OTP (requiere su token Bearer)
WebSocket: Conéctese usando la URL autenticada devuelta en la respuesta OTP
WebSocket: Realizar operaciones de trading en tiempo real

Nota: Los usuarios reciben una cuenta de demostración predeterminada al registrarse — no necesita crear una mediante la API antes de operar.

Endpoints de API

URL base REST:

1https://api.derivws.com

Endpoints de WebSocket:

1# Public (no authentication required)
2wss://api.derivws.com/trading/v1/options/ws/public
3
4# Demo account (authenticated via OTP)
5wss://api.derivws.com/trading/v1/options/ws/demo?otp=YOUR_OTP
6
7# Real account (authenticated via OTP)
8wss://api.derivws.com/trading/v1/options/ws/real?otp=YOUR_OTP

El OTP se obtiene llamando a POST /trading/v1/options/accounts/{accountId}/otp — la respuesta contiene una URL WebSocket lista para usar con el OTP ya integrado.

Requisitos de conexión:

Cliente con capacidad WebSocket (navegador o del lado del servidor)
Conexión estable a Internet
Deriv-App-ID válido y token Bearer para llamadas REST y generación OTP

Descargar esquemas de API

Todos los esquemas de API se publican con cada lanzamiento de producción como schemas.zip. El archivo contiene todos los archivos de esquema JSON de WebSocket y la especificación de OpenAPI 3.1.0 de la API REST — listo para uso sin conexión, generadores de SDK o herramientas de cliente.

Descargar schemas.zip →

https://github.com/deriv-com/deriv-api-schemas/releases/latest/download/schemas.zip

¿Necesita una versión específica? Cada lanzamiento tiene una URL versionada en el formato …/releases/download/{tag}/schemas.zip. Explore todos los lanzamientos en github.com/deriv-com/deriv-api-schemas/releases.

Próximos pasos

Continúe con estas guías para empezar a construir con Deriv API:

Introducción Autentificación

¿Alguna otra pregunta? Póngase en contacto