> ## Documentation Index
> Fetch the complete documentation index at: https://finance.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Watchlist

> Create and manage watchlists with the JavaScript SDK

## Overview

The Watchlist API allows you to create, update, and delete watchlists for tracking securities.

## Methods

### getWatchlists(accountId)

```javascript theme={null}
const watchlists = await client.watchlist.getWatchlists('acc_123');
watchlists.forEach(wl => {
  console.log(`${wl.name}: ${wl.symbols.length} symbols`);
});
```

### createWatchlist(accountId, name, symbols)

```javascript theme={null}
const watchlist = await client.watchlist.createWatchlist(
  'acc_123',
  'Tech Stocks',
  ['AAPL', 'GOOGL', 'MSFT']
);
```

### updateWatchlist(watchlistId, symbols)

```javascript theme={null}
await client.watchlist.updateWatchlist('wl_123', symbols);
```

### deleteWatchlist(watchlistId)

```javascript theme={null}
await client.watchlist.deleteWatchlist('wl_123');
```

## Examples

```javascript theme={null}
const wl = await client.watchlist.createWatchlist(
  'acc_123',
  'My Favorites',
  ['AAPL', 'TSLA', 'NVDA']
);

await client.watchlist.updateWatchlist(
  wl.id,
  [...wl.symbols, 'AMD', 'INTC']
);
```
