watchlist.add
writeAdd to watchlist
Adds symbols to the watchlist; symbols already present are ignored.
Free with an account. Requires a key or OAuth token with the write scope.
Input
| Field | Type | Description |
|---|---|---|
| symbols* | string[] | Ticker symbols |
* required
Output
Returned under data; every response also carries meta with freshness, as_of and truncated.
| Field | Type | Description |
|---|---|---|
| dry_run* | boolean | True when dry_run was requested: nothing was persisted; other fields show the would-be result |
| symbols* | string[] | Watchlist after this call, in the order symbols were added |
| added* | string[] | Symbols that were not on the list before |
* required
Example request
curl -X POST "https://impliedoptions.com/api/v1/tools/watchlist.add" \
-H "Authorization: Bearer <YOUR_KEY>" \
-H "Content-Type: application/json" \
-d '{
"args": {
"symbols": [
"SPY",
"NVDA"
]
}
}'Rendered result: /performance?tab=watchlist