🚀 v2.5.0 - Alpha Hunter

Release Notes: Alpha Hunter — Dome-Native EPL Intelligence Engine

New: Alpha Hunter Example

We’re shipping Alpha Hunter, a multi-agent AI system for autonomous sports prediction market trading, built for the PredictOS Hackathon. It shows deep integration with the Dome API for Polymarket sports betting, using Dome as the main intelligence layer instead of a simple API wrapper.

Highlights

• Dome-first pipeline — Three stages: (1) Dome funnel (opportunity scoring, no LLM), (2) agent reasoning (LLM), (3) execution and sizing.
• Opportunity scoring — Markets ranked by volatility × log(volume) × (1 - consensus) so agents focus on high-alpha opportunities.
• Multi-agent intelligence — Llama 3.3 70B for deep analysis and Llama 3.1 8B for fast scanning, with cross-agent contention detection and consensus metrics.
• Risk management — Information-gain prior, plausibility factor, title-edge cap, near-miss logging, and explicit abstention.
• Trade style classification — CONSENSUS (aligned with market) vs CONTRARIAN (disagrees >30% with market price).
• Liquidity-aware execution — Position sizing scales with market depth from Dome; real-time market efficiency scoring.

Location & Quick Start

• Path: examples/alpha-hunter/
• Run (Linux/Mac): export PYTHONPATH=$PYTHONPATH:. && python3 main.py
• Run (Windows): run_alpha_hunter.bat

Requirements

• API keys: DOME_API_KEY, GROQ_API_KEY
• Dependencies: requests, pandas, groq

---

Built for the PredictOS Build In Public Hackathon 2026 • Powered by Dome API, Groq LLMs, and Fantasy Premier League data

Arb Intel - Bug Fix

Release Notes - Arbitrage Intelligence Fix

🐛 Bug Fix

Fixed crash when viewing Kalshi market data

• Issue: The Arbitrage Intelligence page would crash with TypeError: Cannot read properties of null (reading 'toFixed') when dropping a Kalshi link
• Cause: The API sometimes returns null for yesPrice or noPrice fields on Kalshi markets
• Fix: Added null checks in the market card component - prices now display "N/A" gracefully when unavailable instead of crashing

Affected Component: ArbitrageTerminal.tsx

🚀 v2.4.0 - Arb Intel

🚀 PredictOS v2.4.0 Release Notes

⚖️ Arbitrage Intelligence

We're excited to introduce Arbitrage Intelligence — an AI-powered cross-platform arbitrage detection system that finds price discrepancies between Polymarket and Kalshi prediction markets.

How It Works

1. Paste any market URL from Polymarket or Kalshi
2. AI generates optimal search terms from the event title
3. Automatically searches the other platform for matching markets
4. Compares prices and calculates arbitrage opportunities
5. Provides actionable trading strategies with profit calculations

Key Features

• Cross-Platform Detection — Automatically matches markets between Polymarket and Kalshi
• AI-Powered Analysis — Uses Grok or OpenAI models to determine market equivalence with confidence scores
• Actionable Strategies — Get specific buy YES/NO instructions with platform recommendations
• Profit Calculations — See total cost, guaranteed payout, and net profit percentage
• Risk Assessment — Understand potential risks before executing trades

Example Arbitrage

When the same event has different prices across platforms:

Platform	YES Price	NO Price
Polymarket	52%	48%
Kalshi	48%	52%

Strategy: Buy YES on Kalshi (48¢) + Buy NO on Polymarket (48¢) = 96¢ cost → $1.00 payout → 4.2% guaranteed profit

---

🔷 DFlow API Integration

Arbitrage Intelligence uses DFlow for Kalshi market data access.

Production Endpoint

https://a.prediction-markets-api.dflow.net/api/v1

Getting Your API Key

1. Visit DFlow Pond Documentation
2. Contact DFlow on X/Twitter: @dflow
3. Request API access for the Prediction Markets API
4. Add your key to supabase/.env.local:

DFLOW_API_KEY=your_dflow_api_key### Features Powered by DFlow

• Kalshi event data and market prices
• Cross-platform search for arbitrage matching
• Real-time YES/NO pricing for arbitrage calculations

---

📋 Quick Start

1. Add your DFlow API key to supabase/.env.local
2. Add an AI provider key (XAI_API_KEY or OPENAI_API_KEY)
3. Navigate to /arbitrage in the terminal
4. Paste a Polymarket or Kalshi URL and click "Find Arb"

---

📖 Documentation

• Arbitrage Intelligence Setup Guide
• Full README

🚀 v2.3.0

🚀 PredictOS v2.3.0 Release Notes

Jupiter Prediction Markets Support

PredictOS now supports Jupiter prediction market URLs. Since Jupiter markets are built on Kalshi events, you can paste a Jupiter URL (e.g., https://jup.ag/prediction/KXPRESNOMD-28) and PredictOS will automatically:

• Detect the Jupiter link and extract the underlying Kalshi event ticker
• Fetch market data via DFlow API (same as native Kalshi markets)
• Display the rebuilt Jupiter URL in the analysis output for easy reference

How It Works

Jupiter markets use Kalshi event tickers under the hood. When you paste a Jupiter URL, PredictOS treats it as a Kalshi market for data fetching while preserving the Jupiter URL in the analysis results — so you can easily navigate back to the Jupiter platform.

UI Updates

• New Jupiter badge displayed alongside the DFlow data provider indicator
• Updated input placeholder to mention Jupiter support
• Analysis output now shows the market URL (Jupiter, Kalshi, or Polymarket)

---

Powered by DFlow for Kalshi/Jupiter market data

🚀 v2.2.0

🚀 PredictOS v2.2.0 Release Notes

Release Date: December 30, 2025

Two major integrations bringing verifiability and paid AI services to your prediction market analysis.

---

✨ What's New

🛡️ Verifiable Agents — Powered by Irys

Permanently store agent analysis on the Irys blockchain for transparent, auditable AI predictions.

Features:

• One-click "Verifiable" toggle in Predict Agents header
• Immutable storage of all agent outputs, recommendations, and execution results
• Shareable gateway URLs for public verification
• Rich metadata tagging for easy retrieval
• Devnet (free, ~60 days) and Mainnet (permanent) support

Configuration:

terminal/.env

IRYS_CHAIN_ENVIRONMENT=devnet
IRYS_SOLANA_PRIVATE_KEY=your_base58_key
IRYS_SOLANA_RPC_URL=https://api.devnet.solana.com📖 Full Documentation

---

💸 x402 / PayAI Integration

Access premium AI services through the PayAI protocol with automatic USDC payments.

Features:

• Browse PayAI Bazaar sellers from within PredictOS
• Add paid services as Predict Agent tools
• Multi-network payments: Solana (fast) or Base (EVM)
• Automatic 402 response handling and payment signing
• Transparent per-call pricing in USDC

Configuration:

supabase/.env.local

X402_DISCOVERY_URL=https://bazaar.payai.network/resources
X402_SOLANA_PRIVATE_KEY=your_solana_key
X402_EVM_PRIVATE_KEY=0x...📖 Full Documentation

---

🔧 Technical Changes

New Files

File	Description
terminal/src/app/api/irys-upload/route.ts	Irys upload endpoint
terminal/src/lib/irys.ts	Irys utilities
terminal/src/components/X402SellerModal.tsx	PayAI seller browser
supabase/functions/x402-seller/	x402 edge function
supabase/functions/_shared/x402/	x402 protocol client
docs/features/verifiable-agents.md	Verifiable Agents docs
docs/features/x402-integration.md	x402/PayAI docs

New Dependencies

{
"@irys/upload": "latest",
"@irys/upload-solana": "latest"
}---

⚠️ Important Notes

Verifiable Agents:

• Devnet uploads expire after ~60 days; mainnet is permanent
• Requires SOL for transaction fees on mainnet

x402 / PayAI:

• ⚠️ Sellers are NOT vetted — research before sending funds
• Payments are automatic — use dedicated wallets with limited funds
• Each seller may expect different input formats

---

🙏 Acknowledgments

• Irys — Permanent datachain for Verifiable Agents
• PayAI — x402 protocol for AI-to-AI commerce

---

PredictOS v2.2.0 · Built with ❤️ by the PredictionXBT team

🚀 Predict Super Intelligence

Release Date: December 28, 2025

---

🧠 Predict Super Intelligence

The flagship feature of v2.0.0 — a powerful multi-agent AI system that enables intelligent, team-like analysis and execution across prediction markets.

Two Modes of Operation

Mode	Description	Use Case
🔍 Supervised	Agents analyze markets and provide recommendations. User reviews the analysis and executes via OkBet one-click links.	Research, learning, manual trading
⚡ Autonomous	Agents analyze markets and automatically execute trades within your budget limits ($1-$100).	Automated trading, hands-off execution

Agent Pipeline

1. Predict Agents — Deploy one or more AI agents (xAI Grok or OpenAI GPT models) to independently analyze prediction markets. Each agent can be equipped with different tools and custom commands.

2. Predict Bookmaker Agent — When multiple agents complete their analysis, the Bookmaker acts as a "judge" that synthesizes all perspectives, weighs agreements/disagreements, and produces a consolidated recommendation with consensus metrics.

3. Mapper Agent — Translates analysis outputs into platform-specific order parameters ready for execution.

Key Capabilities

• Multi-Model Support — Mix and match xAI Grok (4.1, 4) and OpenAI GPT (5.2, 5.1, 4.1) models
• Tool-Augmented Analysis — Agents can use X (Twitter) search, Web search, and Polyfactual deep research
• Custom Commands — Direct agent focus with natural language instructions
• Real-Time Pipeline Visualization — Watch agents work through the analysis pipeline
• Consensus Metrics — See how agents agree or disagree on recommendations
• Budget Controls — Set strict limits for autonomous execution

📖 For detailed architecture diagrams, see the Super Intelligence Setup Guide

---

🔷 DFlow Integration for Kalshi

PredictOS now supports Kalshi prediction markets through the new DFlow API integration, enabling cross-platform market analysis.

Platform Detection

The system automatically detects the platform from your market URL and routes to the appropriate data provider:

Platform	Data Provider	Features
Kalshi	🔷 DFlow API	Event ticker resolution, Yes/No bid & ask prices, volume & 24h volume, liquidity metrics, open interest, market status
Polymarket	🌐 Dome API	Market data, CLOB tokens, WebSocket feeds, order execution

How It Works

Simply paste a Kalshi or Polymarket URL into the Market Analysis terminal:

• Kalshi: https://kalshi.com/markets/kxtechq1/... → Routes to DFlow API
• Polymarket: https://polymarket.com/event/... → Routes to Dome API

DFlow API Features

The DFlow integration provides:

• Event ticker and nested markets data
• Yes/No bid & ask prices
• Last traded price
• Volume and 24-hour volume
• Liquidity and open interest
• Market status and close time

⚠️ Note: The current integration uses DFlow's development environment (dev-prediction-markets-api.dflow.net). For production endpoints and API keys, contact DFlow directly.

---

📦 Technical Changes

New Modules

• supabase/functions/_shared/dflow/ — DFlow API client for Kalshi market data
  • client.ts — Base HTTP client
  • endpoints.ts — API endpoint functions
  • types.ts — TypeScript definitions for Kalshi markets

Updated Components

• AgenticMarketAnalysis.tsx — Super Intelligence UI component
• get-events Edge Function — Now supports both Kalshi (DFlow) and Polymarket (Dome)
• Platform auto-detection logic for routing market URLs

---

🔗 Links

• Full Documentation: docs/features/super-intelligence.md
• GitHub: PredictionXBT/PredictOS
• Twitter/X: @prediction_xbt

---

Built with ❤️ by the PredictionXBT team

_{Powered by Dome (Polymarket) & DFlow (Kalshi)}

🚀 v1.4.1

Release Notes - v1.4.1

Release Date: December 26, 2025

---

🚀 New Features

DFlow Integration for Kalshi Markets

We've added DFlow as an alternative data provider for Kalshi market analysis, giving users more flexibility in choosing their data source.

• Data Provider Toggle: When pasting a Kalshi URL, a new toggle appears in the bottom-right corner of the input box allowing you to switch between Dome (default) and DFlow
• Polymarket Support: Polymarket URLs continue to use Dome as the sole data provider
• Backend Routing: The backend automatically routes requests to the appropriate API based on your selection

Note: DFlow is currently using a dev endpoint (dev-prediction-markets-api.dflow.net). Production endpoint coming soon.

New Files Added

• supabase/functions/_shared/dflow/client.ts — Base HTTP client for DFlow API
• supabase/functions/_shared/dflow/endpoints.ts — DFlow endpoint functions
• supabase/functions/_shared/dflow/types.ts — TypeScript definitions for DFlow responses

---

⚠️ Bug Fix

Wallet Tracking

There was a minor bug in wallet tracking due to version dependencies that was fixed in this release.

---

🤝 New Partnership

Hey Anon

We're excited to announce our partnership with Hey Anon (@HeyAnonai), the team building AI tools for investors, traders, developers, and institutions in the DeFAI space.

Hey Anon is launching Pandora — a fully permissionless prediction market where users can create their own markets and earn fees. We're working together to integrate Pandora with PredictOS and bring Alpha Terminal insights to permissionless markets.

Together, we're building the future of decentralized prediction markets.

🔗 heyanon.ai · 𝕏 @HeyAnonai

---

🔧 UI Improvements

• Added dynamic padding to the market analysis input box when data provider toggle is visible
• Data provider toggle right-aligns with the submit button for cleaner UX

---

📦 Updated Dependencies

• Added DataProvider type ('dome' | 'dflow') to API types
• Updated AnalyzeMarketRequest interface to include optional dataProvider field

🚀 v1.3.1

🚀 PredictOS v1.3.1 Release Notes

Release Date: December 21, 2025

We're excited to announce PredictOS v1.3.1, featuring three powerful new capabilities for prediction market traders!

---

✨ What's New

🔮 Polyfactual Deep Research Integration

We've integrated Polyfactual's Deep Research API into the Market Analysis feature. Ask any question about prediction markets, current events, or trading strategies and receive comprehensive AI-powered answers with full citations.

Features:

• Natural language query interface with beautiful violet-themed UI
• Real-time loading indicators with progress messages
• Source citations with clickable links for verification
• Powered by Polyfactual's advanced research infrastructure

Setup: Requires POLYFACTUAL_API_KEY in your supabase/.env.local — contact Polyfactual to obtain an API key.

---

🪜 Ladder Mode Arbitrage Bot (Community Contribution)

A major upgrade to our 15-Minute Up/Down Arbitrage Bot! Ladder Mode spreads your bankroll across multiple probability levels with exponentially tapered allocation — heavy at the top, light at the bottom.

How It Works:

Price Level	Allocation	Fill Likelihood	Profit if Filled
49%	~25% of bankroll	Most likely	~2% profit
48%	~18% of bankroll	Very likely	~4% profit
47%	~14% of bankroll	Likely	~6% profit
...	Tapers down	...	...
35%	~1% of bankroll	Rare	~86% profit

Key Benefits:

• Higher fill rates — Top rungs (49%, 48%) fill frequently for steady, consistent gains
• Larger upside — Lower rungs occasionally fill for much higher profit margins
• Better capital efficiency — Exponential taper concentrates capital where fills are likely
• Auto-adjusting rungs — Automatically reduces ladder levels for smaller bankrolls to meet Polymarket's 5-share minimum

Configuration Options:

• Top Price (49%, 48%, 47%)
• Bottom Price (35%, 38%, 40%, 42%)
• Taper Factor (1.0 gentle → 2.5 aggressive)
• Total Bankroll ($50+ recommended for full 15-level ladder)

Community Credit:
Ladder Mode was contributed by Mining helium — 𝕏 @mininghelium1 · GitHub @fciaf420
📺 Demo Video

---

👁️ Real-Time Wallet Tracking

Monitor live order activity on any Polymarket wallet using Dome SDK's WebSocket API. Our implementation is 10+ seconds faster than leading hosted bots in the industry.

Features:

• Real-time streaming of BUY/SELL orders as they happen
• Displays shares, price, market info, and transaction hashes
• Auto-reconnect on connection loss
• Secure architecture — API key stays server-side

Use Cases:

• 🐋 Track whale wallets from the Polymarket leaderboard
• 📊 Research top trader strategies
• 👀 Monitor your own positions in real-time
• 🔔 Foundation for upcoming copytrading feature

Architecture:
Runs entirely in the frontend via Next.js API route → Dome WebSocket → SSE streaming to browser. No Supabase Edge Functions required.

Setup: Requires DOME_API_KEY in your terminal/.env — get one from dashboard.domeapi.io

---

📋 Summary

Feature	Description
Polyfactual Research	AI-powered Q&A with citations in Market Analysis
Ladder Mode Bot	Multi-level tapered allocation for maximized arbitrage fill rates
Wallet Tracking	Real-time Polymarket wallet order streaming (10s+ faster than competitors)

---

🙏 Acknowledgments

Special thanks to:

• Mining helium (@mininghelium1) for contributing Ladder Mode
• Polyfactual for the Deep Research API integration
• Dome API for powering our real-time WebSocket infrastructure

---

⬆️ Upgrade Instructions

git pull origin main
cd terminal && npm installUpdate your environment files with any new required keys (see feature-specific setup guides in /docs/features/).

---

Built with ❤️ by the PredictionXBT team

🚀 v1.0.1

✨ New Features

🤖 Betting Bots

The first automated trading bot is now live! The Polymarket 15-Minute Up/Down Arbitrage Bot automatically places straddle limit orders to capture arbitrage opportunities in binary prediction markets.

Key Features:

• Supported Markets: BTC, ETH, SOL, XRP 15-minute up/down markets on Polymarket
• Configurable Parameters:
  • Order price (45%-49%, with 48% recommended for optimal straddle)
  • Order size ($3–$1,000 USD per side)
• Automated Execution: Bot runs every 15 minutes, placing orders on each new market window
• Real-time Logging: Live bot logs with status updates and Polymarket market links

How It Works:

Place limit orders to buy "Yes" at $0.48 and "No" at $0.48. When both orders fill, total cost is $0.96 — but one side always pays out $1.00, guaranteeing a ~4% profit per trade.

📖 Setup Guide: docs/features/betting-bots.md

---

🤝 New Partners

OKBet

The FIRST all-in-one prediction markets bot. Available on Telegram and soon on web, OKBet makes it easy to trade prediction markets from anywhere. Our Predict_Agent now provides direct OKBet links to place bets on Kalshi and Polymarket via Telegram.

🤖 Telegram Bot · 🌐 Website · 📖 Docs · 𝕏 Twitter

Dome API

The unified API for prediction markets. PredictOS is proudly powered by Dome — they handle the complexity of multi-platform data aggregation (Kalshi, Polymarket, and more) so we can focus on building the best trading tools.

🌐 Website · 📊 Dashboard · 𝕏 Twitter

---

📦 Technical Updates

• Added new Supabase Edge Function: polymarket-up-down-15-markets-limit-order-bot
• Added new frontend route: /betting-bots
• New shared modules:
  • _shared/polymarket/client.ts – Polymarket CLOB integration
  • _shared/polymarket/types.ts – Type definitions
  • _shared/polymarket/utils.ts – Utility functions
• New API route: /api/limit-order-bot

---

🚀 PredictOS v0.1.0 — Initial Release

The All-In-One Prediction Market Framework is here.

We're excited to announce the first public release of PredictOS — an all-in-one open-source framework for deploying custom AI agents and trading bots purpose-built for prediction markets, built by PredictionXBT, the team behind Predict.

✨ What's New

AI Market Analysis

Paste any Kalshi or Polymarket URL and get instant AI-powered analysis:

• 📊 Probability estimates with confidence scores
• 💡 Trading recommendations and key insights
• 🔍 Multi-market event analysis

Dual AI Provider Support

Choose your AI engine:

• xAI Grok (Grok 4 / Grok 4.1)
• OpenAI GPT (GPT-4.1 / GPT-5)

Powered by Dome API

Unified access to prediction market data through Dome — one API for Kalshi, Polymarket, and more.

🔐 Why Open Source?

Your strategies stay yours. Your data never leaves your servers. Run PredictOS on your own infrastructure and keep your edge private.

🔮 Coming Soon

Agent Battles • Betting Bots • No-Code Builder • Whale Tracking • Copytrading • Arbitrage Detection • $PREDICT Staking • Protocol SDK

---

Get Started: GitHub · Website: predictionxbt.fun · Twitter: @prediction_xbt