Wallet REST

Listez les wallets du client authentifié et parcourez les transactions pour chacun d'eux.

Vue d'ensemble

Les API Wallet permettent à une application de lire les wallets du client authentifié et leur historique de transactions. Listez chaque wallet avec ses soldes via le point de terminaison wallets, puis parcourez les mouvements d'un wallet unique via le point de terminaison transactions. Tous les points de terminaison sont des appels REST standard et requièrent la portée OAuth2 payment.

REST API

Ce sont des API REST standard utilisant des méthodes HTTP (GET). Toutes les demandes nécessitent l'en-tête Deriv-App-ID: YOUR_APP_ID et un token Authorization: Bearer YOUR_OAUTH_TOKEN portant la portée payment.

Spécification OpenAPI

Consultez la spécification complète OpenAPI pour les définitions de schéma détaillées et les exemples :

Spéc. OpenAPI →

Flux de travail typique

Listez les wallets du client avec GET /wallet/v1/wallets. Chaque entrée indique ses soldes dans la devise native du wallet ; fournissez conversion_currency pour recevoir également un total converti.
Récupérez les mouvements d'un wallet avec GET /wallet/v1/transactions/{wallet_type}. Les résultats sont paginés par curseur ; suivez links.next et links.prev pour les parcourir.

Points de terminaison disponibles

Liste des WalletsGet

Retourne les wallets appartenant au client authentifié, avec chaque solde affiché dans la devise native du wallet. Indiquez une conversion_currency pour recevoir également chaque solde converti dans cette devise, et utilisez start_date_time et end_date_time pour délimiter la fenêtre de solde./wallet/v1/wallets

Transactions WalletGet

Retourne une liste paginée par curseur des transactions pour l'un des wallets du client authentifié, identifié par wallet_type. Filtrez par request_id, transaction_currency et une plage de dates. Chaque ligne indique un canal montrant comment l'argent a été transféré et une catégorie calculée par rapport à l'appelant./wallet/v1/transactions/{wallet_type}

Authentification

Tous les points de terminaison nécessitent l'en-tête Deriv-App-ID et un en-tête Authorization: Bearer YOUR_OAUTH_TOKEN. Le token doit porter la portée payment ; sinon l'API renvoie 403 Forbidden.

Portées OAuth2

Point de terminaison	Portée
`GET /wallet/v1/wallets`	`payment`
`GET /wallet/v1/transactions/{wallet_type}`	`payment`

1curl -X GET "https://api.derivws.com/wallet/v1/wallets?conversion_currency=USD" \
2  -H "Deriv-App-ID: YOUR_APP_ID" \
3  -H "Authorization: Bearer YOUR_OAUTH_TOKEN"

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

Erreurs 4xx/5xx

400 Bad Request — Paramètres invalides

401 Unauthorized — Authentification invalide ou manquante

403 Forbidden — Le token manque de la portée payment

404 Not Found — Wallet introuvable

500 Internal Server Error — Erreur côté serveur

503 Service Unavailable — Requête rejetée par le disjoncteur de la passerelle

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 enveloppe cohérente avec un tableau errors. Chaque entrée comporte un status numérique, un code lisible par machine et un message lisible par l'humain :

1{
2  "errors": [
3    {
4      "status": 400,
5      "code": "BadRequest",
6      "message": "conversion_currency must be a 3-letter ISO currency code"
7    }
8  ]
9}

Les codes d'erreur incluent : BadRequest, Unauthorized, NotFound, InternalServerError

Statut du retrait Liste des Wallets

D'autres questions ? Nous contacter