Skip to main content
The Router is a catalog-backed, cross-venue search surface. It searches across the hosted catalog and returns a unified list, sorted by 24h volume. Unlike the venue pass-through (POST /api/:exchange/:method), the Router is GET-based, browser-friendly, and never falls through to a live venue call. It is always served from the Postgres catalog. Pick the shape by the endpoint you hit:
  • GET /v0/events — events with their child markets and outcomes nested inline.
  • GET /v0/markets — flat per-market rows with their outcomes inline.

​
Endpoints

GET https://api.pmxt.dev/v0/events
GET https://api.pmxt.dev/v0/markets
Authorization: Bearer pmxt_live_...

​
Query parameters

ParameterTypeDefaultNotes
querystring—Full-text ILIKE over title and slug.
limitinteger50Max rows, capped at 500.
offsetinteger0Standard pagination offset.
closedbooleanfalseInclude closed / resolved rows.
categorystring—Exact match on normalized category.
exchangestring—Filter to a single venue (polymarket, kalshi, …).

​
Events shape

curl "https://api.pmxt.dev/v0/events?query=election&limit=2" \
  -H "Authorization: Bearer pmxt_live_..."

{
  "data": [
    {
      "id": "e344d660-5e22-411f-b516-ea37a0d9c3cb",
      "title": "2028 US Presidential Election",
      "volume24h": 12345678.9,
      "markets": [
        {
          "marketId": "…",
          "title": "Will Gavin Newsom win?",
          "outcomes": [
            { "label": "Yes", "price": 0.31, "priceChange24h":  0.02 },
            { "label": "No",  "price": 0.69, "priceChange24h": -0.02 }
          ]
        }
      ]
    }
  ],
  "meta": { "count": 2, "limit": 2, "offset": 0 }
}
Exactly the same shape as UnifiedEvent.

​
Markets shape

curl "https://api.pmxt.dev/v0/markets?query=election&limit=3" \
  -H "Authorization: Bearer pmxt_live_..."

{
  "data": [
    {
      "marketId": "d35bc8c6-5602-477d-af21-e9513af9d696",
      "eventId":  "3b6432b6-c956-446e-a7a6-abda14e97aba",
      "title":    "US forces enter Iran by April 30?",
      "volume24h": 89757605.08,
      "outcomes": [
        { "outcomeId": "…", "label": "April 30",     "price": 0.9985, "priceChange24h":  0.002 },
        { "outcomeId": "…", "label": "Not April 30", "price": 0.0015, "priceChange24h":  0.000 }
      ]
    }
  ],
  "meta": { "count": 3, "limit": 3, "offset": 0 }
}

​
Events vs markets

You want…Use
A single answer for a topic with many questionsGET /v0/events
A flat list ranked across all eventsGET /v0/markets
The full venue surface (writes, OHLCV, …)POST /api/:exchange/:method

​
Latency

Typical p95 on a warm catalog: ~10 ms per request, regardless of venue. Cross-venue fan-out that would take 2–5 seconds live is served by a single indexed SQL query against prediction_markets.events + prediction_markets.markets + prediction_markets.outcomes. See Unified Schema for the full rationale.