curl --request POST \
--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"
]
}
'import requests
url = "https://api.aries.com/v1/config/watchlist"
payload = {
"name": "Tech Stocks",
"symbols": ["AAPL", "GOOGL", "MSFT"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Tech Stocks', symbols: ['AAPL', 'GOOGL', 'MSFT']})
};
fetch('https://api.aries.com/v1/config/watchlist', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v1/config/watchlist",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Tech Stocks',
'symbols' => [
'AAPL',
'GOOGL',
'MSFT'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v1/config/watchlist"
payload := strings.NewReader("{\n \"name\": \"Tech Stocks\",\n \"symbols\": [\n \"AAPL\",\n \"GOOGL\",\n \"MSFT\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aries.com/v1/config/watchlist")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Tech Stocks\",\n \"symbols\": [\n \"AAPL\",\n \"GOOGL\",\n \"MSFT\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/config/watchlist")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Tech Stocks\",\n \"symbols\": [\n \"AAPL\",\n \"GOOGL\",\n \"MSFT\"\n ]\n}"
response = http.request(request)
puts response.read_bodyCreate Watchlist
Creates a new watchlist for the authenticated user from a name and an optional list of symbols. Submitted symbols are uppercased and checked against the symbol resolver; any that can’t be resolved are dropped from the saved list and returned in the response’s invalid_symbols field instead of failing the request.
Use Case: Let a user save a new named group of symbols, such as a sector list or a set of trade ideas, to monitor going forward.
curl --request POST \
--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"
]
}
'import requests
url = "https://api.aries.com/v1/config/watchlist"
payload = {
"name": "Tech Stocks",
"symbols": ["AAPL", "GOOGL", "MSFT"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Tech Stocks', symbols: ['AAPL', 'GOOGL', 'MSFT']})
};
fetch('https://api.aries.com/v1/config/watchlist', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v1/config/watchlist",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Tech Stocks',
'symbols' => [
'AAPL',
'GOOGL',
'MSFT'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v1/config/watchlist"
payload := strings.NewReader("{\n \"name\": \"Tech Stocks\",\n \"symbols\": [\n \"AAPL\",\n \"GOOGL\",\n \"MSFT\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aries.com/v1/config/watchlist")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Tech Stocks\",\n \"symbols\": [\n \"AAPL\",\n \"GOOGL\",\n \"MSFT\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/config/watchlist")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Tech Stocks\",\n \"symbols\": [\n \"AAPL\",\n \"GOOGL\",\n \"MSFT\"\n ]\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.
Body
Name and initial symbols for the new watchlist. name is required; symbols is optional.
Request body for creating a new watchlist.
User-facing name for the new watchlist, such as Tech Stocks or Dividend Ideas. Must not match the name of another watchlist the user already has (case-sensitive).
1Symbols to save in the new watchlist. Use exact uppercase ticker symbols; symbols that can't be resolved are dropped from the saved list and returned in the response's invalid_symbols field.
["AAPL", "GOOGL", "MSFT"]
Response
Watchlist created. The response contains the saved watchlist; check invalid_symbols for any submitted symbols that were dropped.
Saved list of symbols a user wants to monitor. Watchlists are read-only from a trading-risk perspective and do not place orders.
Watchlist identifier. Use this value when reading, updating, or deleting a specific watchlist.
Symbols from the request that could not be resolved and were dropped from symbols. Only present on create and update responses when at least one submitted symbol failed resolution.
User-facing watchlist name, such as Tech Stocks or Dividend Ideas. Show this as the list label in your app.
Symbols saved in the watchlist. Use exact uppercase ticker symbols and confirm unfamiliar symbols with symbol search. May be null for a watchlist saved through Replace All Watchlists without symbols.
Was this page helpful?