Platform Transfer

PostAuth requiredBeta

Moves funds between a wallet and a trading platform account owned by the authenticated client. direction sets which side is debited: from_wallet funds the platform account, to_wallet funds the wallet. When the wallet and the platform account hold different currencies, also send wallet_currency with a quoted exchange_rate and rate_token.

Endpoint

Post/wallet/v1/transfers/platforms

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

Status Codes

200OK - The transfer was executed, with the request_id echoed back.

400Bad request - The transfer breaks a transfer rule, the request_id was already used, or the body failed validation.

401Unauthorized - Missing or invalid Bearer token.

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

429Too many requests - Rate limit exceeded.

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

400Duplicate request ID

{
  "errors": [
    {
      "status": 400,
      "code": "DuplicateRequestID",
      "message": "This request_id has already been used"
    }
  ]
}

400Validation error

{
  "errors": [
    {
      "status": 400,
      "code": "ValidationError",
      "message": "exchange_rate and rate_token are required when wallet_currency differs from currency",
      "field": "exchange_rate"
    }
  ]
}

Authentication Required

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

About Platform Transfer

The POST /wallet/v1/transfers/platforms endpoint: Moves funds between a wallet and a trading platform account owned by the authenticated client. direction sets which side is debited: from_wallet funds the platform account, to_wallet funds the wallet. When the wallet and the platform account hold different currencies, also send wallet_currency with a quoted exchange_rate and rate_token.

Cross-Currency Transfer Account Management

Any other questions? Get in touch