Getting Started

Pick how you want to build — then follow the steps.

API Quickstart

Get started in under 5 minutes — keys, first request, done

You're here

AI & MCP Tools

Build with Cursor, Claude Code, or Antigravity

View guide →

No-Code Builders

Ship fast with Base44 or Lovable

View guide →

.md

On this page

Prerequisites
Create account + KYC
Get your API key
Make your first call
Demo vs live
Troubleshooting
Next steps

Prerequisites

Before you call the API, you need one thing:

A verified eToro retail account (KYC completed)

Your API key is tied to your verified eToro account — the same account that gives you access to live markets. This is how eToro keeps API access secure and compliant.

Create account + complete KYC

Sign up

1.Go to etoro.com
2.Create an account or log in to an existing one

Complete identity verification (KYC)

Identity verification (government-issued ID)
Address verification (proof of address, region-dependent)
Basic compliance checks for regulated financial services

How long does it take?

Typical verification takes minutes to a few hours. Manual review may take longer in some cases.

How to know you're approved

Account shows as verified in settings
API Key Management is visible under Settings Trading

Get your API key

Navigate to key management

1.Log in at etoro.com
2.Open Settings
3.Go to Trading
4.Open API Key Management

Your credentials

You need both keys on every authenticated request:

x-api-key

Your Public API Key

x-user-key

Your User Key

You also generate a unique x-request-id (UUID) per request.

Store keys safely

Never hardcode keys in source files or commit them to git. Use environment variables instead.

.env

# .env (do not commit)
ETORO_API_KEY=your_public_api_key
ETORO_USER_KEY=your_user_key

Make your first API call

Pick your language and fetch your default watchlist. All three examples call the same endpoint.

watchlist.mjs

const headers = {
  "x-api-key": process.env.ETORO_API_KEY,
  "x-user-key": process.env.ETORO_USER_KEY,
  "x-request-id": crypto.randomUUID(),
  "Accept": "application/json",
};

const res = await fetch(
  "https://public-api.etoro.com/api/v1/watchlists/default-watchlists/items",
  { headers }
);

if (!res.ok) throw new Error(res.statusText);

const data = await res.json();
console.log(data);

Expected response

response.json

[
  {
    "itemId": 1001,
    "itemType": "Instrument",
    "itemRank": 1,
    "market": {
      "symbolName": "AAPL",
      "displayName": "Apple"
    }
  },
  {
    "itemId": 1002,
    "itemType": "Instrument",
    "itemRank": 2,
    "market": {
      "symbolName": "TSLA",
      "displayName": "Tesla"
    }
  }
]

Success!

If you get HTTP 200 with valid JSON, your auth flow is working. Try changing the endpoint to /trading/info/demo/portfolio to see your demo account data.

Demo account vs live account

Demo Trading API

Mirrors live behavior exactly — same endpoints, same shapes. Uses paper money. Start here.

/trading/info/demo/...

Real Trading API

Real money execution. Use only after your integration is validated in Demo.

/trading/info/real/...

config.py

import os

mode = os.getenv("ETORO_TRADING_MODE", "demo")  # demo | real

if mode == "demo":
    portfolio_path = "/trading/info/demo/portfolio"
else:
    portfolio_path = "/trading/info/real/portfolio"

Troubleshooting

My API key doesn't work

Both x-api-key and x-user-key are present
You didn't swap them
x-request-id is present and unique per request
Your eToro account is verified (KYC complete)
No extra spaces or newlines in copied keys

I'm getting rate limited (HTTP 429)

Back off and retry (exponential backoff)
Add request pacing between calls
Cache repeated market-data reads
Avoid burst loops across many symbols

I can't find the API key in my account

Navigate to: Settings Trading API Key Management

Direct URL: etoro.com/settings/trade

If API Key Management is missing, your account may not be fully verified yet.

KYC verification is taking too long

Check account notifications for missing documents
Confirm uploaded documents are clear and valid
Contact eToro support through in-product help

Next steps

Once your first call works, here's what to explore:

API PlaygroundTry any endpoint live in your browser API ReferenceAll endpoints documented Use CasesWhat you can build Products6 API products API PortalOfficial guides and walkthroughs

Quick checklist

eToro account created
KYC approved (account verified)
x-api-key and x-user-key copied
Keys stored in env vars (not code)
First call to /watchlists/default-watchlists/items succeeds
First call to /trading/info/demo/portfolio succeeds
Demo vs live mode switch implemented

Ready to build?

You're set up. Explore the full API reference or dive into a use case.

Browse API Reference Explore Use Cases

const headers = { "x-api-key": process.env.ETORO_API_KEY, "x-user-key": process.env.ETORO_USER_KEY, "x-request-id": crypto.randomUUID(), "Accept": "application/json", }; const res = await fetch( "https://public-api.etoro.com/api/v1/watchlists/default-watchlists/items", { headers } ); if (!res.ok) throw new Error(res.statusText); const data = await res.json(); console.log(data);

[ { "itemId": 1001, "itemType": "Instrument", "itemRank": 1, "market": { "symbolName": "AAPL", "displayName": "Apple" } }, { "itemId": 1002, "itemType": "Instrument", "itemRank": 2, "market": { "symbolName": "TSLA", "displayName": "Tesla" } } ]

import os mode = os.getenv("ETORO_TRADING_MODE", "demo") # demo | real if mode == "demo": portfolio_path = "/trading/info/demo/portfolio" else: portfolio_path = "/trading/info/real/portfolio"