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"
    ]
  }
]
'
{
  "user_id": 98765,
  "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

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

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 within the array and a list of stock symbols (symbols must be unique within each watchlist). Both name and symbols are required.

​
name
string
required

Unique name for the watchlist within the account. Must be unique among all watchlists in the request array.

Example:

"Tech Stocks"

​
symbols
string[]
required

Array of stock ticker symbols. Symbols must be unique within this watchlist. May be empty.

Example:
["AAPL", "GOOGL", "MSFT"]

Response

Watchlist created or updated successfully

​
user_id
integer<int64>
required

User ID (owner of the watchlists)

​
watchlist
object[]
required

Array of watchlists associated with this account