Watchlist
The watchlist lets you bookmark prediction events you want to follow. Watched events appear in a dedicated section of your dashboard for quick access.
All watchlist endpoints require authentication.
Viewing Your Watchlist​
GET /api/v1/users/me/watchlist
Returns the list of events you are currently watching, including each event's current status, market prices, and other summary data.
Adding an Event​
POST /api/v1/users/me/watchlist/{event_id}
Adds the specified event to your watchlist. If the event is already in your watchlist, the request is idempotent and returns success.
Path parameters:
| Parameter | Description |
|---|---|
event_id | The UUID of the event to watch. |
Removing an Event​
DELETE /api/v1/users/me/watchlist/{event_id}
Removes the specified event from your watchlist.
Path parameters:
| Parameter | Description |
|---|---|
event_id | The UUID of the event to remove. |
How It Works​
- Adding or removing an event is instant and reflected the next time you fetch your watchlist.
- The watchlist is personal and private -- other users cannot see which events you are watching.
- When viewing event listings with authentication, the API includes a
is_watchedfield so the UI can display the watchlist status inline.
Summary of Endpoints​
| Method | Endpoint | Auth | Description |
|---|---|---|---|
GET | /api/v1/users/me/watchlist | Required | List all watched events |
POST | /api/v1/users/me/watchlist/{event_id} | Required | Add event to watchlist |
DELETE | /api/v1/users/me/watchlist/{event_id} | Required | Remove event from watchlist |