# SocialCrawl API: polymarket endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/polymarket

## GET /v1/polymarket/search
Search Polymarket prediction markets
Credit cost: 1 (standard)
Parameters:
- query (required): Free-text search term: keywords, entity names, or topics
- limit (optional, integer): Max results per result type (events / markets / profiles). Bounds the response size. Defaults to 10.
curl -G "https://www.socialcrawl.dev/v1/polymarket/search" \
  --data-urlencode "query=trump 2028" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/polymarket/research
Polymarket prediction markets: multi-query research
Credit cost: 5 (advanced)
Parameters:
- query (required): The research topic: free-text natural language (e.g. 'last 30 days bitcoin halving', 'kanye west tour'). Framing prefixes like 'last N days' and 'what are people saying about' are stripped automatically before expansion.
- limit (optional, integer): Max results per result type on each fan-out call (events / markets / profiles). Bounds the response size. Defaults to 10.
curl -G "https://www.socialcrawl.dev/v1/polymarket/research" \
  --data-urlencode "query=trump 2028 election" \
  -H "x-api-key: YOUR_API_KEY"