Skill: tzannetosgiannis/alpha-finder (version 1.0.0)

--- name: alpha-finder description: Market Oracle for prediction market intelligence - Polymarket and Kalshi research, probability assessments, market sentiment analysis, and arbitrage opportunity identification. Use when users want to research prediction markets, analyze betting odds, or find market inefficiencies. Costs $0.03 USDC per request via x402 protocol on Base network. --- # 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** ```bash 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: ```json { "private_key": "0x1234567890abcdef..." } ``` **Example (home directory - works for any user):** ```bash echo '{"private_key": "0x..."}' > ~/.x402-config.json ``` ## Usage Run the market research script with a query about prediction markets or events: ```bash 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?" ```bash scripts/analyze.sh "Bitcoin 100k prediction market odds" ``` **User:** "Find arbitrage opportunities in election markets" ```bash scripts/analyze.sh "2024 election prediction market arbitrage" ``` **User:** "Analyze Polymarket odds on AI developments" ```bash scripts/analyze.sh "Polymarket AI development predictions" ``` **User:** "What's the market sentiment on climate policy outcomes?" ```bash 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

path: scripts/analyze.sh
content: #!/bin/bash
# Prediction market intelligence via x402 protocol
# Usage: analyze.sh "<market query>"

set -e

QUERY="$*"

# Check if query is provided
if [ -z "$QUERY" ]; then
    echo "Error: No market query provided"
    echo "Usage: analyze.sh \"<market query>\""
    exit 1
fi

# Try to find config file in multiple locations
CONFIG_LOCATIONS=(
    "./x402-config.json"
    "$HOME/.x402-config.json"
    "$PWD/x402-config.json"
)

# Check each location for config file
for CONFIG_FILE in "${CONFIG_LOCATIONS[@]}"; do
    if [ -f "$CONFIG_FILE" ]; then
        PRIVATE_KEY=$(jq -r '.private_key' "$CONFIG_FILE" 2>/dev/null || echo "")
        if [ -n "$PRIVATE_KEY" ]; then
            export X402_PRIVATE_KEY="$PRIVATE_KEY"
            break
        fi
    fi
done

# Check if private key is available
if [ -z "$X402_PRIVATE_KEY" ]; then
    echo "Error: X402 private key missing"
    echo ""
    echo "Please configure your private key using one of these methods:"
    echo "1. Set environment variable: export X402_PRIVATE_KEY=\"0x...\""
    echo "2. Create x402-config.json in current directory with:"
    echo '   {"private_key": "0x..."}'
    echo "3. Create ~/.x402-config.json in your home directory"
    exit 1
fi

# Execute the market analysis
npx -y @itzannetos/x402-tools-claude alpha-finder "$QUERY"


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: suspicious | SkillSpector: suspicious (HIGH)