Deriv API
Documentation
Configuration Options

Configuration Options REST

Gérez les comptes de trading Options et établissez des connexions WebSocket pour le trading en temps réel.

Vue d'ensemble

Les API Options Setup vous permettent de créer et de gérer des comptes de trading Options à l'aide de points de terminaison REST. Ces points de terminaison gèrent la création de compte, la gestion du solde et la configuration de l'authentification WebSocket.

Flux de travail typique

  1. Créez un compte de trading Options à l'aide de POST /trading/v1/options/accounts.
  2. Demandez une URL WebSocket via POST /trading/v1/options/accounts/{accountId}/otp.
  3. Connectez-vous directement à l'URL WebSocket renvoyée.
  4. Commencez les opérations de trading via la connexion WebSocket.

Points de terminaison disponibles

Obtenir tous les comptesGet
Obtenir tous les comptes de trading Options/trading/v1/options/accounts
Créer un comptePost
Créer un nouveau compte de trading Options/trading/v1/options/accounts
Réinitialiser le solde du compte démoPost
Réinitialiser le solde du compte de démonstration de trading Options/trading/v1/options/accounts/{account_id}/reset-demo-balance
WebSocketsPost
Émet un mot de passe à usage unique (OTP) de courte durée qui authentifie une connexion WebSocket ultérieure pour le compte spécifié. La réponse inclut l'OTP et une URL WebSocket prête à l'emploi avec l'OTP joint en tant que paramètre de requête. L'OTP est valide pendant 120 secondes et ne peut être utilisé qu'une seule fois, alors ouvrez la connexion WebSocket rapidement après avoir appelé ce point de terminaison./trading/v1/options/accounts/{accountId}/otp
Point de terminaison démo WebSocketGet
Met à niveau la connexion vers un WebSocket associé à un compte de trading d'options démo. Nécessite un mot de passe à usage unique (OTP) valide provenant du point de terminaison OTP, transmis en tant que paramètre de requête otp. Utilisez ce canal pour vous abonner aux données de marché, envoyer des instructions de trading et recevoir les mises à jour des ordres et positions du compte démo./trading/v1/options/ws/demo
Point de terminaison réel WebSocketGet
Met à niveau la connexion vers un WebSocket associé à un compte de trading d'options avec de l'argent réel. Nécessite un mot de passe à usage unique (OTP) valide provenant du point de terminaison OTP, transmis en tant que paramètre de requête otp. Les transactions effectuées via ce canal sont réglées sur le solde réel du compte./trading/v1/options/ws/real
Point de terminaison public WebSocketGet
Diffuse en temps réel des données de marché publiques — cotations, ticks et métadonnées de contrats — sans authentification ni OTP requis. Les actions liées au compte, telles que la passation d'ordres ou la consultation des soldes, ne sont pas disponibles sur ce canal./trading/v1/options/ws/public

Authentification

Tous les points de terminaison authentifiés nécessitent l'en-tête Deriv-App-ID et un en-tête Authorization: Bearer YOUR_AUTH_TOKEN.

Portées OAuth2

Point de terminaisonPortée
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"}'

Codes de statut de réponse

L'API utilise des codes de statut HTTP standard pour indiquer le succès ou l'échec :

2xx Succès
200 OK — Demande réussie (compte existant ou OTP généré)
201 Created — Nouvelle ressource créée avec succès
Erreurs 4xx/5xx
400 Bad Request — Paramètres ou corps de demande invalides
401 Unauthorized — Authentification invalide ou manquante
403 Forbidden — Accès refusé
404 Not Found — Ressource introuvable
500 Internal Server Error — Erreur côté serveur
504 Gateway Timeout — Délai d'attente du service en amont

Format de réponse d'erreur

Toutes les réponses d'erreur suivent une structure cohérente avec un tableau d'erreurs et des métadonnées :

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

Les codes d'erreur incluent : ValidationError, FieldIsRequired, Unauthorized, UnauthorizedAccess, AccessDenied, AccountNotFound, BadInputRequest, RateLimit, InternalServerError

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