bigdata_get_watchlist

​

Overview

• List mode (no id): returns the watchlists the caller owns, with name and description only. Shared, public, and global watchlists are not included.
• Fetch mode (with id): returns one watchlist the caller can read, including shared watchlists when the ID is known, together with the Knowledge Graph IDs in items.

​

When to Use

• Discovering watchlists: Finding out which watchlists exist before editing, deleting, or analyzing one
• Loading holdings: Retrieving the entity IDs of a watchlist to pass to bigdata_portfolio_tearsheet or to build bigdata_search filters
• Resolving an ID: Turning a watchlist name into the id required by bigdata_edit_watchlist and bigdata_delete_watchlist

​

How It Works

1. List owned watchlists by calling the tool without an id
2. Pick the watchlist by name and take its id
3. Fetch it by calling the tool again with that id to load items
4. Use the returned IDs with other tools, for example a portfolio tearsheet across the whole list

​

Parameters

​

Important Notes

• List mode returns metadata only. Make a second call with an id to get the entity IDs
• List mode only shows watchlists you own. A watchlist shared with you can still be fetched by ID
• Watchlists created in the Bigdata App can hold more than 100 items, and fetch mode returns all of them
• An unknown ID returns an error, for example Watchlist <id> not found

​

Data Returned

{
  "watchlists": [
    {
      "id": "b52f3bc1-95d8-4869-8aa3-a7cbdf31c164",
      "name": "My Portfolio",
      "description": "Imported from Google Sheet portfolio (8 holdings, resolved by ISIN)"
    }
  ]
}

{
  "watchlists": [
    {
      "id": "ea4c5039-6edb-45c1-9c51-37d3ab9689b0",
      "name": "US mega-cap tech",
      "description": "Core large-cap technology holdings",
      "items": ["228D42", "D8442A"]
    }
  ]
}

​

Usage Monitoring

​

Practical Tips

​

From watchlist to analysis

​

Presenting results