Documentation
Overview
A self-hosted dashboard for monitoring Polymarket weather (temperature) markets worldwide, cross-referenced against numerical forecast models and live airport observations. This site explains how to use it, where its data comes from, and how to run it on your own server.
The Forecasting dashboard pulls the live set of open Polymarket weather markets, groups them by continent and city, and lines each market up against the forecast signal for the airport that actually settles it — the model temperature, the exceedance percentiles, the meteoblue predictability index, and recent METAR observations. The goal is a single screen where you can see, per market, both the crowd's price and the meteorological picture behind it.
Start here
01
Getting started
Open the dashboard, what the cosmetic login does, and how the screen refreshes.
02
Interface tour
Header, summary stats, continent and city tabs, filters, sort, and the main table.
03
The markets table
Every column explained: leading bucket, liquidity, predictability colours, actuals.
04
Market detail panel
Hourly forecast chart, METAR observations, exceedance table, and live orderbook.
Understand the data
05
Data sources & pipeline
forecasts.json, actuals, ensemble, meteoblue, METAR and the Polymarket APIs.
06
Forecast methodology
Settlement airports, exceedance percentiles, predictability bands and units.
07
City & continent coverage
The 59 tracked cities, and which have the full forecast/METAR pipeline.
08
Glossary
METAR, CLOB, exceedance, predictability, liquidity and the rest, in plain terms.
Run it yourself
09
System architecture
How the Node server, login, API proxy, static files and nginx fit together.
10
Deployment guide
Stand it up on a fresh Linux VPS, automated or step by step.
11
Configuration reference
Every environment variable, the login credentials and the session settings.
12
Routes & API reference
Server routes and how the two Polymarket upstreams are proxied.
At a glance
| Aspect | Detail |
|---|---|
| Tracked cities | 59 across 6 continents (Europe, North America, Asia, South America, Africa, Oceania) |
| Live market source | Polymarket Gamma API, weather tag, ranked by liquidity |
| Forecast source | meteoblue (model temperature, exceedance percentiles, predictability index) |
| Observation source | METAR via meteoblue hourlyQcMetar, plus a NOAA secondary feed |
| Refresh | Markets every 30 s; orderbook every 2 s while open; static files cached 60 s |
| Login | Single user, cosmetic only — see Getting started |
| Stack | Node.js + Express, served behind nginx on a Linux VPS |
Note
This documentation describes the self-hosted build. Live market data depends on the
server being able to reach Polymarket; forecast and observation panels work from the
bundled static files regardless.
Forecasting dashboard documentation · Meteo Bulgaria EOOD · 2026