Market search (key optional)

Find Kalshi markets by title or keywords

Find Kalshi markets by title or keywords, the way the KalshiSpy app's search works: fuzzy title matching finds the market series (so a team, a nickname or an approximate title works), and keyword matching runs against market titles. WITHOUT an API key it returns SETTLED WINS ONLY: settled markets where KalshiSpy's roster of ID-verified, high-profit Kalshi traders held the winning side (wins only, never a hit rate). WITH an Elite or Lifetime API key the same call also returns OPEN markets in open_markets: roster positions from the live feed and named traders' recent trades on still-open markets, and it costs 1 unit of the daily quota. Always read data.access: it says which answer you got and, when a key was refused, why; relay that sentence rather than guessing. Call this first whenever the user names a market in words, send the words under the argument name this tool's own schema gives, and cite each market's kalshi_url. An empty list is never evidence that Kalshi has no such market. For more wins, follow settled_wins.more, which carries ready-made search_settled_wins arguments.

get/api/v1/public/markets/search

Request

  • Base URL: https://kalshispy.com
  • URL: https://kalshispy.com/api/v1/public/markets/search
  • Auth: one of:
    • HTTP bearer
    • none

Query parameters

qstring required

Market title or keywords, e.g. "super bowl", "fed rate" or "bitcoin". Terms of 2+ characters, at most 8. Keyword matching ANDs them as substrings of the title, outcome and tickers (settled wins also match the event title); the full text is also fuzzy-matched to market series.

limitinteger

Maximum items in each list (settled wins, roster markets, recently traded markets).

Response

OK

oktrue required

Changes

No recorded changes to this operation across all 1 revision of this API.