alpha-finder

Alpha Finder (Market Oracle)

Research prediction markets and find alpha using AI-powered market intelligence across Polymarket, Kalshi, and traditional sources.

Configuration

The private key must be available via one of these methods:

Option 1: Environment variable

export X402_PRIVATE_KEY="0x..."

Option 2: Config file (Recommended)

The script checks for x402-config.json in these locations (in order):

1. Current directory: ./x402-config.json
2. Home directory: ~/.x402-config.json ← Recommended
3. Working directory: $PWD/x402-config.json

Create the config file:

{
  "private_key": "0x1234567890abcdef..."
}

Example (home directory - works for any user):

echo '{"private_key": "0x..."}' > ~/.x402-config.json

Usage

Run the market research script with a query about prediction markets or events:

scripts/analyze.sh "<market query>"

The script:

• Executes market intelligence research with payment handling
• Costs $0.03 USDC per request (Base network)
• Searches web, GitHub, Reddit, and X for comprehensive analysis
• Returns AI-processed market insights and probability assessments

Examples

User: "What are the odds for Bitcoin hitting $100k?"

scripts/analyze.sh "Bitcoin 100k prediction market odds"

User: "Find arbitrage opportunities in election markets"

scripts/analyze.sh "2024 election prediction market arbitrage"

User: "Analyze Polymarket odds on AI developments"

scripts/analyze.sh "Polymarket AI development predictions"

User: "What's the market sentiment on climate policy outcomes?"

scripts/analyze.sh "climate policy prediction markets Kalshi Polymarket"

Capabilities

• Polymarket research - Event analysis and odds tracking
• Kalshi market analysis - Regulated prediction market insights
• Multi-source intelligence - Searches web, GitHub, Reddit, and X
• Probability assessments - AI-powered market sentiment analysis
• Arbitrage identification - Spot inefficiencies across markets
• Event research - Deep dive into specific prediction market events
• Historical tracking - Compare current odds to historical patterns

Data Sources

The tool automatically searches across:

• Polymarket events and odds
• Kalshi regulated markets
• Reddit discussions and sentiment
• X/Twitter market commentary
• GitHub repositories (for tech-related predictions)
• Web sources for news and analysis

Error Handling

• "Payment failed: Not enough USDC" → Inform user to top up Base wallet with USDC
• "X402 private key missing" → Guide user to configure private key (see Configuration above)
• Timeout errors → The API has a 5-minute timeout; comprehensive research may take time

Use Cases

• Trading: Find mispriced markets and arbitrage opportunities
• Research: Analyze market sentiment on specific events
• Due Diligence: Verify market probabilities before betting
• Portfolio Management: Track prediction market positions
• News Analysis: Understand how events impact market odds