Phoenix Prediction Docs

Markets

List, close, and resolve operator-owned markets

Market endpoints operate only on markets owned by the authenticated operator.

List Markets

GET /operator/api/markets

Optional filters:

QueryDescription
statusComma-separated statuses, for example open,closed
series_idOnly markets spawned from a specific series
categoryCategory code
tagsComma-separated tags
qSearch text
limitPage size
cursorCursor from previous page

Response:

{
  "markets": [],
  "next_cursor": null,
  "total": 0
}

Get Market

GET /operator/api/markets/{id}

Returns the market definition, status, timing, outcomes, pricing quantities, and summary stats.

Close Market

POST /operator/api/markets/{id}/close

Closing a market stops further trading.

{ "status": "closed" }

Resolve Market

POST /operator/api/markets/{id}/resolve

Body:

{
  "outcome": "yes",
  "evidence": {
    "source": "operator",
    "url": "https://example.com/result"
  }
}

Resolution and local Phoenix settlement are atomic. A successful response means Phoenix has settled the market and queued wallet credit notifications.

{
  "status": "settled",
  "outcome": "yes"
}

On this page