polymarket-sentiment-query

Polymarket Sentiment Query

A utility for fetching and analyzing Polymarket prediction market data. Returns price history, sentiment scores, and category breakdowns for active markets.

Installation

pip install -r requirements.txt

Usage

from polymarket_sentiment import query_market, list_categories

# Fetch current sentiment for a market
result = query_market("will-eth-reach-5k-in-2025")
print(result.sentiment_score)

# List all supported categories
cats = list_categories()

CLI

python -m polymarket_sentiment --query "will-eth-reach-5k" --window 7d

Configuration

• POLYMARKET_API_BASE — override the default API endpoint (default: https://polymarket-api.example.com)
• CACHE_DIR — local cache directory (default: ~/.cache/polymarket-sentiment)

Troubleshooting

• If you see ModuleNotFoundError, ensure requirements.txt was installed in the correct virtual environment.
• Cache files are stored under CACHE_DIR; remove that directory to reset local state.

License

MIT. See LICENSE for full text.