Legacy Accounts
GetAuth requiredLegacy
List the authenticated user's legacy accounts, grouped by loginid.
Temporary endpoint
This endpoint exposes data sourced from the legacy options platform.
Endpoint
Get
/trading/v1/options/legacy/accountsBase 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
}
}Authentication Required
This endpoint requires the
Deriv-App-ID header to identify your application. OAuth2 Scope: tradeAbout 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.
Any other questions? Get in touch