GET
/public-searchSearch markets, events, and profiles
- Base URL
- https://gamma-api.polymarket.com
- Auth
- Public, no key
- Rate limit
- 350 req / 10s (35 per second)
- Limit applies to
- /public-search
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | yes | |
| cache | query | boolean | no | |
| events_status | query | string | no | |
| limit_per_type | query | integer | no | |
| page | query | integer | no | |
| events_tag | query | string[] | no | |
| keep_closed_markets | query | integer | no | |
| sort | query | string | no | |
| ascending | query | boolean | no | |
| search_tags | query | boolean | no | |
| search_profiles | query | boolean | no | |
| recurrence | query | string | no | |
| exclude_tag_id | query | integer[] | no | |
| optimized | query | boolean | no |
Example
curl -X GET "https://gamma-api.polymarket.com/public-search?q=<q>"Response fields
| Field | Type | Description |
|---|---|---|
| events | object[] | |
| tags | object[] | |
| profiles | object[] | |
| pagination | object |
Responses
| Status | Meaning |
|---|---|
| 200 | Search results |
From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.