Search Polymarket
Search Polymarket events, tags and profiles by keyword.
Headers
Get your API keyAPI key (`sfk_...`)
Search text. The index is English: other scripts return nothing.
min 1 chars · max 200 chars
What to search, comma separated: `events`, `tags`, `profiles`. Default: `events,tags`.
any of: events, tags, profiles (comma-separated)
Page number, 1–100. Default: 1. Polymarket can stop a deep page early and report `hasMore: false`.
≥ 1 · ≤ 100
Items per page, 1–50. Default: 10.
≥ 1 · ≤ 50
Translate titles and market questions into this language. Descriptions stay in English.
one of: es, fr, de, ja, zh, ko, ru, hi, th, tr, vi, pt, it, pl, id, bn, uk, zh-hant, tl
Endpoint-specific response payload.
`found` when the search ran. No hits is an empty list.
one of: found, not_found
The search text.
Matching events.
Event id.
Event slug, as in polymarket.com/event/{slug}.
Link to the event on polymarket.com.
Event title.
Event description and resolution rules.
Polymarket's own state: `open`, `closed` or `inactive`. An open event or market can carry an end date in the past.
one of: open, closed, inactive
Whether Polymarket archived the event.
Whether Polymarket features the event.
Image URL.
Icon URL.
When the event starts (ISO-8601, UTC).
Scheduled end (ISO-8601, UTC).
When the event closed (ISO-8601, UTC).
When the event was created (ISO-8601, UTC).
When the event was last changed (ISO-8601, UTC).
Traded volume in US dollars over several windows.
All-time traded volume in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 24 hours. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 7 days. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 30 days. A number, or an exact decimal string when the value has more digits than a number can hold.
Volume in the last 365 days. A number, or an exact decimal string when the value has more digits than a number can hold.
Current liquidity in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Value of all open positions in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Number of comments.
How close the leading outcomes are, 0 to 1.
Whether the markets form a winner-takes-all group whose prices sum to about 100 percent.
Whether a user rather than Polymarket created it.
Where the outcome is decided.
Extra details Polymarket attaches to some events.
For an up-or-down market: the price the outcome is measured against.
For an up-or-down market: the price it settled at.
Game id of a sports event.
League or competition.
Tier of the league.
Tournament or stage.
When the event was first scheduled to start (ISO-8601, UTC).
Number of markets in the event.
Topic tags.
Tag id.
Tag name, for example `Politics`.
Tag slug.
When the tag was created (ISO-8601, UTC).
When the tag was last changed (ISO-8601, UTC).
Series the event belongs to.
Series id.
Series slug.
Series title.
Game details on a sports event.
Game id.
League code, for example `lal`.
League name.
Current score, for example `1-0`.
Current period of the game.
Elapsed game time.
Whether the game is in play.
Whether the game has ended.
Kickoff (ISO-8601, UTC).
Week of the season.
The teams playing.
Team id.
Team name.
Short code.
Win-loss record.
Logo URL.
`home` or `away`.
The event's markets, headline numbers only.
Market id.
Market slug.
The question the market asks.
Condition id.
Polymarket's own state: `open`, `closed` or `inactive`. An open event or market can carry an end date in the past.
one of: open, closed, inactive
Label inside a multi-market event.
Outcomes with their current prices.
Outcome name, for example `Yes`.
Outcome token id, used for order books, prices and price history. A decimal string.
Current price as a probability between 0 and 1. Null when the market is not trading.
Price of the last trade.
Highest buy price on the book.
Lowest sell price on the book.
All-time traded volume in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Current liquidity in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Matching tags.
Tag id.
Tag name, for example `Politics`.
Tag slug.
When the tag was created (ISO-8601, UTC).
When the tag was last changed (ISO-8601, UTC).
Matching profiles.
Wallet address.
Chosen username, as Polymarket sends it. Present even when the holder does not show it on their own profile (see `usernamePublic`).
Whether the holder shows the chosen username publicly on their profile.
Auto-generated name.
Profile image URL.
Matching events across all pages.
Pagination state for the current page.
Current page number (1-based).
≥ 0
Whether another page is available.
Next page number when more pages exist; null on the last page.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/polymarket/search?query=election" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket search.