Skip to main content

​
Search never comes back empty

GET /v1/search finds events for free text and labels every result with how it was found, strongest first: Misspellings are replaced by the closest word listings use and reported in corrected_query. An empty q lists what is trending.
“Chiefs” finds Indianapolis vs Kansas City: markets are labeled with the teams, people and places they are about, so a nickname finds a title that never uses it.

​
Plain-language filters

Words that describe a filter are read as one, and removed from what is searched:
searches for dem senate races, keeps markets closing within a month whose leading outcome costs under 30¢, and returns what it understood:
Also understood: a venue name, on both venues, longshots, coin flips, favorites, movers, closing today / this week / this month, and amounts such as over $50k traded. The same filters can be set as parameters (venue, category, cross_venue, closing, price_min, price_max, min_volume, moved), and parameters win over words. With filters on, results can be empty: they are what you asked for.

​
Topics

Every listed event is labeled with the people, teams, places and subjects it is about. GET /v1/topics lists the most common, with their category, what they traded today and their leading event; GET /v1/topics/{slug} returns the events about one, most traded first, with the topics that appear beside it.
GET /v1/markets?q= is a different tool: it searches market titles by spelling similarity and pages by cursor, for when you need individual markets rather than events.