< API Reference
PUT
/watchlist/{id}/symbols
None
Add symbols to a watchlist

Example URI

https://sandbox.livevol.com/api/v1/watchlist/0da948e1-2fa9-4ff4-9545-e2cb7df9d03d/symbols

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

Watchlist Id

globally unique identifier

Required

Body Parameters

SymbolsParams

NameDescriptionTypeAdditional information
symbols

Symbols collection

Collection of string

None.

Request Formats

application/json, text/json

Sample:
{
  "symbols": [
    "AAPL",
    "MSFT"
  ]
}

application/xml, text/xml

Sample:
<watchlist xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <symbols>
    <symbol>AAPL</symbol>
    <symbol>MSFT</symbol>
  </symbols>
</watchlist>

Response Information

Resource Description

Collection of WatchlistResult

NameDescriptionTypeAdditional information
id

Watchlist Id

globally unique identifier

None.

name

A watchlist name

string

None.

description

A watchlist description

string

None.

symbols

Symbols collection in current watchlist

Collection of string

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "id": "d72cb0a8-4186-4d5f-9ec7-20b37d0e5442",
    "name": "default",
    "description": "",
    "symbols": [
      "AAPL",
      "MSFT"
    ]
  },
  {
    "id": "147ae24a-6e3b-4982-8f86-e74a7c439d3b",
    "name": "customWL1",
    "description": "My Custom Watchlist",
    "symbols": [
      "A"
    ]
  }
]

application/xml, text/xml

Sample:
<watchlists xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <watchlist>
    <description></description>
    <id>d72cb0a8-4186-4d5f-9ec7-20b37d0e5442</id>
    <name>default</name>
    <symbols>
      <symbol>AAPL</symbol>
      <symbol>MSFT</symbol>
    </symbols>
  </watchlist>
  <watchlist>
    <description>My Custom Watchlist</description>
    <id>147ae24a-6e3b-4982-8f86-e74a7c439d3b</id>
    <name>customWL1</name>
    <symbols>
      <symbol>A</symbol>
    </symbols>
  </watchlist>
</watchlists>