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:

not_started: The migration has not yet been initiated.
pending: Migration is in progress. Legacy data is still accessible.
completed: Migration succeeded. The user is fully on the new platform.
failed: Migration encountered an error. Contact support if this persists.

Polling Guidance

You can poll this endpoint to track migration progress. Recommended polling interval is 5–10 seconds. Stop polling once the status reaches completed or failed.

Options Trading (Legacy)Legacy accounts

Any other questions? Get in touch