Watchlists
Store and manage authenticated user watchlists in the StonkTrader database.
Watchlists are StonkTrader-owned business data. Every operation requires either a StonkTrader Bearer token or a signed SIWE session.
List items
curl https://api.stonktrader.finance/watchlist \
-H "Authorization: Bearer $STONKTRADER_ACCESS_TOKEN"Filter by COIN or TRADER when needed:
curl "https://api.stonktrader.finance/watchlist?type=COIN" \
-H "Authorization: Bearer $STONKTRADER_ACCESS_TOKEN"Save an item
POST /watchlist is idempotent for the authenticated user, item type, and
normalized target key. Sending the same key updates its display metadata.
curl https://api.stonktrader.finance/watchlist \
-X POST \
-H "Authorization: Bearer $STONKTRADER_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"type": "COIN",
"targetKey": "NVDA",
"displayName": "NVIDIA"
}'{
"code": 0,
"message": "ok",
"data": {
"id": "8fe62a07-e64a-48c4-a5f4-55cd40b535ba",
"type": "COIN",
"targetKey": "NVDA",
"displayName": "NVIDIA",
"avatarUrl": null,
"createdAt": "2026-08-31T15:30:00.000Z",
"updatedAt": "2026-08-31T15:30:00.000Z"
}
}Delete an item
curl https://api.stonktrader.finance/watchlist/COIN/NVDA \
-X DELETE \
-H "Authorization: Bearer $STONKTRADER_ACCESS_TOKEN"The deletion response contains the removed item. A missing item returns HTTP
404 with application code 1004.
See authentication before integrating these endpoints.