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

Example URI

https://api.livevol.com/v1/watchlist/c774bbb0-9d42-4b1a-9849-d0839a5dccb0/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": "b6b09c78-73e2-4553-ba9e-f6f9ecabb4b9",
    "name": "default",
    "description": "",
    "symbols": [
      "AAPL",
      "MSFT"
    ]
  },
  {
    "id": "e5596b24-21d4-4551-bdbe-97864e2f27b6",
    "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>b6b09c78-73e2-4553-ba9e-f6f9ecabb4b9</id>
    <name>default</name>
    <symbols>
      <symbol>AAPL</symbol>
      <symbol>MSFT</symbol>
    </symbols>
  </watchlist>
  <watchlist>
    <description>My Custom Watchlist</description>
    <id>e5596b24-21d4-4551-bdbe-97864e2f27b6</id>
    <name>customWL1</name>
    <symbols>
      <symbol>A</symbol>
    </symbols>
  </watchlist>
</watchlists>