polypoll-sdk 0.1.0__tar.gz

polypoll_sdk-0.1.0/.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# OS
+.DS_Store
+Thumbs.db

polypoll_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: polypoll-sdk
+Version: 0.1.0
+Summary: Unified SDK for prediction market data aggregation across Polymarket, Kalshi, Manifold, Metaculus, and PredictIt
+Project-URL: Homepage, https://github.com/OpenOracleWeb3/polypoll-sdk
+Project-URL: Documentation, https://github.com/OpenOracleWeb3/polypoll-sdk#readme
+Project-URL: Repository, https://github.com/OpenOracleWeb3/polypoll-sdk
+Project-URL: Issues, https://github.com/OpenOracleWeb3/polypoll-sdk/issues
+Author-email: PolyPoll Team <team@polypoll.io>
+License: MIT
+Keywords: forecasting,kalshi,manifold,metaculus,polymarket,prediction-markets,predictit,sdk,trading
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: certifi>=2023.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rapidfuzz>=3.0.0
+Provides-Extra: ai
+Requires-Dist: groq>=0.5.0; extra == 'ai'
+Requires-Dist: openai>=1.0.0; extra == 'ai'
+Provides-Extra: all
+Requires-Dist: black>=23.0.0; extra == 'all'
+Requires-Dist: fastapi>=0.109.0; extra == 'all'
+Requires-Dist: groq>=0.5.0; extra == 'all'
+Requires-Dist: openai>=1.0.0; extra == 'all'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'all'
+Requires-Dist: pytest>=7.0.0; extra == 'all'
+Requires-Dist: ruff>=0.1.0; extra == 'all'
+Requires-Dist: uvicorn[standard]>=0.27.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: server
+Requires-Dist: fastapi>=0.109.0; extra == 'server'
+Requires-Dist: uvicorn[standard]>=0.27.0; extra == 'server'
+Description-Content-Type: text/markdown
+
+# PolyPoll SDK
+
+Unified SDK for prediction market data aggregation across multiple platforms.
+
+## Supported Platforms
+
+- **Polymarket** - Crypto prediction markets on Polygon
+- **Kalshi** - US regulated prediction markets
+- **Manifold Markets** - Play-money forecasting
+- **Metaculus** - Expert forecasting
+- **PredictIt** - US political markets
+
+## Installation
+
+```bash
+pip install polypoll-sdk
+```
+
+## Quick Start
+
+```python
+import asyncio
+from polypoll_sdk import PolyPollSDK
+
+async def main():
+    # Initialize SDK (no API keys needed for core features)
+    sdk = PolyPollSDK()
+
+    # Get markets from all platforms
+    markets = await sdk.get_all_markets()
+    print(f"Found {len(markets)} markets")
+
+    # Get markets from specific platform
+    polymarket = await sdk.get_markets(platform="polymarket")
+
+    # Search for markets
+    trump_markets = await sdk.search_markets("trump")
+
+    # Find similar markets across platforms
+    if markets:
+        similar = await sdk.get_similar_markets(
+            market_id=markets[0].market_id,
+            platform=markets[0].platform
+        )
+
+    # Detect arbitrage opportunities
+    arbitrage = await sdk.get_arbitrage_opportunities()
+    for opp in arbitrage[:5]:
+        print(f"Arbitrage: {opp.profit_pct:.1f}% profit")
+        print(f"  {opp.strategy}")
+
+asyncio.run(main())
+```
+
+## Features
+
+### Layer 1: Data Aggregation
+
+```python
+# Get all markets from all platforms
+markets = await sdk.get_all_markets()
+
+# Get markets from specific platform
+kalshi = await sdk.get_markets(platform="kalshi")
+
+# Search markets by keyword
+crypto = await sdk.search_markets("bitcoin", platforms=["polymarket", "kalshi"])
+```
+
+### Layer 2: Cross-Platform Matching
+
+```python
+# Find markets on other platforms similar to a given market
+similar = await sdk.get_similar_markets(
+    market_id="abc123",
+    platform="polymarket",
+    min_similarity=70
+)
+
+for match in similar:
+    print(f"{match.market.platform}: {match.similarity_score:.0f}%")
+```
+
+### Layer 3: AI Research (Coming Soon)
+
+```python
+# Coming in future release:
+# research = await sdk.deep_research("Will GPT-5 be released?")
+# ai_odds = await sdk.get_ai_odds(market_id="...")
+```
+
+### Layer 4: Validation (Coming Soon)
+
+```python
+# Coming in future release:
+# validation = await sdk.validate(question="Will BTC hit $100k?")
+# status = await sdk.check_status(market_id="...")
+```
+
+### Layer 5: Arbitrage Detection
+
+```python
+# Find cross-platform arbitrage opportunities
+opportunities = await sdk.get_arbitrage_opportunities(
+    min_profit=1.0,  # Minimum 1% profit
+    min_similarity=80  # High similarity threshold
+)
+
+for opp in opportunities:
+    print(f"{opp.profit_pct:.1f}% profit: {opp.strategy}")
+```
+
+## UnifiedMarket Schema
+
+All markets are normalized to a common schema:
+
+```python
+@dataclass
+class UnifiedMarket:
+    # Core
+    platform: str       # polymarket, kalshi, etc.
+    market_id: str
+    title: str
+    url: str
+
+    # Pricing (0-1)
+    yes_price: float
+    no_price: float
+
+    # Volume
+    volume: float
+    volume_24h: float
+    liquidity: Optional[float]
+
+    # Status
+    status: MarketStatus  # open, closed, resolved
+    is_resolved: bool
+    close_time: Optional[datetime]
+
+    # Metadata
+    category: Optional[str]
+    description: Optional[str]
+    image_url: Optional[str]
+```
+
+## Coming Soon: AI Features
+
+> **Note:** AI features are planned but not yet implemented in v0.1.0.
+
+The following features will require API keys when implemented:
+
+```python
+# Planned for future release:
+sdk = PolyPollSDK(
+    exa_api_key="your-exa-key",
+    groq_api_key="your-groq-key"
+)
+
+# Deep research (coming soon)
+# research = await sdk.deep_research("Will GPT-5 be released in 2025?")
+
+# AI odds prediction (coming soon)
+# ai_odds = await sdk.get_ai_odds(market_id="...")
+
+# Market validation (coming soon)
+# validation = await sdk.validate(question="Will BTC hit $100k?")
+```
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/OpenOracleWeb3/polypoll-sdk.git
+cd polypoll-sdk
+
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+## License
+
+MIT

polypoll_sdk-0.1.0/README.md

@@ -0,0 +1,185 @@
+# PolyPoll SDK
+
+Unified SDK for prediction market data aggregation across multiple platforms.
+
+## Supported Platforms
+
+- **Polymarket** - Crypto prediction markets on Polygon
+- **Kalshi** - US regulated prediction markets
+- **Manifold Markets** - Play-money forecasting
+- **Metaculus** - Expert forecasting
+- **PredictIt** - US political markets
+
+## Installation
+
+```bash
+pip install polypoll-sdk
+```
+
+## Quick Start
+
+```python
+import asyncio
+from polypoll_sdk import PolyPollSDK
+
+async def main():
+    # Initialize SDK (no API keys needed for core features)
+    sdk = PolyPollSDK()
+
+    # Get markets from all platforms
+    markets = await sdk.get_all_markets()
+    print(f"Found {len(markets)} markets")
+
+    # Get markets from specific platform
+    polymarket = await sdk.get_markets(platform="polymarket")
+
+    # Search for markets
+    trump_markets = await sdk.search_markets("trump")
+
+    # Find similar markets across platforms
+    if markets:
+        similar = await sdk.get_similar_markets(
+            market_id=markets[0].market_id,
+            platform=markets[0].platform
+        )
+
+    # Detect arbitrage opportunities
+    arbitrage = await sdk.get_arbitrage_opportunities()
+    for opp in arbitrage[:5]:
+        print(f"Arbitrage: {opp.profit_pct:.1f}% profit")
+        print(f"  {opp.strategy}")
+
+asyncio.run(main())
+```
+
+## Features
+
+### Layer 1: Data Aggregation
+
+```python
+# Get all markets from all platforms
+markets = await sdk.get_all_markets()
+
+# Get markets from specific platform
+kalshi = await sdk.get_markets(platform="kalshi")
+
+# Search markets by keyword
+crypto = await sdk.search_markets("bitcoin", platforms=["polymarket", "kalshi"])
+```
+
+### Layer 2: Cross-Platform Matching
+
+```python
+# Find markets on other platforms similar to a given market
+similar = await sdk.get_similar_markets(
+    market_id="abc123",
+    platform="polymarket",
+    min_similarity=70
+)
+
+for match in similar:
+    print(f"{match.market.platform}: {match.similarity_score:.0f}%")
+```
+
+### Layer 3: AI Research (Coming Soon)
+
+```python
+# Coming in future release:
+# research = await sdk.deep_research("Will GPT-5 be released?")
+# ai_odds = await sdk.get_ai_odds(market_id="...")
+```
+
+### Layer 4: Validation (Coming Soon)
+
+```python
+# Coming in future release:
+# validation = await sdk.validate(question="Will BTC hit $100k?")
+# status = await sdk.check_status(market_id="...")
+```
+
+### Layer 5: Arbitrage Detection
+
+```python
+# Find cross-platform arbitrage opportunities
+opportunities = await sdk.get_arbitrage_opportunities(
+    min_profit=1.0,  # Minimum 1% profit
+    min_similarity=80  # High similarity threshold
+)
+
+for opp in opportunities:
+    print(f"{opp.profit_pct:.1f}% profit: {opp.strategy}")
+```
+
+## UnifiedMarket Schema
+
+All markets are normalized to a common schema:
+
+```python
+@dataclass
+class UnifiedMarket:
+    # Core
+    platform: str       # polymarket, kalshi, etc.
+    market_id: str
+    title: str
+    url: str
+
+    # Pricing (0-1)
+    yes_price: float
+    no_price: float
+
+    # Volume
+    volume: float
+    volume_24h: float
+    liquidity: Optional[float]
+
+    # Status
+    status: MarketStatus  # open, closed, resolved
+    is_resolved: bool
+    close_time: Optional[datetime]
+
+    # Metadata
+    category: Optional[str]
+    description: Optional[str]
+    image_url: Optional[str]
+```
+
+## Coming Soon: AI Features
+
+> **Note:** AI features are planned but not yet implemented in v0.1.0.
+
+The following features will require API keys when implemented:
+
+```python
+# Planned for future release:
+sdk = PolyPollSDK(
+    exa_api_key="your-exa-key",
+    groq_api_key="your-groq-key"
+)
+
+# Deep research (coming soon)
+# research = await sdk.deep_research("Will GPT-5 be released in 2025?")
+
+# AI odds prediction (coming soon)
+# ai_odds = await sdk.get_ai_odds(market_id="...")
+
+# Market validation (coming soon)
+# validation = await sdk.validate(question="Will BTC hit $100k?")
+```
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/OpenOracleWeb3/polypoll-sdk.git
+cd polypoll-sdk
+
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+## License
+
+MIT

polypoll_sdk-0.1.0/examples/basic_usage.py

@@ -0,0 +1,111 @@
+"""
+Basic Usage Example
+
+Demonstrates core SDK functionality:
+- Fetching markets from all platforms
+- Searching markets
+- Finding similar markets
+- Detecting arbitrage
+"""
+
+import asyncio
+import sys
+sys.path.insert(0, '..')
+
+from polypoll_sdk import PolyPollSDK
+
+
+async def main():
+    print("=" * 60)
+    print("PolyPoll SDK - Basic Usage Example")
+    print("=" * 60)
+
+    # Initialize SDK (no API keys needed for core features)
+    sdk = PolyPollSDK()
+    print(f"\nSupported platforms: {sdk.supported_platforms}")
+    print(f"AI capabilities available: {sdk.has_ai_capabilities}")
+
+    # 1. Get all markets
+    print("\n" + "=" * 60)
+    print("1. FETCHING ALL MARKETS")
+    print("=" * 60)
+
+    markets = await sdk.get_all_markets(limit_per_platform=10)
+    print(f"\nTotal markets: {len(markets)}")
+
+    # Count by platform
+    by_platform = {}
+    for m in markets:
+        by_platform[m.platform] = by_platform.get(m.platform, 0) + 1
+
+    for platform, count in by_platform.items():
+        print(f"  - {platform}: {count} markets")
+
+    # 2. Show sample markets
+    print("\n" + "=" * 60)
+    print("2. SAMPLE MARKETS")
+    print("=" * 60)
+
+    for market in markets[:5]:
+        print(f"\n[{market.platform}] {market.title[:60]}...")
+        print(f"  YES: {market.yes_price:.1%} | NO: {market.no_price:.1%}")
+        print(f"  Volume: ${market.volume:,.0f}")
+        print(f"  URL: {market.url}")
+
+    # 3. Search markets
+    print("\n" + "=" * 60)
+    print("3. SEARCHING MARKETS")
+    print("=" * 60)
+
+    search_results = await sdk.search_markets("bitcoin", limit=5)
+    print(f"\nSearch 'bitcoin': {len(search_results)} results")
+
+    for market in search_results[:3]:
+        print(f"  [{market.platform}] {market.title[:50]}...")
+
+    # 4. Find similar markets (if we have enough data)
+    print("\n" + "=" * 60)
+    print("4. SIMILAR MARKETS")
+    print("=" * 60)
+
+    if markets:
+        source = markets[0]
+        print(f"\nFinding markets similar to:")
+        print(f"  [{source.platform}] {source.title[:60]}...")
+
+        similar = await sdk.get_similar_markets(
+            market_id=source.market_id,
+            platform=source.platform,
+            min_similarity=50
+        )
+
+        print(f"\nFound {len(similar)} similar markets:")
+        for match in similar[:5]:
+            print(f"  {match.similarity_score:.0f}% [{match.market.platform}] "
+                  f"{match.market.title[:40]}...")
+            if match.price_diff:
+                print(f"       Price diff: {match.price_diff:.1%}")
+
+    # 5. Arbitrage opportunities
+    print("\n" + "=" * 60)
+    print("5. ARBITRAGE OPPORTUNITIES")
+    print("=" * 60)
+
+    arbitrage = await sdk.get_arbitrage_opportunities(
+        min_profit=0.1,
+        min_similarity=70
+    )
+
+    print(f"\nFound {len(arbitrage)} arbitrage opportunities:")
+    for opp in arbitrage[:5]:
+        print(f"\n  {opp.profit_pct:.1f}% profit potential")
+        print(f"  {opp.strategy}")
+        print(f"  Similarity: {opp.similarity_score:.0f}%")
+
+    print("\n" + "=" * 60)
+    print("DONE!")
+    print("=" * 60)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

polypoll_sdk-0.1.0/polypoll_sdk/__init__.py

@@ -0,0 +1,56 @@
+"""
+PolyPoll SDK
+
+Unified SDK for prediction market data aggregation across
+Polymarket, Kalshi, Manifold, Metaculus, and PredictIt.
+
+Example:
+    ```python
+    from polypoll_sdk import PolyPollSDK
+
+    sdk = PolyPollSDK()
+
+    # Get all markets
+    markets = await sdk.get_all_markets()
+
+    # Search markets
+    trump = await sdk.search_markets("trump")
+
+    # Find similar markets
+    similar = await sdk.get_similar_markets(market_id="...")
+
+    # Detect arbitrage
+    arb = await sdk.get_arbitrage_opportunities()
+    ```
+"""
+
+from polypoll_sdk.client import PolyPollSDK
+from polypoll_sdk.config import Platform, SDKConfig
+from polypoll_sdk.models import (
+    ArbitrageOpportunity,
+    MarketOption,
+    MarketStatus,
+    MarketType,
+    SimilarMarket,
+    UnifiedMarket,
+)
+
+__version__ = "0.1.0"
+__author__ = "PolyPoll Team"
+
+__all__ = [
+    # Main SDK
+    "PolyPollSDK",
+    # Config
+    "Platform",
+    "SDKConfig",
+    # Models
+    "ArbitrageOpportunity",
+    "MarketOption",
+    "MarketStatus",
+    "MarketType",
+    "SimilarMarket",
+    "UnifiedMarket",
+    # Version
+    "__version__",
+]