Get Watchlist by Name

GET {{baseUrl}}/v2/watchlists:by_name?name=

You can also call GET, PUT, POST and DELETE with watchlist name with another endpoint /v2/watchlists:byname and query parameter name=<watchlistname>, instead of /v2/watchlists/{watchlist_id} endpoints

Returns a watchlist by name

Request Params

KeyDatatypeRequiredDescription
namenull(Required) name of the watchlist

HEADERS

KeyDatatypeRequiredDescription
Acceptstring
Apca-Api-Key-Idstring
Apca-Api-Secret-Keystring

RESPONSES

status: OK

{&quot;id&quot;:&quot;3d4933d1-12d3-4777-af29-40c4f3c50a3d&quot;,&quot;account_id&quot;:&quot;75b4e7d9-3e50-4df9-a8bb-5b6dc5fa7e59&quot;,&quot;created_at&quot;:&quot;2024-03-27T01:58:39.253016Z&quot;,&quot;updated_at&quot;:&quot;2024-03-27T20:46:35.273027Z&quot;,&quot;name&quot;:&quot;us_equity&quot;,&quot;assets&quot;:[{&quot;id&quot;:&quot;bea0f181-afd8-4bd2-9486-85d3fc2f10d7&quot;,&quot;class&quot;:&quot;us_equity&quot;,&quot;exchange&quot;:&quot;NYSE&quot;,&quot;symbol&quot;:&quot;UBER&quot;,&quot;name&quot;:&quot;Uber Technologies, Inc.&quot;,&quot;status&quot;:&quot;active&quot;,&quot;tradable&quot;:true,&quot;marginable&quot;:true,&quot;maintenance_margin_requirement&quot;:0,&quot;shortable&quot;:true,&quot;easy_to_borrow&quot;:true,&quot;fractionable&quot;:true,&quot;attributes&quot;:null},{&quot;id&quot;:&quot;b0b6dd9d-8b9b-48a9-ba46-b9d54906e415&quot;,&quot;class&quot;:&quot;us_equity&quot;,&quot;exchange&quot;:&quot;NASDAQ&quot;,&quot;symbol&quot;:&quot;AAPL&quot;,&quot;name&quot;:&quot;Apple Inc. Common Stock&quot;,&quot;status&quot;:&quot;active&quot;,&quot;tradable&quot;:true,&quot;marginable&quot;:true,&quot;maintenance_margin_requirement&quot;:0,&quot;shortable&quot;:true,&quot;easy_to_borrow&quot;:true,&quot;fractionable&quot;:true,&quot;attributes&quot;:null}]}