# Polymarket Data API (https://www.socialcrawl.dev/platforms/polymarket)

> Polymarket API: a single research endpoint that fans out keyword searches across prediction markets and returns aggregated odds, prices, volume, outcomes, and end dates for a topic. 5 credits per call on the advanced tier; 100 free credits, no card. Prediction-market data on the same x-api-key and JSON envelope as 43 other platforms.

TL;DR: SocialCrawl's Polymarket API exposes 1 endpoints, 5 credits per call, all returning one unified JSON schema with AI-enriched fields. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Research | GET | `/v1/polymarket/research` | 5 | Polymarket prediction markets — multi-query research |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/polymarket/research?query=trump%202028%20election" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## SocialCrawl vs Polymarket Gamma API

| Feature | SocialCrawl | Polymarket Gamma API |
| --- | --- | --- |
| Authentication | One x-api-key shared with 43 other platforms | No key needed for public Gamma endpoints |
| Setup | One GET to /v1/polymarket/research with a topic | Free, but you write your own search fan-out and aggregation |
| Response schema | Unified data.items envelope — same parser as your social sources | Gamma-specific market objects; CLOB is a separate API for trading |
| Pricing | 5 credits per research call; 100 free credits, no card | Free |
| Data coverage | Aggregated multi-market view per topic — odds, prices, volume, end dates | Full raw market data, one query at a time |

## FAQ

### Is the Polymarket API free?

Polymarket's own gamma API is public, but it returns raw market objects you still have to normalize, and it gives you nothing outside Polymarket. SocialCrawl returns Polymarket markets in the same schema as its social and finance endpoints, so you can line a prediction market up against what people are actually posting about it.

### What is the SocialCrawl Polymarket API?

It is a unified wrapper over Polymarket's public Gamma API. Send a GET request with x-api-key and SocialCrawl returns structured prediction-market data — the market question, outcomes, odds and prices, volume, and end date — in the same data.items schema as every other platform, with one credit system.

### What Polymarket endpoints does SocialCrawl offer?

One endpoint. /v1/polymarket/research takes a topic, fans out several keyword searches across Polymarket's prediction markets, and returns an aggregated multi-market view — each market with its question, outcomes, odds and prices, volume, and end date.

### Does Polymarket have an API, and is it free?

Yes. Polymarket exposes a public Gamma API for free, plus the CLOB API for trading. SocialCrawl wraps Gamma so you get one x-api-key, a unified schema, and credit-based billing alongside your other data sources. New accounts get 100 free credits with no card required.

### How much does the Polymarket API cost?

The research endpoint costs 5 credits on the advanced tier because it runs several searches per call. New accounts get 100 free credits with no credit card, enough to run 20 multi-market research calls before paying anything.

### What data fields come back for each market?

Each market includes the question, every outcome with its current odds and price, total volume, end date, and resolution status (active, closed, or resolved). Fields are normalised into the SocialCrawl schema so the same parser works across all 44 platforms.

### What does the research endpoint add over a single keyword search?

The research endpoint fans out several keyword searches for one topic and aggregates the results into a single prediction-market view. It is built for traders, quant researchers, and journalists who want event-probability coverage on a topic rather than one query's matches.

### What is the best way to access Polymarket data via API?

Polymarket's own Gamma API is free and a good fit if you only need raw market objects. SocialCrawl's /v1/polymarket/research adds topic-level aggregation: it fans out several keyword searches and returns one multi-market view with odds, prices, and volume for 5 credits. New accounts get 100 free credits, no card required.

### Is there a Polymarket data API?

Yes, and it is open: Polymarket publishes a free public Gamma API, plus the CLOB API for trading. SocialCrawl does not gate that data; it wraps Gamma so GET /v1/polymarket/research returns an aggregated multi-market view of odds, prices, and volume in the same schema and credits as your other sources, at 5 credits per call. Use Gamma directly for raw market objects, SocialCrawl when you want topic-level aggregation on one key.

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What is the SocialCrawl Polymarket API?
- Does Polymarket have an API and how do I use it with SocialCrawl?
- How to get prediction market odds and volume with an API