Prediction Markets API
16 endpoints in this group.
GET /api/prediction-markets/alerts
Alerts
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
state | query | — | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
POST /api/prediction-markets/alerts
Create Alert
Request body: application/json
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
DELETE /api/prediction-markets/alerts/{alert_id}
Remove Alert
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
alert_id | path | integer | required |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
PUT /api/prediction-markets/alerts/{alert_id}
Edit Alert
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
alert_id | path | integer | required |
Request body: application/json
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/prediction-markets/arbitrage
Arbitrage
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
min_edge_bps | query | integer | optional | |
min_similarity | query | number | optional | |
limit | query | integer | optional | |
universe_limit | query | integer | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/prediction-markets/by-symbol/{symbol}
By Symbol
Return prediction markets linked to a ticker. When the prediction-markets
runtime is disabled for a non-admin user, this endpoint returns HTTP 200 with
an empty markets list, disabled: true, and reason: prediction_markets_disabled.
Clients must treat disabled as the canonical disabled-workspace signal, not
as a symbol with no linked contracts; the legacy HTTP 503 detail remains
supported by first-party clients. Enabled responses set disabled: false.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
symbol | path | string | required | |
limit | query | integer | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/prediction-markets/categories
Categories
Responses
| Code | Description |
|---|---|
200 | Successful Response |
GET /api/prediction-markets/feed
Feed
Return the active prediction-market feed.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
provider | query | — | optional | |
category | query | — | optional | |
q | query | — | optional | |
limit | query | integer | optional | |
cursor | query | integer | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/prediction-markets/markets/{market_id}
Market Detail
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
market_id | path | integer | required |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/prediction-markets/markets/{market_id}/history
Market History Endpoint
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
market_id | path | integer | required | |
interval | query | string | optional | |
limit | query | integer | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
POST /api/prediction-markets/poll-now
Poll Now
Admin trigger for a bounded prediction-market poll.
— RBAC dep replaces legacy bare user["role"]=="admin" check.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
limit | query | integer | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/prediction-markets/watchlist
Watchlist
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
folder | query | — | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
POST /api/prediction-markets/watchlist
Add Watchlist
Request body: application/json
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/prediction-markets/watchlist/folders
Watchlist Folders
Responses
| Code | Description |
|---|---|
200 | Successful Response |
DELETE /api/prediction-markets/watchlist/{market_id}
Remove Watchlist
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
market_id | path | integer | required |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
PUT /api/prediction-markets/watchlist/{market_id}
Edit Watchlist
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
market_id | path | integer | required |
Request body: application/json
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |