Skip to main content
GET
/
api
/
v1
/
sub-accounts
/
me
/
accounts
Get my sub-accounts
curl --request GET \
  --url https://public-api.etoro.com/api/v1/sub-accounts/me/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "accounts": [
    {
      "subAccountId": "ZXRvcm8tdHJhZGluZw",
      "status": "Approved",
      "providerName": "etoro-trading",
      "accountId": "123456789",
      "accountType": "Trading",
      "accountVisibility": "Visible",
      "accountCurrencies": [
        "USD"
      ],
      "externalUserId": "123456789",
      "additionalData": {
        "gcid": 123456789,
        "realCid": 654321,
        "demoCid": 111222,
        "username": "my-trading-account"
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

eToro OAuth2. Each operation lists the scopes that grant access as separate security requirements (OpenAPI OR semantics): the caller's token only needs ONE of them — you do NOT need all of them. The same scopes back the x-api-key/x-user-key credential pair.

Headers

x-request-id
string<uuid>
required

A unique request identifier.

Example:

"4565b37d-ffd6-4bff-b469-b4fa72cb1118"

x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Response

The authenticated user's sub-accounts (e.g. an etoro-trading account).