Vue d'ensemble de l'API

Comprendre l'écosystème Deriv API et ses capacités principales.

Introduction

Deriv API fournit un accès programmatique aux services de trading, à la gestion de compte et aux données de marché pour la plateforme de trading Options. L'API permet aux développeurs d'intégrer l'infrastructure de trading robuste de Deriv dans leurs applications en utilisant des points de terminaison REST pour la configuration de compte et des connexions WebSocket pour le trading en temps réel.

Fonctionnalités clés

Création et gestion de compte Options (REST)
Dépôts, retraits et recherches d'agents de paiement (REST)
Streaming de données de marché en temps réel (WebSocket)
Trading de contrats (achat, vente, mise à jour) (WebSocket)
Surveillance du portefeuille et du compte (WebSocket)
Accès aux données historiques (WebSocket)
Mises à jour en temps réel basées sur abonnement (WebSocket)
Accès sécurisé via OAuth 2.0 ou Personal Access Token (PAT)

Architecture API

Deriv API se compose de deux composants complémentaires conçus pour fonctionner ensemble de manière transparente :

API REST

Création et gestion de compte
Dépôts, retraits et recherches d'annuaire des agents de paiement
Génération OTP pour l'authentification WebSocket
Surveillance de la santé du système
Méthodes HTTP standard (GET, POST)
Demandes sans état
Authentification via l'en-tête Deriv-App-ID + token Authorization: Bearer (OAuth 2.0 ou PAT)

API WebSocket

Opérations de trading en temps réel (achat, vente, propositions)
Stratégies de trading automatisées (exécuter, suspendre, reprendre, arrêter)
Streaming de données de marché en direct (ticks, symboles)
Abonnements aux données de compte (solde, portefeuille)
Connexion bidirectionnelle persistante
Notifications push en temps réel
Trois types de points de terminaison : public (pas d'authentification), demo et real (tous deux authentifiés via OTP)

Quand utiliser REST vs WebSocket

Fonctionnalité	REST API	API WebSocket
Cas d'utilisation	Configuration et gestion du compte	Trading en temps réel et données de marché
Type de connexion	Demandes HTTP sans état	Connexion persistante
Authentification	En-tête Deriv-App-ID + token Bearer (OAuth 2.0 ou PAT)	Basé sur OTP (obtenu via REST API) ; le point de terminaison public ne nécessite aucune authentification
Mises à jour en temps réel	Non (demande-réponse uniquement)	Oui (abonnements)
Exemples	`POST /trading/v1/options/accounts`, `POST .../{accountId}/otp`, `GET /v1/health`	Acheter un contrat, flux de ticks, obtenir le solde

Flux de travail typique

REST : Obtenez une URL WebSocket authentifiée via le point de terminaison OTP (nécessite votre token Bearer)
WebSocket : Connectez-vous à l'aide de l'URL authentifiée renvoyée dans la réponse OTP
WebSocket : Effectuez des opérations de trading en temps réel

Remarque : Les utilisateurs reçoivent un compte démo par défaut lors de l'inscription — vous n'avez pas besoin d'en créer un via l'API avant de trader.

Points de terminaison API

URL de base REST :

1https://api.derivws.com

Points de terminaison 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

L'OTP est obtenu en appelant POST /trading/v1/options/accounts/{accountId}/otp — la réponse contient une URL WebSocket prête à l'emploi avec l'OTP déjà intégré.

Exigences de connexion :

Client compatible WebSocket (navigateur ou côté serveur)
Connexion Internet stable
Deriv-App-ID valide et token Bearer pour les appels REST et la génération OTP

Télécharger les schémas API

Tous les schémas API sont publiés à chaque version de production sous forme de schemas.zip. L'archive contient tous les fichiers JSON Schema WebSocket et la spécification OpenAPI 3.1.0 de l'API REST — prêts pour une utilisation hors ligne, des générateurs de SDK ou des outils client.

Télécharger schemas.zip →

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

Besoin d'une version spécifique ? Chaque version a une URL versionnée au format …/releases/download/{tag}/schemas.zip. Parcourez toutes les versions sur github.com/deriv-com/deriv-api-schemas/releases.

Prochaines étapes

Continuez avec ces guides pour commencer à construire avec Deriv API :

Introduction Authentification

D'autres questions ? Nous contacter