Event-market discovery

Discover currently active event contracts before posting them to POST /portfolios.

Licence requirement

Event-market routes are available only when the requested exchange is enabled on the caller's licence. Unlicensed calls return 403 with EVENT_MARKET_NOT_LICENSED.

GET/validation-reference/events/search

Search markets

GET /validation-reference/events/search accepts exchange, q, and limit. limit defaults to 30 and is capped at 200.

curl -sS "$C9_API_ENDPOINT/validation-reference/events/search?exchange=KALSHI&q=Apple&limit=20" \
  -H "Authorization: Bearer $C9_API_SECRET"
{
  "count": 1,
  "markets": [{
    "ticker": "APPLEUS-29DEC31",
    "label": "Apple DOJ Lawsuit Options - Before 2030",
    "status": "active",
    "expiration_time": "2030-01-01T00:00:00Z",
    "mark_dollars": 0.27
  }]
}
GET/validation-reference/events/contracts

List contracts

GET /validation-reference/events/contracts?exchange=KALSHI returns up to 200 active contracts without a search term. Its contracts rows use the same fields as the search response.

Was this page helpful?