Skip to main content
skill CX Codex

prediction-markets-analysis — Claude Code skill

prediction-markets-analysis is a Claude Code skill that compares Kalshi contract prices with model probabilities and factors that could shift outcomes. For pre-trade research or checking a market thesis.

MIT 255 installs ★ 132 updated 2026-06-05

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OctagonAI/skills --skill prediction-markets-analysis -a claude-code
Open on GitHub

What prediction-markets-analysis does

The skill calls the Octagon Prediction Markets Agent for Kalshi data and produces an event report. It can include market and model probabilities, price drivers, upcoming catalysts, past resolutions, and contract details such as bid/ask spreads, last price, volume, and open interest. Coverage spans politics, economics, crypto, sports, and other categories.

Octagon MCP must be configured first. Generating a report requires an Octagon Plus, Pro, or Enterprise subscription and uses 3 credits; cached reports are free. The :cache variant always returns a cached report, while :refresh generates a new one and takes several minutes. That trade-off matters when you need current figures.

What it helps with

  • compare a contract price with a model probability
  • surface events that could shift a market estimate
  • review past outcomes to gauge base rates
  • check spreads, volume, and open interest before trading

Example prompts for the agent

  • Analyze Kalshi market KXFEDDECISION-26JUN and compare its price with the model probability.
  • Find upcoming events that could move this Kalshi contract: [ticker].
  • Fetch historical data for KXFEDDECISION-26JUN from January to June 2026.

How to install prediction-markets-analysis

1Skills CLI (Vercel)

npx skills add OctagonAI/skills --skill prediction-markets-analysis -a claude-code

2Manually: put the files in place

~/.claude/skills/prediction-markets-analysis/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/prediction-markets-analysis/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about prediction-markets-analysis

How do I install prediction-markets-analysis in Claude Code?

Run npx skills add OctagonAI/skills --skill prediction-markets-analysis -a claude-code. The skill file is at ~/.claude/skills/prediction-markets-analysis/SKILL.md.

What does prediction-markets-analysis do?

It builds research reports on Kalshi markets, comparing contract prices with model probabilities and outlining relevant drivers, catalysts, and resolution history.

What is required to generate a report?

Configure Octagon MCP. Report generation requires an Octagon Plus, Pro, or Enterprise subscription and 3 credits; cached reports are free.

Source text

SKILL.md · MIT
---
name: prediction-markets-analysis
description: Generate deep research reports on prediction market events using the Octagon Prediction Markets Agent. Combines real-time Kalshi market data with AI-driven analysis to surface price drivers, compare market vs. model probabilities, and identify potential mispricings across 120+ active markets.
---

# Prediction Markets Analysis

Generate comprehensive research reports on prediction market events using the Octagon Prediction Markets Agent. This skill combines real-time Kalshi market data with AI-driven analysis to identify mispricings, surface price drivers, and provide actionable trading insights.

## Prerequisites

Ensure Octagon MCP is configured in your AI agent (Cursor, Claude Desktop, Windsurf, etc.). See [references/mcp-setup.md](references/mcp-setup.md) for installation instructions.

**Note**: Report generation requires Octagon Plus, Pro, or Enterprise subscription (3 credits per report). Cached reports are free for all users.

## Core Functionality

The Prediction Markets Agent provides:

| Capability | Description |
|------------|-------------|
| Market vs. Model Probability | Computes independent model probability and compares against live market price |
| Event-Driven Research | Identifies key claims, catalysts, and decision-flipping events |
| Historical Resolution Tracking | Surfaces past resolution outcomes for context on base rates |
| Contract Snapshot | Returns live bid/ask spreads, last traded price, volume, and open interest |
| Cross-Category Coverage | 120+ active markets across Politics, Economics, Crypto, Sports, Entertainment, Science & Tech, Climate |

## Model Variants

| Variant | Description | Use Case |
|---------|-------------|----------|
| `octagon-prediction-markets-agent` | Default. Returns cached report if available, otherwise generates new | General use |
| `octagon-prediction-markets-agent:cache` | Always retrieves cached report | Fastest response, may not be latest |
| `octagon-prediction-markets-agent:refresh` | Always generates fresh report | Most up-to-date, takes several minutes |

## Example Queries

### Federal Reserve Policy
```
Analyze this Fed decision prediction market: https://kalshi.com/markets/kxfeddecision/fed-meeting/kxfeddecision-26jun
```

### Cryptocurrency Price Range
```
Research this Bitcoin price prediction market: https://kalshi.com/markets/kxbtcminy/how-low-will-bitcoin-fall-this-year/kxbtcminy-27jan01
```

### Sports Matchup
```
Analyze this NHL playoff prediction market: https://kalshi.com/markets/kxnhleast/eastern-conference-championship/kxnhleast-26
```

### Entertainment Awards
```
Research this Grammy nomination market: https://kalshi.com/markets/kxgrammynomsoty/grammy-nominees-for-song-of-the-year/kxgrammynomsoty-69
```

### IPO Timing
```
Analyze when SpaceX will IPO: https://kalshi.com/markets/kxipospacex/when-will-spacex-ipo/kxipospacex
```

### Force Fresh Report
```
Generate a fresh report (bypass cache) for: https://kalshi.com/markets/kxbtcminy/how-low-will-bitcoin-fall-this-year/kxbtcminy-27jan01
```

## Example Response Structure

```markdown
## Market Overview
- **Event**: Fed Decision June 2026
- **Resolution Date**: June 18, 2026
- **Current Market Price**: 72% (Hold rates)
- **Model Probability**: 68%
- **Mispricing Signal**: Market slightly overpriced

## Price Drivers
1. **Recent Economic Data**: CPI trending lower, supporting rate hold
2. **Fed Communications**: Dovish tone in recent FOMC minutes
3. **Labor Market**: Unemployment stable at 4.1%

## Key Catalysts
| Date | Event | Potential Impact |
|------|-------|------------------|
| June 10 | CPI Release | High - could shift probabilities 5-10% |
| June 12 | FOMC Statement | Medium - language on future path |

## Historical Resolution Context
- Last 6 meetings: 4 holds, 2 cuts
- Model accuracy on this series: 78%

## Contract Details
| Outcome | Bid | Ask | Last | Volume | OI |
|---------|-----|-----|------|--------|-----|
| Hold | 0.71 | 0.73 | 0.72 | 15,234 | 89,000 |
| Cut 25bp | 0.18 | 0.20 | 0.19 | 8,456 | 45,000 |
| Hike | 0.08 | 0.10 | 0.09 | 2,100 | 12,000 |

## Recommendation
**Slight Sell** on Hold contract. Model sees 4% overpricing. Consider waiting for CPI data before positioning.
```

## Market Categories

The agent covers 120+ active markets across:

| Category | Example Markets |
|----------|-----------------|
| **Politics** | Elections, legislation, executive actions |
| **Economics** | Fed decisions, inflation, employment data |
| **Crypto** | Bitcoin/Ethereum price ranges, ETF approvals |
| **Sports** | Championship outcomes, playoff matchups |
| **Entertainment** | Awards shows, box office, streaming |
| **Science & Tech** | Space launches, AI milestones, IPO timing |
| **Climate** | Temperature records, hurricane landfalls |

## Use Cases

### Identify Mispricings
Compare crowd consensus against model-derived probability to find trading opportunities.

### Pre-Trade Research
Research key drivers behind a prediction market price before placing a trade.

### Catalyst Monitoring
Monitor upcoming events that could move contract prices.

### Event Analysis
Get structured, sourced research on fast-moving events in politics, finance, and beyond.

## Historical Data Access

Use the `prediction_markets_history` tool to fetch historical data:

```
Fetch historical data for prediction market ticker KXFEDDECISION-26JUN from January to June 2026
```

Parameters:
- `ticker`: Market ticker symbol
- `captured_from`: Start date filter
- `captured_to`: End date filter
- `limit`: Number of records
- `cursor`: Pagination cursor

## Integration with Other Skills

Combine with other Octagon skills for comprehensive analysis:

| Skill | Integration Use |
|-------|-----------------|
| `earnings-call-analysis` | Analyze CEO comments relevant to prediction market events |
| `sec-8k-analysis` | Track material events that could impact market outcomes |
| `stock-performance` | Correlate stock moves with prediction market probabilities |

## Analysis Tips

1. **Check model vs. market spread**: Larger spreads suggest potential mispricings

2. **Monitor catalyst calendar**: Know when decision-flipping events are scheduled

3. **Review resolution history**: Past accuracy provides context for current probabilities

4. **Consider liquidity**: Check volume and open interest before sizing positions

5. **Use cache wisely**: Use `:cache` for quick checks, `:refresh` before trading

6. **Cross-reference sources**: Combine prediction market analysis with fundamental research

## Supported Platforms

- **Kalshi**: Full support for all active markets
- **Polymarket**: Coming soon

## For More Markets

Browse the full list of supported markets at [octagonai.co/markets](https://octagonai.co/markets).

© OctagonAI · MIT · OctagonAI/skills

Similar skills

All skills for Finance and business →

From the same set67

The whole set →
stock-grades stock-grades is a skill that fetches current analyst grades and ratings from major financial institutions. Track rating changes and shifts in market sentiment for any stock. CX Codex +1 258installs sec-footnotes-analysis The sec-footnotes-analysis skill uses Octagon MCP to analyze footnotes and accounting policies in public-company SEC filings. Ask it about revenue recognition, leases, debt, or management estimates. CX Codex +1 257installs sector-performance-snapshot sector-performance-snapshot is a Claude Code skill that retrieves company financial metrics by sector and exchange via Octagon MCP, supporting industry comparisons. CX Codex +1 257installs sec-debt-covenant The sec-debt-covenant skill examines debt covenants and credit agreement terms in SEC filings. Use it to check leverage limits, maturity schedules, and covenant compliance. CX Codex +1 257installs sec-amendments-review sec-amendments-review is a Claude Code skill that examines SEC filing amendments and surfaces material changes, corrections, and restatements. CX Codex +1 256installs sec-proxy-analysis sec-proxy-analysis extracts executive pay, board governance metrics, and shareholder votes from SEC DEF 14A filings using the Octagon MCP server. CX Codex +1 255installs sec-segment-reporting sec-segment-reporting analyzes business segment reporting from 10-K and 10-Q SEC filings via Octagon MCP. It pulls revenue, operating margin, and regional breakdowns. CX Codex +1 251installs kalshi-trading-bot-cli Drives the Kalshi Trading Bot CLI to research prediction markets, discover price edges, build baskets, and handle guarded order execution. CX Codex +1 106installs

Project sponsors

Companies that keep this analytics open