List Wallets

GetAuth required

Returns the wallets belonging to the authenticated client, with each balance shown in the wallet's native currency. Supply a conversion_currency to also receive each balance converted into that currency, and use start_date_time and end_date_time to bound the balance as of window.

Endpoint

Get/wallet/v1/wallets

Base URL: https://api.derivws.com

Status Codes

200OK - Wallets for the authenticated client, with balances in native currencies and optional conversion.

400Bad request - errors[0].code will be BadRequest.

401Unauthorized - Missing or invalid Bearer token.

403Forbidden - Valid token but insufficient scope (payment scope required).

404Not found - errors[0].code will be NotFound.

500Internal server error - errors[0].code will be InternalServerError.

503Service unavailable - Request rejected by the gateway circuit breaker.

504Gateway timeout - The service did not respond in time.

Error Responses

400Bad request

{
  "errors": [
    {
      "status": 400,
      "code": "BadRequest",
      "message": "conversion_currency must be a 3-letter ISO currency code"
    }
  ]
}

403Forbidden - insufficient scope

{
  "errors": [
    {
      "status": 403,
      "code": "Unauthorized",
      "message": "The payment scope is required for this endpoint"
    }
  ]
}

Authentication Required

This endpoint requires the Deriv-App-ID header to identify your application. OAuth2 Scope: payment

About List Wallets

The GET /wallet/v1/wallets endpoint: Returns the wallets belonging to the authenticated client, with each balance shown in the wallet's native currency. Supply a conversion_currency to also receive each balance converted into that currency, and use start_date_time and end_date_time to bound the balance as of window.

Wallet Wallet Transactions

Any other questions? Get in touch