Deriv API
Documentation
Options Trading (Legacy)

Legacy Accounts

GetAuth requiredLegacy

List the authenticated user's legacy accounts, grouped by loginid.

Endpoint

Get/trading/v1/options/legacy/accounts

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

Status Codes

200OK - Accounts grouped by loginid
401Unauthorized - Invalid or missing authentication
404Not found - User has no legacy account mapping
409Conflict - User migration is pending or has failed
500Internal server error
503Service temporarily unavailable

Error Responses

404No legacy mapping
{
  "errors": [
    {
      "status": 404,
      "code": "NotFound",
      "message": "User has no legacy account mapping"
    }
  ],
  "meta": {
    "endpoint": "/trading/v1/options/legacy/accounts",
    "method": "GET",
    "timing": 16
  }
}
409Migration pending or failed
{
  "errors": [
    {
      "status": 409,
      "code": "MigrationPending",
      "message": "User migration is pending or has failed"
    }
  ],
  "meta": {
    "endpoint": "/trading/v1/options/legacy/accounts",
    "method": "GET",
    "timing": 19
  }
}

About legacy_accounts

The legacy_accounts endpoint list the authenticated user's legacy accounts, grouped by loginid.

Response Shape

The response is a single loginidsobject keyed by the user's legacy loginids. Each value is an array of accounts owned by that loginid, each with an account_id and currency. Loginids with no resolvable accounts are omitted from the response entirely.

When to Call

Use this endpoint to discover the legacy loginids you can pass to GET /trading/v1/options/legacy/statement. If the user's migration is pending or has failed, the request returns HTTP 409; if the user has no legacy mapping at all, it returns HTTP 404.

Click to open live chat support. Get instant help from our support team.