etoro

eToro Public API

Base URL: https://public-api.etoro.com/api/v1

About

This skill allows to interact with the user's eToro account programatically, including executing trades.

Authentication & Required Headers

Keys (request from the user on install)

• Public API Key: application
• User Key: user account
• Environment: Real Portfolio or Virtual Portfolio (real/demo)

Key generation (user-facing):

1. Log in to eToro.
2. Settings > Trading.
3. Create New Key.
4. Choose Environment (Real or Virtual/Demo) and Permissions (Read or Write).
5. Verify identity and copy the generated User Key.

Headers (every request):

• x-request-id: unique UUID per request
• x-api-key: Public API Key (<PUBLIC_KEY>)
• x-user-key: User Key (<USER_KEY>)

Example:

curl -X GET "https://public-api.etoro.com/api/v1/watchlists" \
  -H "x-request-id: <UUID>" \
  -H "x-api-key: <PUBLIC_KEY>" \
  -H "x-user-key: <USER_KEY>"

Request Conventions

• All paths below are relative to the Base URL (which already includes /api/v1). Example: GET /watchlists means GET https://public-api.etoro.com/api/v1/watchlists.
• Query params go in the URL, path params go in the URL path.
• For query params that are documented as array, send them as comma-separated values (e.g., instrumentIds=1001,1002).
• Pagination patterns vary by endpoint:
  • Search: pageNumber, pageSize
  • People search & trade history: page, pageSize
  • Feeds: take, offset
  • Watchlist items listing: pageNumber, itemsPerPage
• Casing matters for request bodies:
  • Trading execution uses PascalCase fields (e.g., InstrumentID, IsBuy, Leverage).
  • Market close body uses InstrumentId (capital I, lowercase d).
  • Watchlist items use ItemId, ItemType, ItemRank.
  • Feeds post body uses lower camel (owner, message, tags, mentions, attachments).
• Some responses may use different casing for similar concepts (e.g., instrumentId vs InstrumentID). When extracting IDs, handle both if present.