Polymarket

Search Polymarket prediction markets via the public Gamma API. 2 endpoints available — a thin single-call search and a server-side multi-query research endpoint that ranks results by topic relevance.

Base URL: /v1/polymarket/...

What you get

Polymarket events surface real-money prediction-market signals: who's favoured to win the next US election, will Bitcoin hit $200k, will OpenAI ship GPT-5 by year-end. Each event carries:

• Outcome prices (Yes / No or per-candidate, normalised 0–1)
• 24h / 1w / 1m volume and liquidity in USD
• Day / week / month price changes
• Market end dates
• "Competitiveness" — how close to 50/50 the market is

Two endpoints, two shapes

Getting started

curl "https://www.socialcrawl.dev/v1/polymarket/search?query=trump 2028" \
  -H "x-api-key: sc_your_api_key_here"

For the research endpoint:

curl "https://www.socialcrawl.dev/v1/polymarket/research?query=bitcoin halving" \
  -H "x-api-key: sc_your_api_key_here"

Response shape

Both endpoints normalise to the unified SearchResult archetype:

{
  "success": true,
  "platform": "polymarket",
  "endpoint": "/v1/polymarket/search",
  "data": {
    "items": [
      {
        "id": "evt-...",
        "title": "Will Trump win the 2028 election?",
        "slug": "trump-2028",
        "markets": [
          {
            "question": "Will Trump win the 2028 election?",
            "outcomes": "[\"Yes\",\"No\"]",
            "outcomePrices": "[\"0.32\",\"0.68\"]",
            "liquidity": 10000,
            "volume": 50000,
            "endDate": "2028-11-07T00:00:00Z",
            "oneDayPriceChange": 0.01,
            "oneWeekPriceChange": -0.02,
            "oneMonthPriceChange": 0.05
          }
        ],
        "tags": [{ "label": "Politics" }]
      }
    ]
  },
  "credits_used": 1,
  "credits_remaining": 99,
  "request_id": "req-...",
  "cached": false
}

Polymarket is a passthrough — fields under data.items[] are exactly what the Gamma API returns. There is no field map and no computed-field layer (no engagement_rate, language, etc.) because prediction-market events don't have authors or text content the way a TikTok post does.

Notes

• All endpoints use GET with query parameters.
• Authentication via x-api-key on the SocialCrawl side. Polymarket's upstream is no-auth, but you still authenticate to us.
• cacheCategory: "search" — 2 minute TTL. Markets move fast.
• The /research endpoint costs 5 credits because it makes 6+ upstream calls per request (multi-query expansion + parallel fan-out + ranking).