Skip to main content
PUT
/
v1
/
accounts
/
{account_id}
/
watchlist
Create or Update Watchlist
curl --request PUT \
  --url https://api.aries.com/v1/accounts/{account_id}/watchlist \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "name": "Tech Stocks",
    "symbols": [
      "AAPL",
      "GOOGL",
      "MSFT",
      "TSLA",
      "NVDA"
    ]
  },
  {
    "name": "Energy",
    "symbols": [
      "XOM",
      "CVX",
      "COP"
    ]
  }
]
'
{
  "account_id": "ACC123456",
  "watchlist": [
    {
      "id": 1,
      "name": "Tech Stocks",
      "symbols": [
        "AAPL",
        "GOOGL",
        "MSFT",
        "TSLA",
        "NVDA"
      ]
    },
    {
      "id": 3,
      "name": "Energy",
      "symbols": [
        "XOM",
        "CVX",
        "COP"
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
account_id
string
required

The unique identifier of the trading account (must be a valid account owned by the authenticated user)

Body

application/json

Array of watchlist objects to create or update. Each watchlist must have a unique name and a list of stock symbols.

​
name
string
required

Unique name for the watchlist within the account

Example:

"Tech Stocks"

​
symbols
string[]
required

Array of stock ticker symbols to track (must be unique and valid)

Minimum array length: 1
Example:
["AAPL", "GOOGL", "MSFT"]

Response

Watchlist created or updated successfully

​
account_id
string

The trading account identifier

​
watchlist
object[]

Array of watchlists associated with this account