Read and toggle saved tickers

GET returns the signed-in account’s saved symbols, oldest first (insertion order). POST toggles one ticker on or off and returns the full updated list. Both directions are idempotent, so re-adding a symbol you already hold is a no-op. This list is the cross-device source of truth; the app keeps a localStorage cache for instant UX, then reconciles against this route.

GET, POST /api/watchlist · requires a Privy bearer token, 401 without one. Base URL, rate limits, and error shapes: conventions.

Request body (POST)

Field	Type	Required	Description
symbol	string (1 to 12 chars)	yes	A ticker from the 95-asset catalog. Must match a symbol from GET /api/market, for example AAPL, SPY, SGOV.
on	boolean	yes	true adds, false removes.

Returns

Field	Type	Description
symbols	string[]	Your watched tickers, oldest first. Capped at 300 per account.

Example

# read
curl https://monvera.best/api/watchlist \
  -H "Authorization: Bearer $MONVERA_TOKEN"

# add SPY
curl -X POST https://monvera.best/api/watchlist \
  -H "Authorization: Bearer $MONVERA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"SPY","on":true}'

{ "symbols": ["AAPL", "NVDA", "SPY"] }

Errors

Status	Body	When
400	{"error":"Invalid watchlist change."}	Body fails validation: missing symbol or on, wrong type, or symbol over 12 chars.
400	{"error":"Unknown symbol."}	symbol is not one of the 95 catalog assets.

Notes

The rate limit applies to POST only, counted per account; GET is unmetered. See also alerts and notifications.