Skip to content

Search

Discovery surfaces for tags and sport filters. Two methods, both public.

Quick reference

Method Endpoint Auth
tags_by_categories() GET /search/tags_by_categories no
filters_by_sport() GET /search/filters_by_sport no

Tags by category

resp = client.search.tags_by_categories()
for category in resp.categories:
    print(category.name, [tag.name for tag in category.tags])

Returns a grouped tag tree for use in UI filters.

Filters by sport

resp = client.search.filters_by_sport()
for sport in resp.sports:
    print(sport.sport, sport.competitions, sport.target_types)

Lists the sports, competitions, and structured-target types available for use as filter inputs in markets / events / structured targets.

Reference

kalshi.resources.search.SearchResource

SearchResource(transport: SyncTransport)

Bases: SyncResource

Sync search/discovery API.

kalshi.resources.search.AsyncSearchResource

AsyncSearchResource(transport: AsyncTransport)

Bases: AsyncResource

Async search/discovery API.