API Reference
Use Crawlora's Polymarket API endpoints to extract supported public Polymarket data as structured JSON. This documentation covers 65 active endpoints including List Polymarket activity trades, Get Polymarket CLOB market, List Polymarket macro dashboard events, Polymarket data followers, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as condition_id, address, slug, id, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/polymarket/search?q=coffee&limit=10&status=open&sort=relevance&ascending=true&include_tags=true&include_profiles=true" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/polymarket/activity/tradesapiKey0 credits/requestReturns normalized public trade rows used by Polymarket's `/activity` page from credential-free Data API trades JSON. The `taker_only` enum accepts `true` and `false`; the `filter_type` enum accepts `CASH`; the `filter_amount` enum accepts `1`, `5`, `10`, `100`, `1000`, `10000`, and `100000`.
Required params: None
/polymarket/clob/market/{condition_id}apiKey0 credits/requestReturns one public CLOB market detail row by market condition id, including tokens, reward settings, order acceptance state, tags, and fees.
Required params: condition_id:path
/polymarket/dashboards/macroapiKey0 credits/requestReturns normalized macroeconomic event rows for Polymarket's `/dashboards/macro` page using credential-free Gamma `events/keyset` JSON with the `macro` tag.
Required params: None
/polymarket/data/followers/{address}apiKey0 credits/requestReturns public follower rows for one Polymarket address from Gamma v1 data JSON.
Required params: address:path
/polymarket/data/following/{address}apiKey0 credits/requestReturns public following rows for one Polymarket address from Gamma v1 data JSON.
Required params: address:path
/polymarket/data/follows/counts/{address}apiKey0 credits/requestReturns public follower and following counts for one Polymarket address from Gamma v1 data JSON.
Required params: address:path
/polymarket/event/{slug}apiKey0 credits/requestReturns one normalized Polymarket event from credential-free public Gamma event JSON. This endpoint does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: slug:path
/polymarket/event/{slug}/activityapiKey0 credits/requestReturns normalized public trade rows for one Polymarket event from credential-free Data API trades JSON. The `taker_only` enum accepts `true` and `false`; the `filter_type` enum accepts `CASH`; the `filter_amount` enum accepts `1`, `5`, `10`, `100`, `1000`, `10000`, and `100000`. This endpoint does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: slug:path
/polymarket/event/id/{id}apiKey0 credits/requestReturns one normalized Polymarket event from credential-free public Gamma event JSON. This endpoint does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: id:path
/polymarket/event/id/{id}/activityapiKey0 credits/requestReturns normalized public trade rows for one Polymarket event from credential-free Data API trades JSON. The `taker_only` enum accepts `true` and `false`; the `filter_type` enum accepts `CASH`; the `filter_amount` enum accepts `1`, `5`, `10`, `100`, `1000`, `10000`, and `100000`. This endpoint does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: id:path
/polymarket/eventsapiKey0 credits/requestReturns normalized event rows from Polymarket's credential-free public Gamma events JSON.
Required params: None
/polymarket/events/{id}/tagsapiKey0 credits/requestReturns normalized tag rows attached to one Polymarket event id.
Required params: id:path
/polymarket/events/similarapiKey0 credits/requestReturns normalized similar events from Polymarket's credential-free public Gamma events/similar JSON.
Required params: None
/polymarket/fee-typesapiKey0 credits/requestReturns public fee type data from Polymarket Gamma. This is a normalized wrapper around credential-free public JSON.
Required params: None
/polymarket/gamesapiKey0 credits/requestReturns public game rows from Polymarket Gamma.
Required params: None
/polymarket/homepage/feedapiKey0 credits/requestReturns normalized rows for Polymarket homepage feeds discovered from the public web app and backed by credential-free Gamma JSON. The `feed` enum accepts `trending`, `breaking`, `new`, `politics`, `sports`, `crypto`, `esports`, `iran`, `finance`, `geopolitics`, `tech`, `culture`, `economy`, `weather`, `mentions`, and `elections`. Most feeds return events from Gamma `events/keyset`; `breaking` returns high-movement market rows and `mentions` returns open event search matches.
Required params: None
/polymarket/leaderboardapiKey0 credits/requestReturns normalized trader leaderboard rows from Polymarket's credential-free Data API leaderboard JSON. The `window` enum accepts `1d`, `7d`, `30d`, and `all`; the `sort_by` enum accepts `profit` and `volume`.
Required params: None
/polymarket/market-clarificationsapiKey0 credits/requestReturns public market clarification rows from Polymarket Gamma.
Required params: None
/polymarket/market/{id}apiKey0 credits/requestReturns one normalized Polymarket market from credential-free public Gamma market JSON. This endpoint does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: id:path
/polymarket/market/{id}/liquidityapiKey0 credits/requestReturns a public market liquidity snapshot that joins Gamma market detail with credential-free public CLOB market-data reads when token ids are available. This endpoint is not a trading endpoint and does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: id:path
/polymarket/market/{id}/tagsapiKey0 credits/requestReturns normalized tag rows attached to one Polymarket market id.
Required params: id:path
/polymarket/market/condition/{condition_id}apiKey0 credits/requestReturns one normalized Polymarket market from credential-free public Gamma market JSON by condition id. This endpoint does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: condition_id:path
/polymarket/market/condition/{condition_id}/activityapiKey0 credits/requestReturns normalized public trade rows for one Polymarket market condition id from credential-free Data API trades JSON. The `taker_only` enum accepts `true` and `false`; the `filter_type` enum accepts `CASH`; the `filter_amount` enum accepts `1`, `5`, `10`, `100`, `1000`, `10000`, and `100000`. This endpoint does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: condition_id:path
/polymarket/market/condition/{condition_id}/liquidityapiKey0 credits/requestReturns a public market liquidity snapshot that joins Gamma market detail with credential-free public CLOB market-data reads when token ids are available. This endpoint is not a trading endpoint and does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: condition_id:path
/polymarket/market/slug/{slug}apiKey0 credits/requestReturns one normalized Polymarket market from credential-free public Gamma market JSON. This endpoint does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: slug:path
/polymarket/market/slug/{slug}/liquidityapiKey0 credits/requestReturns a public market liquidity snapshot that joins Gamma market detail with credential-free public CLOB market-data reads when token ids are available. This endpoint is not a trading endpoint and does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: slug:path
/polymarket/marketsapiKey0 credits/requestReturns normalized market rows from Polymarket's credential-free public Gamma markets JSON.
Required params: None
/polymarket/predictionsapiKey0 credits/requestReturns normalized event rows for the Polymarket `/predictions` page using credential-free Gamma `events/keyset` JSON. The `status` enum accepts `active`, `resolved`, and `all`; the `sort` enum accepts `competitive`, `volume`, `volume_24hr`, `ending_soon`, `liquidity`, `newest`, and `closed_time`; the `recurrence` enum accepts `hourly`, `daily`, `weekly`, `monthly`, and `yearly`.
Required params: None
/polymarket/rewards/market/{condition_id}apiKey0 credits/requestReturns one public rewards-market row from Polymarket CLOB rewards JSON by market condition id.
Required params: condition_id:path
/polymarket/rewards/marketsapiKey0 credits/requestReturns normalized public rewards-market rows used by Polymarket's `/rewards` page. The `order_by` enum accepts `market`, `earnings`, `max_spread`, `min_size`, `rate_per_day`, `price`, `earning_percentage`, and `spread`; the `position` enum accepts `asc` and `desc`; the `tag_slug` enum accepts `all`, `politics`, `sports`, `crypto`, `pop-culture`, `middle-east`, `business`, and `science`.
Required params: None
/polymarket/searchapiKey0 credits/requestSearches Polymarket's credential-free public search JSON and returns normalized event results. The `status` enum accepts `open`, `closed`, and `all`; the `sort` enum accepts `relevance`, `volume24hr`, `volume`, `liquidity`, and `endDate`.
Required params: q:query
/polymarket/sportsapiKey0 credits/requestReturns public sports reference data from Polymarket Gamma.
Required params: None
/polymarket/sports/{id}apiKey0 credits/requestReturns public sport detail data from Polymarket Gamma.
Required params: id:path
/polymarket/sports/{id}/external-partnersapiKey0 credits/requestReturns public external partner data for one sport from Polymarket Gamma.
Required params: id:path
/polymarket/sports/{id}/external-partners/{partner_ref}apiKey0 credits/requestReturns public external partner data for one sport partner reference from Polymarket Gamma.
Required params: id:path, partner_ref:path
/polymarket/sports/by-partnerapiKey0 credits/requestReturns public sports reference data from Polymarket Gamma filtered by partner identifiers.
Required params: None
/polymarket/sports/market-typesapiKey0 credits/requestReturns public sports market type reference data from Polymarket Gamma.
Required params: None
/polymarket/sports/summaryapiKey0 credits/requestReturns public sports summary data from Polymarket Gamma.
Required params: None
/polymarket/spotlightsapiKey0 credits/requestReturns public spotlight data from Polymarket Gamma.
Required params: None
/polymarket/spotlights/{slug}apiKey0 credits/requestReturns public spotlight detail data from Polymarket Gamma.
Required params: slug:path
/polymarket/spotlights/keysetapiKey0 credits/requestReturns public spotlight keyset data from Polymarket Gamma.
Required params: None
/polymarket/statusapiKey0 credits/requestReturns public Polymarket Gamma status data.
Required params: None
/polymarket/tag/{id}apiKey0 credits/requestReturns one normalized Polymarket tag from credential-free public Gamma tag JSON.
Required params: id:path
/polymarket/tag/{id}/related-tagsapiKey0 credits/requestReturns normalized related tag rows from Polymarket's credential-free public Gamma related-tags JSON.
Required params: id:path
/polymarket/tag/{id}/related-tags/tagsapiKey0 credits/requestReturns normalized related tag rows from Polymarket's credential-free public Gamma related-tags/tags JSON.
Required params: id:path
/polymarket/tag/slug/{slug}apiKey0 credits/requestReturns one normalized Polymarket tag from credential-free public Gamma tag JSON.
Required params: slug:path
/polymarket/tag/slug/{slug}/related-tagsapiKey0 credits/requestReturns normalized related tag rows from Polymarket's credential-free public Gamma related-tags JSON.
Required params: slug:path
/polymarket/tag/slug/{slug}/related-tags/tagsapiKey0 credits/requestReturns normalized related tag rows from Polymarket's credential-free public Gamma related-tags/tags JSON.
Required params: slug:path
/polymarket/tagsapiKey0 credits/requestReturns normalized tag rows from Polymarket's credential-free public Gamma tags JSON.
Required params: None
/polymarket/teamsapiKey0 credits/requestReturns public team reference data from Polymarket Gamma.
Required params: None
/polymarket/teams/{id}apiKey0 credits/requestReturns public team detail data from Polymarket Gamma.
Required params: id:path
/polymarket/teams/{id}/external-partnersapiKey0 credits/requestReturns public external partner data for one team from Polymarket Gamma.
Required params: id:path
/polymarket/teams/{id}/external-partners/{partner_ref}apiKey0 credits/requestReturns public external partner data for one team partner reference from Polymarket Gamma.
Required params: id:path, partner_ref:path
/polymarket/teams/by-partnerapiKey0 credits/requestReturns public team reference data from Polymarket Gamma filtered by partner identifiers.
Required params: None
/polymarket/token/{token_id}/midpointapiKey0 credits/requestReturns the public CLOB midpoint for one Polymarket token id.
Required params: token_id:path
/polymarket/token/{token_id}/orderbookapiKey0 credits/requestReturns public CLOB order-book depth for one Polymarket token id.
Required params: token_id:path
/polymarket/token/{token_id}/price-historyapiKey0 credits/requestReturns public CLOB price-history points for one Polymarket token id.
Required params: token_id:path
/polymarket/token/{token_id}/priceapiKey0 credits/requestReturns the public CLOB buy or sell price for one Polymarket token id.
Required params: token_id:path
/polymarket/token/{token_id}/spreadapiKey0 credits/requestReturns the public CLOB spread for one Polymarket token id.
Required params: token_id:path
/polymarket/tokens/midpointsapiKey0 credits/requestReturns public CLOB midpoints for up to 25 Polymarket token ids. This uses credential-free public CLOB market-data JSON and does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: body:body
/polymarket/tokens/orderbooksapiKey0 credits/requestReturns public CLOB order-book depth for up to 25 Polymarket token ids. This uses credential-free public CLOB market-data JSON and does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: body:body
/polymarket/tokens/pricesapiKey0 credits/requestReturns public CLOB buy and sell prices for up to 25 Polymarket token ids. The `side` enum accepts `buy` and `sell`; when omitted, both sides are returned. This uses credential-free public CLOB market-data JSON and does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: body:body
/polymarket/tokens/spreadsapiKey0 credits/requestReturns public CLOB spreads for up to 25 Polymarket token ids. This uses credential-free public CLOB market-data JSON and does not require a Polymarket user token, wallet signature, cookies, or personal account authentication.
Required params: body:body
/polymarket/tournamentsapiKey0 credits/requestReturns public tournament reference data from Polymarket Gamma.
Required params: None
/polymarket/tournaments/{id}apiKey0 credits/requestReturns public tournament detail data from Polymarket Gamma.
Required params: id:path
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| List Polymarket activity trades | /polymarket/activity/trades | GET | 0 credits/request | None | View docs | Try endpoint |
| Get Polymarket CLOB market | /polymarket/clob/market/{condition_id} | GET | 0 credits/request | condition_id:path | View docs | Try endpoint |
| List Polymarket macro dashboard events | /polymarket/dashboards/macro | GET | 0 credits/request | None | View docs | Try endpoint |
| Polymarket data followers | /polymarket/data/followers/{address} | GET | 0 credits/request | address:path | View docs | Try endpoint |
| Polymarket data following | /polymarket/data/following/{address} | GET | 0 credits/request | address:path | View docs | Try endpoint |
| Polymarket data follow counts | /polymarket/data/follows/counts/{address} | GET | 0 credits/request | address:path | View docs | Try endpoint |
| Get Polymarket event detail | /polymarket/event/{slug} | GET | 0 credits/request | slug:path | View docs | Try endpoint |
| List Polymarket event activity trades | /polymarket/event/{slug}/activity | GET | 0 credits/request | slug:path | View docs | Try endpoint |
| Get Polymarket event detail by id | /polymarket/event/id/{id} | GET | 0 credits/request | id:path | View docs | Try endpoint |
| List Polymarket event activity trades by id | /polymarket/event/id/{id}/activity | GET | 0 credits/request | id:path | View docs | Try endpoint |
| List Polymarket events | /polymarket/events | GET | 0 credits/request | None | View docs | Try endpoint |
| List tags for a Polymarket event | /polymarket/events/{id}/tags | GET | 0 credits/request | id:path | View docs | Try endpoint |
| Find similar Polymarket events | /polymarket/events/similar | GET | 0 credits/request | None | View docs | Try endpoint |
| Polymarket fee types | /polymarket/fee-types | GET | 0 credits/request | None | View docs | Try endpoint |
| Polymarket games | /polymarket/games | GET | 0 credits/request | None | View docs | Try endpoint |
| List Polymarket homepage feed rows | /polymarket/homepage/feed | GET | 0 credits/request | None | View docs | Try endpoint |
| List Polymarket leaderboard rows | /polymarket/leaderboard | GET | 0 credits/request | None | View docs | Try endpoint |
| Polymarket market clarifications | /polymarket/market-clarifications | GET | 0 credits/request | None | View docs | Try endpoint |
| Get Polymarket market detail by id | /polymarket/market/{id} | GET | 0 credits/request | id:path | View docs | Try endpoint |
| Get Polymarket market liquidity | /polymarket/market/{id}/liquidity | GET | 0 credits/request | id:path | View docs | Try endpoint |
| List tags for a Polymarket market | /polymarket/market/{id}/tags | GET | 0 credits/request | id:path | View docs | Try endpoint |
| Get Polymarket market detail by condition id | /polymarket/market/condition/{condition_id} | GET | 0 credits/request | condition_id:path | View docs | Try endpoint |
| List Polymarket market activity trades by condition id | /polymarket/market/condition/{condition_id}/activity | GET | 0 credits/request | condition_id:path | View docs | Try endpoint |
| Get Polymarket market liquidity by condition id | /polymarket/market/condition/{condition_id}/liquidity | GET | 0 credits/request | condition_id:path | View docs | Try endpoint |
| Get Polymarket market detail by slug | /polymarket/market/slug/{slug} | GET | 0 credits/request | slug:path | View docs | Try endpoint |
| Get Polymarket market liquidity by slug | /polymarket/market/slug/{slug}/liquidity | GET | 0 credits/request | slug:path | View docs | Try endpoint |
| List Polymarket markets | /polymarket/markets | GET | 0 credits/request | None | View docs | Try endpoint |
| List Polymarket predictions | /polymarket/predictions | GET | 0 credits/request | None | View docs | Try endpoint |
| Get Polymarket rewards market | /polymarket/rewards/market/{condition_id} | GET | 0 credits/request | condition_id:path | View docs | Try endpoint |
| List Polymarket rewards markets | /polymarket/rewards/markets | GET | 0 credits/request | None | View docs | Try endpoint |
| Search Polymarket events | /polymarket/search | GET | 0 credits/request | q:query | View docs | Try endpoint |
| Polymarket sports | /polymarket/sports | GET | 0 credits/request | None | View docs | Try endpoint |
| Polymarket sport detail | /polymarket/sports/{id} | GET | 0 credits/request | id:path | View docs | Try endpoint |
| Polymarket sport external partners | /polymarket/sports/{id}/external-partners | GET | 0 credits/request | id:path | View docs | Try endpoint |
| Polymarket sport external partner | /polymarket/sports/{id}/external-partners/{partner_ref} | GET | 0 credits/request | id:path, partner_ref:path | View docs | Try endpoint |
| Polymarket sports by partner | /polymarket/sports/by-partner | GET | 0 credits/request | None | View docs | Try endpoint |
| Polymarket sports market types | /polymarket/sports/market-types | GET | 0 credits/request | None | View docs | Try endpoint |
| Polymarket sports summary | /polymarket/sports/summary | GET | 0 credits/request | None | View docs | Try endpoint |
| Polymarket spotlights | /polymarket/spotlights | GET | 0 credits/request | None | View docs | Try endpoint |
| Polymarket spotlight detail | /polymarket/spotlights/{slug} | GET | 0 credits/request | slug:path | View docs | Try endpoint |
| Polymarket spotlight keyset | /polymarket/spotlights/keyset | GET | 0 credits/request | None | View docs | Try endpoint |
| Polymarket status | /polymarket/status | GET | 0 credits/request | None | View docs | Try endpoint |
| Get a Polymarket tag by id | /polymarket/tag/{id} | GET | 0 credits/request | id:path | View docs | Try endpoint |
| Get related Polymarket tags by id | /polymarket/tag/{id}/related-tags | GET | 0 credits/request | id:path | View docs | Try endpoint |
| Get related Polymarket tag rows by id | /polymarket/tag/{id}/related-tags/tags | GET | 0 credits/request | id:path | View docs | Try endpoint |
| Get a Polymarket tag by slug | /polymarket/tag/slug/{slug} | GET | 0 credits/request | slug:path | View docs | Try endpoint |
| Get related Polymarket tags by slug | /polymarket/tag/slug/{slug}/related-tags | GET | 0 credits/request | slug:path | View docs | Try endpoint |
| Get related Polymarket tag rows by slug | /polymarket/tag/slug/{slug}/related-tags/tags | GET | 0 credits/request | slug:path | View docs | Try endpoint |
| List Polymarket tags | /polymarket/tags | GET | 0 credits/request | None | View docs | Try endpoint |
| Polymarket teams | /polymarket/teams | GET | 0 credits/request | None | View docs | Try endpoint |
| Polymarket team detail | /polymarket/teams/{id} | GET | 0 credits/request | id:path | View docs | Try endpoint |
| Polymarket team external partners | /polymarket/teams/{id}/external-partners | GET | 0 credits/request | id:path | View docs | Try endpoint |
| Polymarket team external partner | /polymarket/teams/{id}/external-partners/{partner_ref} | GET | 0 credits/request | id:path, partner_ref:path | View docs | Try endpoint |
| Polymarket teams by partner | /polymarket/teams/by-partner | GET | 0 credits/request | None | View docs | Try endpoint |
| Get Polymarket token midpoint | /polymarket/token/{token_id}/midpoint | GET | 0 credits/request | token_id:path | View docs | Try endpoint |
| Get Polymarket token order book | /polymarket/token/{token_id}/orderbook | GET | 0 credits/request | token_id:path | View docs | Try endpoint |
| Get Polymarket token price history | /polymarket/token/{token_id}/price-history | GET | 0 credits/request | token_id:path | View docs | Try endpoint |
| Get Polymarket token price | /polymarket/token/{token_id}/price | GET | 0 credits/request | token_id:path | View docs | Try endpoint |
| Get Polymarket token spread | /polymarket/token/{token_id}/spread | GET | 0 credits/request | token_id:path | View docs | Try endpoint |
| Get Polymarket token midpoints | /polymarket/tokens/midpoints | POST | 0 credits/request | body:body | View docs | Try endpoint |
| Get Polymarket token order books | /polymarket/tokens/orderbooks | POST | 0 credits/request | body:body | View docs | Try endpoint |
| Get Polymarket token prices | /polymarket/tokens/prices | POST | 0 credits/request | body:body | View docs | Try endpoint |
| Get Polymarket token spreads | /polymarket/tokens/spreads | POST | 0 credits/request | body:body | View docs | Try endpoint |
| Polymarket tournaments | /polymarket/tournaments | GET | 0 credits/request | None | View docs | Try endpoint |
| Polymarket tournament detail | /polymarket/tournaments/{id} | GET | 0 credits/request | id:path | View docs | Try endpoint |