eToro Identity API
The Identity API from eToro — 1 operation(s) for identity.
The Identity API from eToro — 1 operation(s) for identity.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/etoro:etoro-identity-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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: 3.2.0
info:
title: eToro Identity 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: Identity
paths:
/api/v1/me:
get:
operationId: getMe
tags:
- Identity
summary: Get authenticated user profile
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 profile of the currently authenticated user, including account identifiers (GCID, real and demo CIDs), profile fields from Scope Data API (username, name, player level, gender, language, date of birth, avatar URL), and the OAuth scopes granted to the current access token.'
parameters:
- name: x-request-id
in: header
required: true
schema:
type: string
format: uuid
example: 56682349-4ecd-438f-89df-7109a42eaee1
description: A unique request identifier.
example: 56682349-4ecd-438f-89df-7109a42eaee1
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/meResponse'
examples:
example:
summary: User Profile Response
value:
gcid: 123456
realCid: 789012
demoCid: 345678
username: johndoe
firstName: John
middleName: Q
lastName: Doe
playerLevel: 3
gender: 1
language: 1
dateOfBirth: '1990-01-01'
avatarUrl: https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg
scopes:
- etoro-public:real:read
- etoro-public:user-info:read
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 - Missing or invalid authentication credentials
'403':
description: Forbidden - Insufficient permissions
'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:real:read
- oauth2:
- etoro-public:demo:read
- oauth2:
- etoro-public:real:write
- oauth2:
- etoro-public:demo:write
- oauth2:
- etoro-public:user-info:read
x-ratelimit:
limit: 60
window: 60
shared: true
defaultPool: true
components:
schemas:
meResponse:
type: object
description: Profile of the authenticated user across eToro account types, including granted OAuth scopes.
required:
- gcid
- realCid
- demoCid
- username
- playerLevel
- gender
- language
- dateOfBirth
- scopes
properties:
gcid:
type: integer
description: Global Customer ID - the unique identifier for the user across all eToro systems.
realCid:
type: integer
description: Real account Customer ID - the identifier for the user's real trading account.
demoCid:
type: integer
description: Demo account Customer ID - the identifier for the user's virtual/demo trading account.
username:
type: string
description: The user's unique username.
firstName:
type:
- string
- 'null'
description: The user's first name.
middleName:
type:
- string
- 'null'
description: The user's middle name.
lastName:
type:
- string
- 'null'
description: The user's last name.
playerLevel:
type: integer
description: 'Player level. Possible values: 1 (Bronze), 2 (Platinum), 3 (Gold), 4 (Internal), 5 (Silver), 6 (PlatinumPlus), 7 (Diamond).'
gender:
type: integer
description: 'Gender. Possible values: 0 (Unknown), 1 (Male), 2 (Female).'
language:
type: integer
description: Language ID (e.g. 1 = English, 2 = German).
dateOfBirth:
type: string
description: Date of birth.
avatarUrl:
type:
- string
- 'null'
description: Absolute URL of the user's profile avatar image.
scopes:
type: array
description: OAuth scopes granted to the authenticated token.
items:
type: string
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)