Watchlist by ID

Retrieves detailed information about a specific watchlist identified by its unique ID, including the watchlist name, symbol list, and metadata. Returns the complete watchlist structure for display and management.

Use Case: Load a specific watchlist’s symbols and settings for display in trading interfaces or portfolio monitoring views.

GET /v1/watchlist/{watchlist_id}

Get Watchlist by ID

cURL

curl --request GET \
  --url https://api.aries.com/v1/watchlist/{watchlist_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": 12345,
  "name": "Tech Stocks",
  "symbols": [
    "AAPL",
    "GOOGL",
    "MSFT",
    "TSLA",
    "NVDA"
  ]
}

Authorizations

Authorization · string · header · required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Path Parameters

watchlist_id · integer<int64> · required

Unique identifier of the watchlist (integer)

Example:

12345

Response

200

application/json

Watchlist retrieved successfully

id · integer<int64>

Watchlist ID

name · string

Watchlist name

symbols · string[]

List of stock symbols in the watchlist