curl --request PUT \
--url https://api.aries.com/v1/config/watchlist \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"name": "Tech Stocks",
"symbols": [
"AAPL",
"GOOGL",
"MSFT"
]
},
{
"name": "Finance",
"symbols": [
"JPM",
"BAC",
"GS"
]
}
]
'{
"user_id": 98765,
"watchlist": [
{
"id": 12345,
"name": "Tech Stocks",
"symbols": [
"AAPL",
"GOOGL",
"MSFT"
]
},
{
"id": 12347,
"name": "Finance",
"symbols": [
"JPM",
"BAC",
"GS"
]
}
]
}Replace All Watchlists
Replaces the authenticated user’s entire set of watchlists in a single call. Send the full desired list as an array: entries matching an existing watchlist by name are updated in place, entries with a new name are created, and any existing watchlist not present in the array is removed (or reset to a default empty state if it’s the user’s last remaining watchlist). Unlike create and update, symbols sent here are stored as-is and are not checked against the symbol resolver.
Use Case: Sync a user’s complete watchlist set in one request, such as when restoring watchlists from a backup or applying a bulk edit made in a client-side editor.
curl --request PUT \
--url https://api.aries.com/v1/config/watchlist \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"name": "Tech Stocks",
"symbols": [
"AAPL",
"GOOGL",
"MSFT"
]
},
{
"name": "Finance",
"symbols": [
"JPM",
"BAC",
"GS"
]
}
]
'{
"user_id": 98765,
"watchlist": [
{
"id": 12345,
"name": "Tech Stocks",
"symbols": [
"AAPL",
"GOOGL",
"MSFT"
]
},
{
"id": 12347,
"name": "Finance",
"symbols": [
"JPM",
"BAC",
"GS"
]
}
]
}Authorizations
OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.
Body
The complete desired set of watchlists. Each entry's name must be unique within the array, and symbols must not contain duplicates within an entry.
Unique user-facing name for the watchlist. Enter a short label the user will recognize.
1Stock symbols to include. Enter exact uppercase symbols and avoid duplicates. Unlike create/update, symbols here are stored as-is and are not validated against the symbol resolver.
["AAPL", "GOOGL", "MSFT"]
Response
The full, resulting set of watchlists after the replace, in request order. Sending an empty array resets the user to a single new "Default" watchlist with no symbols.
Was this page helpful?