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

Example URI

https://api.livevol.com/v1/watchlist/02fe93a4-76d8-4081-87f7-8f028baf90cd/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": "8b512eec-a764-4734-95f2-349245fb6d7f",
    "name": "default",
    "description": "",
    "symbols": [
      "AAPL",
      "MSFT"
    ]
  },
  {
    "id": "98b5dccd-6c63-4df7-9441-6b14125fd537",
    "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>8b512eec-a764-4734-95f2-349245fb6d7f</id>
    <name>default</name>
    <symbols>
      <symbol>AAPL</symbol>
      <symbol>MSFT</symbol>
    </symbols>
  </watchlist>
  <watchlist>
    <description>My Custom Watchlist</description>
    <id>98b5dccd-6c63-4df7-9441-6b14125fd537</id>
    <name>customWL1</name>
    <symbols>
      <symbol>A</symbol>
    </symbols>
  </watchlist>
</watchlists>