/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.