Migration Status

GetAuth requiredLegacy

Get the current state of the authenticated user's platform upgrade.

Temporary endpoint

This endpoint exposes data sourced from the legacy options platform. It will be removed once all users have been fully migrated to the new platform.

Endpoint

Get/trading/v1/options/legacy/migration-status

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

Status Codes

200OK - Current migration status (pending, complete, failed, or not applicable). The response always includes a Cache-Control: no-store header, so polling clients always see fresh state.

500Internal server error

503Service temporarily unavailable

Error Responses

500Internal server error

{
  "errors": [
    {
      "status": 500,
      "code": "InternalServerError",
      "message": "An internal error occurred"
    }
  ],
  "meta": {
    "endpoint": "/trading/v1/options/legacy/migration-status",
    "method": "GET",
    "timing": 9
  }
}

Authentication Required

This endpoint requires the Deriv-App-ID header to identify your application, plus a valid OAuth2 Bearer token. OAuth2 Scope: trade

About Migration Status

The GET /trading/v1/options/legacy/migration-status endpoint: Get the current state of the authenticated user's platform upgrade.

Migration States

The response includes a status field that reflects the current stage of the user's platform upgrade. Every state below is a normal answer returned with 200, not an error condition:

pending: Migration is in progress.
complete: Migration is complete.
failed: Migration failed.
not_applicable: There's nothing to migrate — this account never had legacy platform data.

Polling Guidance

You can poll this endpoint to track migration progress. Responses are returned with Cache-Control: no-store, so every poll sees fresh state.

Options Trading (Legacy)Legacy accounts

Any other questions? Get in touch