Portfolios

Puts an instrument on this portfolio's watchlist without recording any position. Pass `optionContract` with the OCC symbol to watch an option, or omit it to watch the stock. The instrument is verified against the live reference data before anything is stored, and the priced portfolio then lists it in `watching` with a mark and no economics. Watching an instrument the portfolio already watches answers 400; buying an instrument you watch folds the watch row into the held position rather than showing two rows.

post/v1/portfolios/{id}/watches

Request

Path parameters

idstring uuid required

The portfolio to watch it in, from the portfolio list.

Request body

tickerstring required

Stock ticker, or MIC:TICKER for a listing on another exchange (e.g. XPAR:AIR). For an option, the ticker of the UNDERLYING, as MIC:TICKER for a Canadian contract (e.g. XTSE:RY).

optionContractstring nullable

Optional OCC option symbol, e.g. O:AAPL260116C00250000. When present the contract is verified against the live options data before anything is stored. Omit it to watch the stock.

Response

Created

portfolioIdstring uuid
portfolioNamestring nullable

Changes

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