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.

Endpoint

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

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

Status Codes

200OK - Current migration status (also returned for `pending`, `failed`, and `not_applicable`)

401Unauthorized - Invalid or missing authentication

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. OAuth2 Scope: trade

About legacy_migration_status

The legacy_migration_status endpoint get the current state of the authenticated user's platform upgrade.

Status Values

All known states are returned with HTTP 200:

complete — the user has been fully migrated to the new platform. Their pre-upgrade history is available via the other legacy endpoints.
pending — migration is in progress. The statement and accounts endpoints return HTTP 409 while in this state.
failed — migration was attempted but did not complete. The statement and accounts endpoints return HTTP 409 while in this state.
not_applicable — the user has no legacy data to migrate.

Polling

The response is served with Cache-Control: no-store so polling clients always see the current state. Use this endpoint as a gate before calling the other legacy endpoints.

Options Trading (Legacy)Legacy accounts

Any other questions? Get in touch