Wallet Transactions

GetAuth required

Returns a cursor-paginated list of transactions for one of the authenticated client's wallets, identified by wallet_type. Filter by request_id, transaction_currency, and a date range. Each row carries a channel showing how the money moved and a category computed relative to the caller.

Endpoint

Get/wallet/v1/transactions/{wallet_type}

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

Status Codes

200OK - Cursor-paginated transactions for the requested wallet type.

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": "wallet_type must be one of main, p2p, partner, payment_agent"
    }
  ]
}

404Not found

{
  "errors": [
    {
      "status": 404,
      "code": "NotFound",
      "message": "No wallet of the requested type exists for this client"
    }
  ]
}

Authentication Required

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

About Wallet Transactions

The GET /wallet/v1/transactions/{wallet_type} endpoint: Returns a cursor-paginated list of transactions for one of the authenticated client's wallets, identified by wallet_type. Filter by request_id, transaction_currency, and a date range. Each row carries a channel showing how the money moved and a category computed relative to the caller.

List Wallets Account Management

Any other questions? Get in touch