Deriv API
Documentation
Trading d'options (Legacy)

Trading d'options (Legacy) REST

Accès en lecture seule aux données de trading d'options avant mise à niveau d'un utilisateur migré — relevé historique, comptes hérités et statut de mise à niveau de la plateforme.

Vue d'ensemble

Une fois le compte d'un utilisateur mis à niveau depuis l'ancienne plateforme d'options, ces points de terminaison fournissent son relevé de transactions pré-mise à niveau et la correspondance des comptes afin que l'historique reste accessible. Les trois sont en lecture seule, nécessitent un token OAuth2 avec la portée trade, et sont limités à l'utilisateur appelant. Tant que la migration d'un utilisateur est encore en attente ou a échoué, les points de terminaison de relevé et de comptes renvoient HTTP 409.

Flux de travail typique

  1. Appelez GET /trading/v1/options/legacy/migration-status pour confirmer que la migration de l'utilisateur a atteint complete. Tant que le statut est pending ou failed, les deux autres points de terminaison renvoient HTTP 409.
  2. Listez les loginids et comptes de l'utilisateur avant la mise à niveau via GET /trading/v1/options/legacy/accounts.
  3. Récupérez l'historique des transactions pré-migration par loginid via GET /trading/v1/options/legacy/statement?loginid=..., en paginant avec limit et offset.
  4. Pour toutes les opérations de trading en direct et de compte, continuez à utiliser les points de terminaison standard Options Trading — ces routes héritées ne servent que les données historiques.

Points de terminaison disponibles

Authentification

Tous les points de terminaison de cette section nécessitent l'en-tête Deriv-App-ID et un en-tête Authorization: Bearer YOUR_AUTH_TOKEN avec la portée OAuth2 trade.

Portées OAuth2

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

Codes de statut de réponse

Les codes de statut HTTP standard sont renvoyés. Un code 409 indique que la migration de l'appelant est en attente ou a échoué — ceci est spécifique aux points de terminaison legacy.

2xx Succès
200 OK — Requête réussie. Pour migration-status, tous les états connus (incluant pending, failed, not_applicable) sont renvoyés avec 200.
Erreurs 4xx/5xx
400 Bad Request — Mauvaise saisie (par exemple, loginid mal formé)
404 Not Found — Utilisateur ou compte par défaut introuvable
409 Conflict — La migration de l'utilisateur est en attente ou a échoué
422 Unprocessable Entity — Erreur de validation de la requête
500 Internal Server Error — Erreur côté serveur
503 Service Unavailable — Service temporairement indisponible

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": 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.