How jon-becker/prediction-market-analysis works
Prediction Market Analysis collects Kalshi and Polymarket market/trade data, stores it as Parquet, and runs venue-specific research analyses that produce figures and statistical outputs. The main command-line entry point discovers and dispatches indexers or analyses. The README documents the broad collection-to-storage and analysis workflow; sampled source verifies several dispatches and shared clients, but not every indexer’s persistence or analysis data-loading details.
Main entry points: analysis.py Analysis framework · main.py CLI commands · polymarket Polymarket indexers · indexer.py Indexer framework
Components 23
Application entry
- CLI commands
main.py
Data collection
- Indexer framework
src/common/indexer.py - Kalshi indexers
src/indexers/kalshi - Kalshi API client
src/indexers/kalshi/client.py - Kalshi data models
src/indexers/kalshi/models.py - Polymarket indexers
src/indexers/polymarket - Polymarket API client
src/indexers/polymarket/client.py - Polymarket data models
src/indexers/polymarket/models.py - Polygon trade fetcher
src/indexers/polymarket/blockchain.py - Shared HTTP client
src/common/client.py
Data storage
- Parquet storage
src/common/storage.py
Research analyses
- Analysis framework
src/common/analysis.py - Kalshi analyses
src/analysis/kalshi - Market categories
src/analysis/kalshi/util/categories.py - Polymarket analyses
src/analysis/polymarket - Cross-venue comparison
src/analysis/comparison/win_rate_by_price_animated.py - Chart interface
src/common/interfaces/chart.py
Other components
- Researcher
- Kalshi API
- Polymarket API
- Polygon RPC
- Figures and statistics
- Packaged data archive
Connections 30
- Researcher → CLI commands: runs commands
README.md - CLI commands → Analysis framework: discovers analyses
main.py - CLI commands → Indexer framework: discovers indexers
main.py - CLI commands → Figures and statistics: saves outputs
main.py - CLI commands → Packaged data archive: packages data
main.py - Indexer framework → Kalshi indexers: loads implementations
src/indexers/kalshi/trades.py - Indexer framework → Polymarket indexers: loads implementations
src/indexers/polymarket/fpmm_trades.py - Kalshi indexers → Kalshi API client: uses client
src/indexers/kalshi/markets.py - Kalshi indexers → Indexer framework: implements
src/indexers/kalshi/markets.py - Kalshi indexers → Parquet storage: persists data
README.md - Kalshi API client → Shared HTTP client: makes requests
src/indexers/kalshi/client.py - Kalshi API client → Kalshi data models: parses responses
src/indexers/kalshi/client.py - Kalshi API client → Kalshi API: requests market data
src/indexers/kalshi/client.py - Polymarket indexers → Polymarket API client: uses client
src/indexers/polymarket/markets.py - Polymarket indexers → Polygon trade fetcher: fetches chain data
src/indexers/polymarket/trades.py - Polymarket indexers → Indexer framework: implements
src/indexers/polymarket/markets.py - Polymarket indexers → Parquet storage: persists data
README.md - Polymarket API client → Shared HTTP client: makes requests
src/indexers/polymarket/client.py - Polymarket API client → Polymarket data models: parses responses
src/indexers/polymarket/client.py - Polymarket API client → Polymarket API: requests markets
src/indexers/polymarket/client.py - Polygon trade fetcher → Polygon RPC: fetches chain events
src/indexers/polymarket/blockchain.py - Kalshi analyses → Analysis framework: extends framework
src/analysis/kalshi/statistical_tests.py - Kalshi analyses → Market categories: uses categories
src/analysis/kalshi/statistical_tests.py - Polymarket analyses → Analysis framework: extends framework
src/analysis/polymarket/polymarket_win_rate_by_price.py - Cross-venue comparison → Analysis framework: uses framework
src/analysis/comparison/win_rate_by_price_animated.py - Analysis framework → Chart interface: uses chart types
src/common/analysis.py - Kalshi analyses → Parquet storage: reads stored data
- Polymarket analyses → Parquet storage: reads stored data
- Cross-venue comparison → Parquet storage: reads stored data
- Analysis framework → Figures and statistics: exports results
src/common/analysis.py