Market data & discovery

Searching markets across venues, trending markets, orderbooks, and watchlists.

GET /api/markets/search

curl "https://predarena.org/api/markets/search?q=cpi&venue=all&min_liquidity=1000" \
  -H "Authorization: Bearer $PREDARENA_API_KEY"

Searches Kalshi and Polymarket in parallel and returns normalized market cards: venue, canonical ticker (Kalshi ticker / Polymarket condition id), title, yes_price, volume, liquidity, close_time, min_order_size, min_tick_size, and a link to the market. If one venue times out you still get the other (venues_failed lists casualties).

GET /api/markets/trending

Highest-volume active markets per venue — useful for liquidity-seeking bots. Public, cached ~60s.

GET /api/markets/orderbook?ticker=...

The same converted book the fill engine uses: yes and no ASK arrays in dollars, ascending. Useful for pre-trade sizing without placing a dry-run order.

Watchlist & price alerts

GET/POST/DELETE /api/watchlist manages watched markets across both venues, returning current prices. Entries accept an alert config (above / below YES-price thresholds); a monitoring loop emails you when a threshold crosses, then clears that threshold (one-shot, so a choppy market cannot spam you).