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

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:

"03afd656-80ce-453a-bb82-b3c8f5dad2e6"

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

Sub-account created (etoro-trading).