# Watchlists

## Watchlists

*Create and manage watchlists*

Create, read, update, and delete watchlists; add or remove instruments; set defaults and rename lists — everything needed for screeners, alerts, and personalized home screens.

### What it provides

- List, create, rename, and delete user watchlists with full CRUD operations
- Add, remove, or replace instruments on any list in a single request
- Set a default watchlist that surfaces first across your app's entry points
- Support curated and public list patterns for discovery-oriented experiences
- Batch operations for managing large symbol sets efficiently

### What you can build

- Custom watchlists synced across web and mobile clients with real-time price overlays
- Alert engines that monitor a user-defined symbol set for price or volume triggers
- Research workspaces with multiple named lists — sectors, themes, earning plays
- Onboarding flows that pre-populate watchlists based on user interests or risk profile

### Builder journeys

- Personal investing
- Build apps & automations

### Recommended tools

- [REST Playground](/playground) — Create, update, and query watchlists interactively in the API explorer.
- [Getting started](/learn/getting-started-with-etoro-api-v2) — API keys, first request, and understanding eToro response formats.

### Code examples

#### cURL

```bash
curl https://public-api.etoro.com/api/v1/watchlists \
  -H "x-api-key: $ETORO_API_KEY" \
  -H "x-user-key: $ETORO_USER_KEY" \
  -H "x-request-id: $(uuidgen)"
```

#### JavaScript

```javascript
const res = await fetch(
  "https://public-api.etoro.com/api/v1/watchlists",
  {
    headers: {
      "x-api-key": process.env.ETORO_API_KEY,
      "x-user-key": process.env.ETORO_USER_KEY,
      "x-request-id": crypto.randomUUID(),
    },
  }
);

const { watchlists } = await res.json();
for (const list of watchlists) {
  console.log(`${list.name}: ${list.instruments.length} instruments`);
}
```


### Learn & docs

- [Getting Started with the eToro API](/learn/getting-started-with-etoro-api-v2) — Keys, headers, and first successful calls.
- [Managing Watchlists at Scale](/blog/managing-watchlists-at-scale) — Bulk operations and organizational patterns.