eToro Subaccounts API
The Subaccounts API from eToro — 1 operation(s) for subaccounts.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/etoro:etoro-subaccounts-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: eToro Sub Accounts API
version: v1.395.0
description: 'eToro’s public API provides access to real-time financial data, trading insights, and account management features, allowing developers to integrate eToro’s services into their applications. With access to market prices, historical data, and social trading information, the API empowers users to enhance their trading strategies. Designed for security and scalability, the eToro API ensures smooth and reliable integration for a variety of financial applications.
For more details on integrating with eToro''s public WebSocket service, please refer to the dedicated WebSocket documentation.
## Authentication
Every request must be authenticated with exactly one of two options: an OAuth 2.0 access token (`Authorization: Bearer `), or the non-interactive credential pair (`x-api-key` + `x-user-key` headers). The two options are mutually exclusive — a request carrying both is rejected. Each operation lists the OAuth scopes that grant access as alternative security requirements: a bearer token needs only ONE of them, and the same permissions govern the credential pair.'
servers:
- url: https://public-api.etoro.com
description: eToro Public API
security:
- apiKeyAuth: []
userKeyAuth: []
- oauth2: []
tags:
- name: Subaccounts
paths:
/api/v1/sub-accounts/me/accounts:
get:
tags:
- Subaccounts
summary: Get My Sub-Accounts
description: '**Rate limit:** 60 requests per 60 seconds. This is the **default shared quota** — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.
---
Returns the authenticated user''s sub-accounts. Currently the supported provider is `etoro-trading` (eToro trading sub-accounts); additional sub-account providers will be added over time.'
operationId: getMySubAccounts
responses:
'200':
description: The authenticated user's sub-accounts (e.g. an etoro-trading account).
content:
application/json:
example:
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
headers:
RateLimit-Limit:
description: Maximum number of requests allowed per window. This is the default shared pool used by every endpoint without a dedicated limit, so it is NOT per-endpoint — requests across those endpoints all draw from this one budget.
schema:
type: integer
example: 60
RateLimit-Remaining:
description: Requests remaining in the current window for this quota.
schema:
type: integer
RateLimit-Reset:
description: Seconds until the current window resets.
schema:
type: integer
RateLimit-Policy:
description: Quota policy in the form `<limit>;w=<window-seconds>`.
schema:
type: string
example: 60;w=60
'401':
description: Unauthorized
'429':
description: Too Many Requests — the shared rate limit (60 requests / 60s) was exceeded.
headers:
RateLimit-Limit:
description: Maximum number of requests allowed per window. This is the default shared pool used by every endpoint without a dedicated limit, so it is NOT per-endpoint — requests across those endpoints all draw from this one budget.
schema:
type: integer
example: 60
RateLimit-Remaining:
description: Requests remaining in the current window for this quota.
schema:
type: integer
RateLimit-Reset:
description: Seconds until the current window resets.
schema:
type: integer
RateLimit-Policy:
description: Quota policy in the form `<limit>;w=<window-seconds>`.
schema:
type: string
example: 60;w=60
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
example: 60
security:
- apiKeyAuth: []
userKeyAuth: []
- oauth2:
- etoro-public:sub-accounts:read
- oauth2:
- etoro-public:sub-accounts:write
x-ratelimit:
limit: 60
window: 60
shared: true
defaultPool: true
parameters:
- name: x-request-id
in: header
required: true
schema:
type: string
format: uuid
example: c583c224-513b-4762-b092-9927ced2160a
description: A unique request identifier.
example: c583c224-513b-4762-b092-9927ced2160a
post:
tags:
- Subaccounts
summary: Create My Sub-Account
description: '**Rate limit:** 60 requests per 60 seconds. This is the **default shared quota** — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.
---
Creates a sub-account for the authenticated user with the given provider. Currently the supported provider is `etoro-trading` (creates an eToro trading sub-account); additional sub-account providers will be added over time. For `etoro-trading`, `additionalParams.username` is required.'
operationId: createMySubAccount
requestBody:
required: true
content:
application/json:
example:
providerName: etoro-trading
additionalParams:
username: my-trading-account
responses:
'201':
description: Sub-account created (etoro-trading).
content:
application/json:
example:
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
headers:
RateLimit-Limit:
description: Maximum number of requests allowed per window. This is the default shared pool used by every endpoint without a dedicated limit, so it is NOT per-endpoint — requests across those endpoints all draw from this one budget.
schema:
type: integer
example: 60
RateLimit-Remaining:
description: Requests remaining in the current window for this quota.
schema:
type: integer
RateLimit-Reset:
description: Seconds until the current window resets.
schema:
type: integer
RateLimit-Policy:
description: Quota policy in the form `<limit>;w=<window-seconds>`.
schema:
type: string
example: 60;w=60
'202':
description: Sub-account creation accepted and is being processed (etoro-trading).
content:
application/json:
example:
account:
subAccountId: ZXRvcm8tdHJhZGluZw
providerName: etoro-trading
accountId: '123456789'
accountType: Trading
accountVisibility: Visible
accountCurrencies:
- USD
status: Pending
additionalData:
gcid: 123456789
realCid: 654321
demoCid: 111222
username: my-trading-account
authorization: null
headers:
RateLimit-Limit:
description: Maximum number of requests allowed per window. This is the default shared pool used by every endpoint without a dedicated limit, so it is NOT per-endpoint — requests across those endpoints all draw from this one budget.
schema:
type: integer
example: 60
RateLimit-Remaining:
description: Requests remaining in the current window for this quota.
schema:
type: integer
RateLimit-Reset:
description: Seconds until the current window resets.
schema:
type: integer
RateLimit-Policy:
description: Quota policy in the form `<limit>;w=<window-seconds>`.
schema:
type: string
example: 60;w=60
'401':
description: Unauthorized
'409':
description: Conflict - the sub-account already exists
'422':
description: Unprocessable Entity - missing required input (e.g. additionalParams.username for etoro-trading)
'429':
description: Too Many Requests — the shared rate limit (60 requests / 60s) was exceeded.
headers:
RateLimit-Limit:
description: Maximum number of requests allowed per window. This is the default shared pool used by every endpoint without a dedicated limit, so it is NOT per-endpoint — requests across those endpoints all draw from this one budget.
schema:
type: integer
example: 60
RateLimit-Remaining:
description: Requests remaining in the current window for this quota.
schema:
type: integer
RateLimit-Reset:
description: Seconds until the current window resets.
schema:
type: integer
RateLimit-Policy:
description: Quota policy in the form `<limit>;w=<window-seconds>`.
schema:
type: string
example: 60;w=60
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
example: 60
security:
- apiKeyAuth: []
userKeyAuth: []
- oauth2:
- etoro-public:sub-accounts:write
x-ratelimit:
limit: 60
window: 60
shared: true
defaultPool: true
parameters:
- name: x-request-id
in: header
required: true
schema:
type: string
format: uuid
example: 33a7a657-f49a-46a6-9252-c945a7c2a7a8
description: A unique request identifier.
example: 33a7a657-f49a-46a6-9252-c945a7c2a7a8
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: 'API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation''s OAuth scopes describe.
Demo credential for trying the API from these docs: `lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663`'
userKeyAuth:
type: apiKey
in: header
name: x-user-key
description: 'User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.
Demo credential for trying the API from these docs: `eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_`'
oauth2:
type: oauth2
description: 'eToro OAuth2 — send the access token as `Authorization: Bearer <token>`. 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. Mutually exclusive with the x-api-key/x-user-key credential pair: never send both.'
flows:
authorizationCode:
authorizationUrl: https://www.etoro.com/sso
tokenUrl: https://www.etoro.com/api/sso/v1/token
scopes:
etoro-public:agent-portfolio:read: Grants access to the 'etoro-public:agent-portfolio:read' scope.
etoro-public:agent-portfolio:write: Grants access to the 'etoro-public:agent-portfolio:write' scope.
etoro-public:club:read: Grants access to the 'etoro-public:club:read' scope.
etoro-public:demo:read: Grants access to the 'etoro-public:demo:read' scope.
etoro-public:demo:write: Grants access to the 'etoro-public:demo:write' scope.
etoro-public:feed:read: Grants access to the 'etoro-public:feed:read' scope.
etoro-public:feed:write: Grants access to the 'etoro-public:feed:write' scope.
etoro-public:market-data:read: Grants access to the 'etoro-public:market-data:read' scope.
etoro-public:money.balance:read: Grants access to the 'etoro-public:money.balance:read' scope.
etoro-public:money.cash-transactions:read: Grants access to the 'etoro-public:money.cash-transactions:read' scope.
etoro-public:money.transfer:read: Grants access to the 'etoro-public:money.transfer:read' scope.
etoro-public:money.transfer:write: Grants access to the 'etoro-public:money.transfer:write' scope.
etoro-public:money:transfer: Grants access to the 'etoro-public:money:transfer' scope.
etoro-public:notifications:read: Grants access to the 'etoro-public:notifications:read' scope.
etoro-public:notifications:write: Grants access to the 'etoro-public:notifications:write' scope.
etoro-public:pi-data:read: Grants access to the 'etoro-public:pi-data:read' scope.
etoro-public:price-alerts:read: Grants access to the 'etoro-public:price-alerts:read' scope.
etoro-public:price-alerts:write: Grants access to the 'etoro-public:price-alerts:write' scope.
etoro-public:real:read: Grants access to the 'etoro-public:real:read' scope.
etoro-public:real:write: Grants access to the 'etoro-public:real:write' scope.
etoro-public:sso-applications:read: Grants access to the 'etoro-public:sso-applications:read' scope.
etoro-public:sso-applications:write: Grants access to the 'etoro-public:sso-applications:write' scope.
etoro-public:sso-scopes:read: Grants access to the 'etoro-public:sso-scopes:read' scope.
etoro-public:sso-scopes:write: Grants access to the 'etoro-public:sso-scopes:write' scope.
etoro-public:sub-accounts:read: Grants access to the 'etoro-public:sub-accounts:read' scope.
etoro-public:sub-accounts:write: Grants access to the 'etoro-public:sub-accounts:write' scope.
etoro-public:trade.demo:read: Grants access to the 'etoro-public:trade.demo:read' scope.
etoro-public:trade.demo:write: Grants access to the 'etoro-public:trade.demo:write' scope.
etoro-public:trade.real:read: Grants access to the 'etoro-public:trade.real:read' scope.
etoro-public:trade.real:write: Grants access to the 'etoro-public:trade.real:write' scope.
etoro-public:user-info:read: Grants access to the 'etoro-public:user-info:read' scope.
etoro-public:watchlist:read: Grants access to the 'etoro-public:watchlist:read' scope.
etoro-public:watchlist:write: Grants access to the 'etoro-public:watchlist:write' scope.
x-provenance:
method: harvested
publisher: eToro
source: https://builders.etoro.com/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)