Wallet REST

Enumere los wallets del cliente autenticado y explore las transacciones de cada uno.

Descripción general

Las API de Wallet permiten que una aplicación consulte los wallets del cliente autenticado y su historial de transacciones. Liste todos los wallets con sus saldos a través del endpoint wallets, luego navegue por los movimientos de un wallet específico a través del endpoint transactions. Todos los endpoints son llamadas REST estándar y requieren el alcance OAuth2 de payment.

REST API

Estas son APIs REST estándar que usan métodos HTTP (GET). Todas las solicitudes requieren el encabezado Deriv-App-ID: YOUR_APP_ID y un token Authorization: Bearer YOUR_OAUTH_TOKEN que contenga el alcance payment.

Especificación OpenAPI

Vea la especificación completa de OpenAPI para definiciones de esquema detalladas y ejemplos:

OpenAPI Spec →

Flujo de trabajo típico

Enumere los wallets del cliente con GET /wallet/v1/wallets. Cada entrada contiene sus saldos en la moneda nativa del wallet; proporcione conversion_currency para recibir también un total convertido.
Obtenga los movimientos de un wallet con GET /wallet/v1/transactions/{wallet_type}. Los resultados están paginados por cursor; siga links.next y links.prev para navegar entre ellos.

Endpoints Disponibles

Lista de WalletsGet

Devuelve los wallets pertenecientes al cliente autenticado, con cada saldo mostrado en la moneda nativa del wallet. Proporcione un conversion_currency para recibir también cada saldo convertido a esa moneda, y utilice start_date_time y end_date_time para delimitar el saldo en la ventana de tiempo./wallet/v1/wallets

Transacciones de WalletGet

Devuelve una lista paginada por cursor de transacciones para uno de los wallets del cliente autenticado, identificado por wallet_type. Filtre por request_id, transaction_currency y un rango de fechas. Cada fila contiene un canal que muestra cómo se movió el dinero y una categoría calculada en relación con el solicitante./wallet/v1/transactions/{wallet_type}

Autentificación

Todos los endpoints requieren el encabezado Deriv-App-ID y un encabezado Authorization: Bearer YOUR_OAUTH_TOKEN. El token debe tener el alcance payment; de lo contrario, la API devuelve 403 Forbidden.

Alcances de OAuth2

Endpoint	Alcance
`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"

Códigos de estado de respuesta

La API utiliza códigos de estado HTTP estándar para indicar éxito o fallo:

2xx Éxito

200 OK — Solicitud exitosa

Errores 4xx/5xx

400 Bad Request — Parámetros no válidos

401 Unauthorized — Autenticación no válida o faltante

403 Forbidden — El token carece del alcance payment

404 Not Found — Wallet no encontrado

500 Internal Server Error — Error del lado del servidor

503 Service Unavailable — Solicitud rechazada por el disyuntor del gateway

504 Gateway Timeout — Tiempo de espera del servicio upstream

Formato de respuesta de error

Todas las respuestas de error siguen un formato consistente con un array errors. Cada entrada contiene un status numérico, un code legible por máquina y un message legible por humanos:

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}

Los códigos de error incluyen: BadRequest, Unauthorized, NotFound, InternalServerError

Estado del retiro Lista de Wallets

¿Alguna otra pregunta? Póngase en contacto