Skip to main content
Watchlists let you group canonical questions and platform markets you want to monitor closely. Each watchlist belongs to your authenticated account — whether you signed in with email and password or connected a wallet via SIWE. You can create multiple watchlists to segment different strategies or research topics.

​
Authentication

A session JWT or SIWE session cookie is required for all watchlist endpoints: 
Authorization: Bearer <your_jwt>

​
Endpoints

MethodPathDescription
GET/api/v1/watchlistsList all your watchlists
POST/api/v1/watchlistsCreate a watchlist
GET/api/v1/watchlists/{id}Get a watchlist with its items
PATCH/api/v1/watchlists/{id}Rename a watchlist
DELETE/api/v1/watchlists/{id}Delete a watchlist
POST/api/v1/watchlists/{id}/itemsAdd an item to a watchlist
DELETE/api/v1/watchlists/{watchlist-id}/items/{item-id}Remove an item

​
List watchlists

GET https://api.predexy.com/api/v1/watchlists
Returns all watchlists associated with your account.

​
Example request

cURL
curl https://api.predexy.com/api/v1/watchlists \
  -H "Authorization: Bearer <your_jwt>"

​
Sample response

{
  "data": [
    {
      "id": "wl-3fa85f64-5717-4562-b3fc-000000000001",
      "name": "Crypto Q4",
      "item_count": 12,
      "created_at": "2026-03-10T09:00:00Z"
    },
    {
      "id": "wl-3fa85f64-5717-4562-b3fc-000000000002",
      "name": "US Politics",
      "item_count": 5,
      "created_at": "2026-04-01T12:00:00Z"
    }
  ]
}

​
Create a watchlist

POST https://api.predexy.com/api/v1/watchlists
Creates a new watchlist with the given name.

​
Request body

​
name
string
required
Display name for the watchlist.

​
Example request

cURL
curl -X POST https://api.predexy.com/api/v1/watchlists \
  -H "Authorization: Bearer <your_jwt>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Crypto Q4"}'

​
Sample response

{
  "data": {
    "id": "wl-3fa85f64-5717-4562-b3fc-000000000001",
    "name": "Crypto Q4",
    "item_count": 0,
    "created_at": "2026-04-25T15:00:00Z"
  }
}

​
Add an item to a watchlist

POST https://api.predexy.com/api/v1/watchlists/{id}/items
Adds a canonical question or platform market to the watchlist. You can provide either canonical_question_id, market_id, or both.

​
Request body

​
canonical_question_id
string
UUID of a canonical question to add. Provide this to track a question across all platforms.
​
market_id
string
UUID of a specific platform market to add. Provide this to track a single venue’s listing.
Watchlists are scoped to your authenticated account. If you authenticate via wallet (SIWE), your watchlists are tied to that wallet address. If you authenticate via email, they are tied to your developer account. The two are separate and do not merge.