# METAR.ws Docs - [Introduction](https://docs.metar.ws/index.md): Near real-time aviation weather over WebSocket: METAR observations, D-ATIS reports, and numerical model forecasts. - [Quickstart](https://docs.metar.ws/quickstart.md): Connect to the metar.ws WebSocket stream and receive your first message in minutes. - [Authentication](https://docs.metar.ws/authentication.md): Authenticate your WebSocket connection with an API key issued in the customer portal. - [Sandbox Mode](https://docs.metar.ws/sandbox-mode.md): A full-fidelity integration environment on the free plan, with a fixed demo channel instead of measured weather. - [Channels Overview](https://docs.metar.ws/channels/overview.md): Four data namespaces, one per-airport addressing scheme, and a replay mechanism that gets you current state instantly. - [Plans & Limits](https://docs.metar.ws/plans-and-limits.md): Compare Sandbox, Basic, Starter and Pro, and see how connections, channels and API keys are counted. - [METAR Observations](https://docs.metar.ws/channels/metar-observations.md): Official METAR reports for roughly 50 stations across four continents, delivered within milliseconds of publication. - [Frequent Observations](https://docs.metar.ws/channels/frequent-observations.md): High-frequency measured weather for Netherlands, France and US stations, refreshed every 5 to 10 minutes between official METAR reports. - [D-ATIS Fast Lane](https://docs.metar.ws/channels/atis-fast-lane.md): Pro-only METAR-equivalent weather extracted from FAA D-ATIS broadcasts, usually available minutes before the official METAR. - [Model Forecasts](https://docs.metar.ws/channels/model-forecasts.md): Daily max/min temperature forecasts from global and high-resolution numerical weather models. - [Historical METAR/SPECI](https://docs.metar.ws/historical-data/historical-metar-speci.md) - [Connection Lifecycle](https://docs.metar.ws/protocol/connection-lifecycle.md): Every frame in both directions is a single JSON object. Here is what the server sends the moment your connection is accepted. - [Commands](https://docs.metar.ws/protocol/commands.md): Two client commands, subscribe and unsubscribe, selected by the top-level action field. - [Publication Messages](https://docs.metar.ws/protocol/messages.md): The publication frame is how the server delivers observations and forecasts once you're subscribed. - [Errors](https://docs.metar.ws/protocol/errors.md): Error frames are informational and never close the connection on their own. - [Heartbeats & Reconnection](https://docs.metar.ws/protocol/heartbeats-reconnection.md): The server pings every 20 seconds, and the protocol is stateless enough that reconnecting is always safe. - [Python](https://docs.metar.ws/examples/python.md): A complete, reconnecting WebSocket client using the websockets library. - [Node.js](https://docs.metar.ws/examples/nodejs.md): A complete, reconnecting WebSocket client using the ws package. - [Go](https://docs.metar.ws/examples/go.md): A complete, reconnecting WebSocket client using gorilla/websocket. - [Browser](https://docs.metar.ws/examples/browser.md): A minimal client for internal dashboards. Proxy the stream through your backend for public-facing products. - [Best Practices](https://docs.metar.ws/best-practices.md): A checklist of practical tips gathered from across this reference for building a reliable client. - [FAQ](https://docs.metar.ws/faq.md): Quick answers to common integration questions. - [Support](https://docs.metar.ws/support.md): How to reach the metar.ws team and manage your subscription. - [Changelog](https://docs.metar.ws/untitled-page.md): Recent fixes and protocol updates to the METAR.ws stream. ## Optional - [Visit website](https://metar.ws) - [Blog](https://metar.ws/blog) - [Documentation](https://docs.metar.ws) - [Open App](https://app.metar.ws) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.