polymarket-apilisted
Install: claude install-skill nikhonit/social-media-api-skills
# Polymarket API skill
Read public Polymarket data as clean JSON. This Polymarket API skill has a single endpoint: search markets by query and get back the listings with their current odds, at 1 credit per market. Prediction market prices are a genuinely useful forecast signal, and this is a cheap way to put them in front of an agent.
This skill wraps **1 live Polymarket endpoint** from the [ScraperSocial](https://scrapersocial.com) API. Public data only, returned as clean JSON.
## When to use this skill
- A user asks what the market thinks the odds of an event are.
- You want a forecast signal to compare against commentary or polling.
- You are tracking how odds on a question move over time.
### Do not use this skill when
- **You are placing trades.** This is read-only and is not trading infrastructure. Nothing here executes orders, and the odds may be cached rather than live.
- **You are presenting odds as fact.** They are a market price, not a prediction from an authority — say so when you surface them.
- **You need order book depth or historical series.** One endpoint, current listings only.
## Setup
```bash
export SCRAPERSOCIAL_KEY=sk_live_... # https://scrapersocial.com/app/keys
```
Signing up at [scrapersocial.com/signup](https://scrapersocial.com/signup) includes 100 free credits, no card required.
## Scripts
| Script | What it does | Input | Credits |
|---|---|---|---|
| `get_markets.js` | List Polymarket markets. | query | 1 credit per market |
| `call_