Alerts API — Price Movement Notifications

Alerts let you define conditions on prediction market prices and receive a notification when those conditions are met. For example, you can set an alert to fire when the probability on “Will BTC reach $100k by 2026?” drops below 0.50, or when the index price divergence spikes above a threshold. Alerts are scoped to your authenticated account.

Authentication

A session JWT or SIWE session cookie is required:

Authorization: Bearer <your_jwt>

Endpoints

Method	Path	Description
`GET`	`/api/v1/alerts`	List all your active alerts
`POST`	`/api/v1/alerts`	Create a new alert
`GET`	`/api/v1/alerts/{id}`	Get a single alert
`PATCH`	`/api/v1/alerts/{id}`	Update alert condition or active state
`DELETE`	`/api/v1/alerts/{id}`	Delete an alert

List alerts

GET https://api.predexy.com/api/v1/alerts

Returns all alerts associated with your account.

Example request

cURL

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

Sample response

{
  "data": [
    {
      "id": "alrt-3fa85f64-0000-0000-0000-000000000001",
      "type": "price_threshold",
      "canonical_question_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "condition": {
        "field": "index_price",
        "operator": "below",
        "value": 0.50
      },
      "is_active": true,
      "created_at": "2026-04-20T08:00:00Z"
    }
  ]
}

Create an alert

POST https://api.predexy.com/api/v1/alerts

Creates a new price movement alert. Attach the alert to a canonical question or a specific platform market.

Request body

string

required

Alert type. Use "price_threshold" to trigger when a price crosses a value.

object

required

Alert condition object. The structure depends on type, but typically includes a field to watch, an operator (above, below, equals), and a value.

string

UUID of the canonical question to watch. Monitors the cross-platform index price.

string

UUID of a specific platform market to watch. Monitors that platform’s price directly.

Example request

cURL

curl -X POST https://api.predexy.com/api/v1/alerts \
  -H "Authorization: Bearer <your_jwt>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "price_threshold",
    "canonical_question_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "condition": {
      "field": "index_price",
      "operator": "below",
      "value": 0.50
    }
  }'

Sample response

{
  "data": {
    "id": "alrt-3fa85f64-0000-0000-0000-000000000001",
    "type": "price_threshold",
    "canonical_question_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "condition": {
      "field": "index_price",
      "operator": "below",
      "value": 0.50
    },
    "is_active": true,
    "created_at": "2026-04-25T15:30:00Z"
  }
}

Update an alert

PATCH https://api.predexy.com/api/v1/alerts/{id}

Update the condition or toggle the active state of an existing alert without deleting and recreating it.

Request body

string

New alert type.

object

Updated condition object.

boolean

Set to false to pause the alert without deleting it.

Use is_active: false to temporarily silence an alert — for example, during a period when you know prices will be volatile and you want to reduce notification noise. Toggle it back to true when you want to resume monitoring.

Overview

Markets & Discovery

Arbitrage

Account

Console

Alerts API — Price Movement Notifications

Authentication

Endpoints

List alerts

Example request

Sample response

Create an alert

Request body

Example request

Sample response

Update an alert

Request body

​Authentication

​Endpoints

​List alerts

​Example request

​Sample response

​Create an alert

​Request body

​Example request

​Sample response

​Update an alert

​Request body

Authentication

Endpoints

List alerts

Example request

Sample response

Create an alert

Request body

Example request

Sample response

Update an alert

Request body