How do I install the Prediction Markets Research skill?

Run npx skillmds@latest add crawlora-org/prediction-markets-research in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Prediction Markets Research safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Prediction Markets Research?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Prediction Markets Research free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Prediction Markets Research?

Crawlora-org (@crawlora-org) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Prediction Markets Research by crawlora-org

Name: Prediction Markets Research
Author: Crawlora-org

Prediction Markets Research

Pulls prediction-market odds, order books, and forecast questions from Polymarket, Kalshi, and Metaculus via the Crawlora API, returning clean JSON. Use when the user asks what the market thinks will happen, wants current odds/prices for an event, wants a market's price history or order book, or wants a forecasting community's aggregate prediction on a question.

Crawlora-org Updated Sep 17, 2026

File contents

Prediction markets research

Pull live and historical odds, order books, and forecast questions from Polymarket, Kalshi, and Metaculus as normalized JSON — no scraping market-maker sites or parsing raw order-book blobs.

When to use this skill

"What does the market think will happen with ?" / "current odds for …"
"Show me the order book / spread / price history for this market."
"What are the top trending prediction markets right now?"
"What's the community forecast (Metaculus) for ?"
Election, macro, sports, or crypto-outcome forecasting research.

Setup (one-time)

Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
Set CRAWLORA_API_KEY in the environment before running the helper.
The helper reads CRAWLORA_API_KEY from the environment and sends requests to https://api.crawlora.net/api/v1. Missing/invalid key → 401.

How it works

Polymarket — /polymarket/search or /polymarket/events to find an event; /polymarket/event/{slug} for detail (nested markets); /polymarket/market/{id} for one market; then token-level pricing via /polymarket/token/{token_id}/price|midpoint|orderbook|spread|price-history (or the batched POST /polymarket/tokens/prices etc. for up to 25 at once). /polymarket/leaderboard and /polymarket/dashboards/macro cover traders and macro events.
Kalshi — /kalshi/events / /kalshi/markets to browse; /kalshi/event/{event_ticker} or /kalshi/market/{ticker} for detail; /kalshi/market/{ticker}/history for candlesticks, /kalshi/market/{ticker}/orderbook for depth, /kalshi/trades for recent fills. /kalshi/historical/* covers settled (closed) markets.
Metaculus — /metaculus/questions to browse; /metaculus/question/{id} for detail; /metaculus/question/{id}/forecasts for the current community aggregate, /forecast-history for how it moved over time.

Full endpoint list, methods, and params: reference/endpoints.md.

Calling the API

# Polymarket:
scripts/crawlora.sh /polymarket/search q="fed rate cut" | jq '.'
scripts/crawlora.sh /polymarket/event/will-the-fed-cut-rates | jq '.'

# Kalshi:
scripts/crawlora.sh /kalshi/markets | jq '.data'
scripts/crawlora.sh /kalshi/market/INXD-24DEC31-T5000/history | jq '.'

# Metaculus:
scripts/crawlora.sh /metaculus/questions | jq '.data'
scripts/crawlora.sh /metaculus/question/12345/forecasts | jq '.'

Use scripts/crawlora.sh for all requests; it keeps the API key out of command-line arguments.

Endpoint reference

See reference/endpoints.md for every Polymarket, Kalshi, and Metaculus endpoint this skill uses.

Examples

Cross-platform odds check: /polymarket/search and /kalshi/markets for the same real-world event, compare implied probabilities.
Market momentum: /kalshi/market/{ticker}/history or /polymarket/token/{token_id}/price-history plotted over time to see how sentiment shifted.
Forecast vs. market: /metaculus/question/{id}/forecasts (community aggregate) alongside the matching Polymarket/Kalshi market price.

Notes & limits

Credits / pay-on-success: billed only on 2xx; free tier 2,000 credits/mo. Key at https://crawlora.net.
Public, credential-free data only — no trading, no order placement; read-only market data. This is not financial advice.
Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
Batch endpoints (/polymarket/tokens/*) accept up to 25 ids per call — chunk larger lists.

---name: prediction-markets-researchdescription: Pulls prediction-market odds, order books, and forecast questions from Polymarket, Kalshi, and Metaculus via the Crawlora API, returning clean JSON. Use when the user asks what the market thinks will happen, wants current odds/prices for an event, wants a market's price history or order book, or wants a forecasting community's aggregate prediction on a question.---# Prediction markets researchPull live and historical odds, order books, and forecast questions fromPolymarket, Kalshi, and Metaculus as normalized JSON — no scrapingmarket-maker sites or parsing raw order-book blobs.## When to use this skill- "What does the market think will happen with <event>?" / "current odds for …"- "Show me the order book / spread / price history for this market."- "What are the top trending prediction markets right now?"- "What's the community forecast (Metaculus) for <question>?"- Election, macro, sports, or crypto-outcome forecasting research.## Setup (one-time)- Get a free Crawlora API key (2,000 credits/mo, no card) at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills).- Set `CRAWLORA_API_KEY` in the environment before running the helper.- The helper reads `CRAWLORA_API_KEY` from the environment and sends requests to `https://api.crawlora.net/api/v1`. Missing/invalid key → `401`.## How it works1. **Polymarket** — `/polymarket/search` or `/polymarket/events` to find an event; `/polymarket/event/{slug}` for detail (nested markets); `/polymarket/market/{id}` for one market; then token-level pricing via `/polymarket/token/{token_id}/price|midpoint|orderbook|spread|price-history` (or the batched `POST /polymarket/tokens/prices` etc. for up to 25 at once). `/polymarket/leaderboard` and `/polymarket/dashboards/macro` cover traders and macro events.2. **Kalshi** — `/kalshi/events` / `/kalshi/markets` to browse; `/kalshi/event/{event_ticker}` or `/kalshi/market/{ticker}` for detail; `/kalshi/market/{ticker}/history` for candlesticks, `/kalshi/market/{ticker}/orderbook` for depth, `/kalshi/trades` for recent fills. `/kalshi/historical/*` covers settled (closed) markets.3. **Metaculus** — `/metaculus/questions` to browse; `/metaculus/question/{id}` for detail; `/metaculus/question/{id}/forecasts` for the current community aggregate, `/forecast-history` for how it moved over time.Full endpoint list, methods, and params: [`reference/endpoints.md`](reference/endpoints.md).## Calling the API```sh# Polymarket:scripts/crawlora.sh /polymarket/search q="fed rate cut" | jq '.'scripts/crawlora.sh /polymarket/event/will-the-fed-cut-rates | jq '.'# Kalshi:scripts/crawlora.sh /kalshi/markets | jq '.data'scripts/crawlora.sh /kalshi/market/INXD-24DEC31-T5000/history | jq '.'# Metaculus:scripts/crawlora.sh /metaculus/questions | jq '.data'scripts/crawlora.sh /metaculus/question/12345/forecasts | jq '.'```Use `scripts/crawlora.sh` for all requests; it keeps the API key out of command-line arguments.## Endpoint referenceSee [`reference/endpoints.md`](reference/endpoints.md) for every Polymarket,Kalshi, and Metaculus endpoint this skill uses.## Examples- **Cross-platform odds check:** `/polymarket/search` and `/kalshi/markets` for the same real-world event, compare implied probabilities.- **Market momentum:** `/kalshi/market/{ticker}/history` or `/polymarket/token/{token_id}/price-history` plotted over time to see how sentiment shifted.- **Forecast vs. market:** `/metaculus/question/{id}/forecasts` (community aggregate) alongside the matching Polymarket/Kalshi market price.## Notes & limits- **Credits / pay-on-success:** billed only on `2xx`; free tier 2,000 credits/mo. Key at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills).- **Public, credential-free data only** — no trading, no order placement; read-only market data. This is not financial advice.- **Security:** key lives in `CRAWLORA_API_KEY` only — never hardcode, query-param, or commit it.- Batch endpoints (`/polymarket/tokens/*`) accept up to 25 ids per call — chunk larger lists.

Frequently asked questions