PolyWeather Documentation

Comprehensive guide to the weather prediction market platform

1. Project Overview

PolyWeather is a weather prediction market platform that enables users to:

View real-time weather predictions for various regions worldwide
Participate in voting for weather predictions (Yes/No)
Create custom weather predictions for the community
Track prediction accuracy and community statistics

Weather Enthusiasts

Analyze and predict weather with the community

Researchers

Access weather data and prediction accuracy trends

General Public

Engaging and interactive weather information

2. System Architecture

Backend Infrastructure

Database: Supabase PostgreSQL with RLS policies
API Layer: Supabase Edge Functions (Deno runtime)
Weather Data: Open-Meteo API for real-time data
Real-time: Supabase Realtime for live updates
Authentication: Supabase Auth with email/password

Frontend Technology

Framework: Next.js 16 with App Router
Language: TypeScript
Styling: Tailwind CSS v4
Animations: Framer Motion
Icons: Lucide React

3. Weather API Documentation

Data Source: Open-Meteo API

Real-time weather data for major cities
Update frequency: Every 30 minutes
Data points: temperature, humidity, wind speed, precipitation
Free API with no key required

GET /api/weather

Response:
{
  "data": {
    "cities": [
      {
        "name": "New York",
        "temperature": 22,
        "humidity": 65,
        "wind_speed": 12,
        "condition": "Clear",
        "timestamp": "2025-12-07T12:45:00Z"
      }
    ],
    "source": "Open-Meteo",
    "updated_at": "2025-12-07T12:45:00Z"
  }
}

5. API Documentation

POST /api/vote

Request:
{
  "marketId": "uuid-string",
  "voteType": "yes"
}

Response:
{
  "success": true,
  "data": {
    "vote_count": 1250,
    "yes_percentage": 68.5,
    "no_percentage": 31.5
  }
}

GET /api/markets

Response:
{
  "data": {
    "markets": [
      {
        "id": "uuid-string",
        "title": "Will temperature exceed 25C?",
        "category": "Temperature",
        "location": "New York",
        "yes_votes": 847,
        "no_votes": 403,
        "status": "live"
      }
    ]
  }
}

6. Database Schema

-- markets table
CREATE TABLE markets (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  title TEXT NOT NULL,
  description TEXT,
  category TEXT NOT NULL,
  location TEXT NOT NULL,
  status TEXT DEFAULT 'live',
  yes_votes INTEGER DEFAULT 0,
  no_votes INTEGER DEFAULT 0,
  created_at TIMESTAMPTZ DEFAULT NOW(),
  end_time TIMESTAMPTZ
);

-- votes table
CREATE TABLE votes (
  id SERIAL PRIMARY KEY,
  market_id UUID REFERENCES markets(id),
  user_id UUID REFERENCES auth.users(id),
  vote_type TEXT NOT NULL,
  created_at TIMESTAMPTZ DEFAULT NOW(),
  UNIQUE(market_id, user_id)
);

PolyWeather Documentation v2.0 - Last updated: December 2025

Weather data by Open-Meteo

GET /api/weather Response: { "data": { "cities": [ { "name": "New York", "temperature": 22, "humidity": 65, "wind_speed": 12, "condition": "Clear", "timestamp": "2025-12-07T12:45:00Z" } ], "source": "Open-Meteo", "updated_at": "2025-12-07T12:45:00Z" } }

Response: { "data": { "markets": [ { "id": "uuid-string", "title": "Will temperature exceed 25C?", "category": "Temperature", "location": "New York", "yes_votes": 847, "no_votes": 403, "status": "live" } ] } }

-- markets table CREATE TABLE markets ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), title TEXT NOT NULL, description TEXT, category TEXT NOT NULL, location TEXT NOT NULL, status TEXT DEFAULT 'live', yes_votes INTEGER DEFAULT 0, no_votes INTEGER DEFAULT 0, created_at TIMESTAMPTZ DEFAULT NOW(), end_time TIMESTAMPTZ ); -- votes table CREATE TABLE votes ( id SERIAL PRIMARY KEY, market_id UUID REFERENCES markets(id), user_id UUID REFERENCES auth.users(id), vote_type TEXT NOT NULL, created_at TIMESTAMPTZ DEFAULT NOW(), UNIQUE(market_id, user_id) );

PolyWeather

PolyWeather Documentation

Table of Contents

1. Project Overview

Weather Enthusiasts

Researchers

General Public

2. System Architecture

Backend Infrastructure

Frontend Technology

3. Weather API Documentation

Data Source: Open-Meteo API

5. API Documentation

POST /api/vote

GET /api/markets

6. Database Schema

PolyWeather Documentation

Table of Contents

1. Project Overview

Weather Enthusiasts

Researchers

General Public

2. System Architecture

Backend Infrastructure

Frontend Technology

3. Weather API Documentation

Data Source: Open-Meteo API

5. API Documentation

POST /api/vote

GET /api/markets

6. Database Schema