/v4/data/prediction/search

50 credits per API call

Unified search across events, tags and trader profiles. One query returns all three result types in a single response — pick the branches you care about with searchTags and searchProfiles. Designed for discovery surfaces (autocomplete, top-of-page search) where a single query needs to surface the most relevant entities of any kind.

Platform support

• Polymarket only.

Filtering and pagination

• q is the required search string — 2..128 characters. Single-character queries are rejected with 400 because they match an unhelpfully wide slice of the dataset.
• limitPerType caps the number of results returned per branch (events, tags, profiles) — defaults to 10.
• searchTags toggles the tags branch — defaults to true. searchProfiles toggles the profiles branch — defaults to false because most callers don't need it.
• eventsStatus narrows the events branch by a free-text status (e.g. active); eventsTag is a comma-separated list of tag slugs (up to 50 entries). keepClosedMarkets overrides the default behaviour of hiding closed markets from the events branch.
• sort is a free-text sort key forwarded to the upstream; ascending sets sort direction.
• Pagination is page-based (not cursor-based) — advance via ?page=N+1. The response body carries data.pagination.hasMore and data.pagination.totalResults for paging decisions.

Other notes

• Branches are populated independently — an empty tags array means no tag matches were found, not that the search failed.
• events share the same shape as the /events listing endpoint, so the same client-side rendering can be reused.
• profiles rows include only proxyWallet, name and pseudonym — additional profile fields (image, bio) are not exposed here.