ALalpacahq
Watchlist

Create a New Watchlist for an Account

Returns the watchlist object

post/v1/trading/accounts/{account_id}/watchlists

Request

  • Base URL
    https://broker-api.giftcity.sandbox.in.alpaca.markets
  • URL
    https://broker-api.giftcity.sandbox.in.alpaca.markets/v1/trading/accounts/{account_id}/watchlists
  • Auth
    HTTP basic

Request body

namestring required

The watchlist name

symbolsstring[] required

The new list of symbol names to watch

Example request

{
  "symbols": [
    "[\"AAPL\", \"TSLA\"]"
  ]
}

Response

Newly created watchlist

account_idstring uuid required

Unique identifier of the account that owns this watchlist.

created_atstring date-time required

When watchlist was created

idstring uuid required

Unique identifier of the watchlist itself.

namestring required

User friendly Name of watchlist

updated_atstring date-time required

When watchlist was last updated

Example response

{
  "assets": [
    {
      "attributes": [
        "ptp_no_exception",
        "ipo"
      ],
      "borrow_status": "easy_to_borrow",
      "exchange": "NASDAQ",
      "fractionable": true,
      "id": "904837e3-3b76-47ec-b432-046db621571b",
      "margin_requirement_long": "100",
      "margin_requirement_short": "30",
      "marginable": true,
      "name": "Apple Inc. Common Stock",
      "shortable": true,
      "status": "active",
      "symbol": "AAPL",
      "tradable": true
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.