📡 Data Flow

1. Fetching Prediction Markets

LUMI fetches real-time market data from Polymarket's Gamma API:

// src/services/polymarket.js
const POLYMARKET_API_BASE = '/api/polymarket-proxy';

export async function fetchMarkets(options = {}) {
  const { limit = 100, active = true, closed = false } = options;

  const params = new URLSearchParams({
    endpoint: '/markets',
    limit: limit.toString(),
    active: active.toString(),
    closed: closed.toString(),
    _t: Date.now().toString() // Cache buster
  });

  const response = await fetch(`${POLYMARKET_API_BASE}?${params}`, {
    headers: { 'Accept': 'application/json' },
    cache: 'no-cache'
  });

  const markets = await response.json();
  return markets.filter(m => m.question && m.outcomePrices).map(normalizeMarket);
}

2. Market Data Structure

Each market from Polymarket contains:

interface Market {
  id: string;
  question: string;           // "Will Bitcoin reach $100k in 2025?"
  description: string;        // Detailed resolution criteria
  outcomes: string[];         // ["Yes", "No"]
  outcomePrices: string[];    // ["0.65", "0.35"] - current odds
  volume: string;             // Total trading volume in USD
  liquidity: string;          // Available liquidity
  endDate: string;            // Resolution date
  image: string;              // Market thumbnail
  tags: string[];             // ["Crypto", "Bitcoin"]
}

3. LUMI Prediction Generation

When a market is displayed, LUMI generates its own probability assessment:

// api/oracle-prediction.js
export default async function handler(req, res) {
  const { question, currentOdds, marketData } = req.body;

  const completion = await openai.chat.completions.create({
    model: 'gpt-4o-mini',
    messages: [
      {
        role: 'system',
        content: `You are LUMI, a mystical AI Oracle that perceives 
        the threads of fate and probability. Analyze prediction markets 
        and provide probability assessments based on historical patterns, 
        current events, and underlying factors the crowd may overlook.`
      },
      {
        role: 'user',
        content: `
          MARKET QUESTION: ${question}
          CROWD'S CURRENT BELIEF: ${(parseFloat(currentOdds) * 100).toFixed(1)}%
          MARKET DATA: ${JSON.stringify(marketData)}
          
          Provide your prophecy in JSON format:
          {
            "probability": "0.XX",
            "confidence": "High/Medium/Low",
            "reasoning": "Your analysis (2-3 sentences)",
            "signals": ["Factor 1", "Factor 2", "Factor 3"]
          }
        `
      }
    ],
    temperature: 0.7,
    response_format: { type: "json_object" }
  });

  return res.json(JSON.parse(completion.choices[0].message.content));
}