Add or remove tickers

Adds the symbols in add to the tracked set and removes the ones in remove, leaving the rest alone; removals apply first. Every added symbol must be a ticker TradingPal knows and the result must fit the cap, otherwise nothing changes and the error names the offending symbols; names in remove that are not tracked are ignored. Send either list or both. Symbols are upper-cased and duplicates dropped. This also changes the user's Main watchlist on the site. The agent tools add_tickers and remove_tickers call this.

Authentication

Needs a key: send Authorization: Bearer tp_live_… (see Authentication). Counted against the key's limits of 60 requests a minute and 10,000 a day.

Parameters

Request body

The tickers to add and the tickers to remove.

{
  "add": [
    "NVDA"
  ],
  "remove": [
    "AAPL"
  ]
}

Request

curl -X PATCH "https://api.tradingpal.io/api/v1/tickers" \
  -H "Authorization: Bearer $TRADINGPAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"add":["NVDA"],"remove":["AAPL"]}'

Response

JSON. The fields this route adds are below; every response also carries the envelope fields (api_version, as_of_session, data_version, source, disclaimer).

Example response

{
  "api_version": "v1",
  "tickers": [
    {
      "symbol": "NVDA",
      "covered": true
    }
  ],
  "count": 1,
  "cap": 200
}

Errors

Errors are JSON with the Error shape; the fix field says what to do.