{"openapi":"3.1.0","info":{"title":"Weather alerts and forecasts (RealtimeAPI)","version":"7defc22f","description":"Weather alerts and forecasts served through the RealtimeAPI gateway. Pay per request in USDC with x402 (no account), or send an `X-API-Key` / `Authorization: Bearer rta_live_...` key. Each operation's `x-price` is the per-request price.","x-feed-slug":"weatherdata"},"servers":[{"url":"https://api.realtimeapi.ai/v1/weatherdata"}],"security":[{},{"ApiKeyHeader":[]},{"BearerKey":[]}],"paths":{"/alerts":{"get":{"operationId":"alerts","summary":"Active weather alerts","description":"Active alerts for a region: a US state (TX), an NWS zone or county code (TXZ229, TXC201), an Australian state (NSW) or a whole country (US, AU). Severity first, newest first. Refreshes every 60 seconds.","parameters":[{"name":"region","in":"query","required":true,"schema":{"type":"string"},"description":"US state, NWS UGC zone or county code, Australian state, or US / AU"},{"name":"severity","in":"query","required":false,"schema":{"type":["string","null"]},"description":"Extreme, Severe, Moderate, Minor or Unknown"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":500}}],"x-price":{"price":"$0.002","price_micro":2000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"weatherdata_alerts","x-cache-ttl-s":30,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"country":{"type":"string"},"coverage":{"type":"string"},"count":{"type":"integer"},"alerts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"country":{"type":"string"},"source":{"type":"string"},"event":{"type":"string"},"severity":{"type":"string"},"urgency":{"type":"string"},"certainty":{"type":"string"},"message_type":{"type":"string"},"headline":{"type":"string"},"sender":{"type":"string"},"areas":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}},"codes":{"type":"array","items":{"type":"string"}},"sent":{"type":"string","format":"date-time"},"onset":{"type":"string","format":"date-time"},"expires":{"type":"string","format":"date-time"},"ends":{"type":["string","null"],"format":"date-time"},"has_geometry":{"type":"boolean"},"detail_url":{"type":"string"}},"required":["id","country","source","event","severity","urgency","certainty","message_type","headline","sender","areas","regions","codes","sent","onset","expires","ends","has_geometry","detail_url"]}},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["region","country","coverage","count","alerts","as_of","next_update","status","data_age_s","source"]},"example":{"region":"TX","country":"US","coverage":"us","count":4,"alerts":[{"id":"urn:oid:2.49.0.1.840.0.9360ce98f35b5e546…","country":"US","source":"nws","event":"Flood Warning","severity":"Severe","urgency":"Expected","certainty":"Likely","message_type":"Alert","headline":"Flood Warning issued November 10 at 10:3…","sender":"NWS Austin/San Antonio TX","areas":["Val Verde, TX"],"regions":["TX"],"codes":["TXC465"],"sent":"2026-11-11T04:33:00Z","onset":"2026-11-11T05:00:00Z","expires":"2026-11-11T16:45:00Z","ends":"2026-11-11T20:00:00Z","has_geometry":true,"detail_url":"/weather/api/v1/alerts/urn:oid:2.49.0.1.…"}],"as_of":"2026-11-11T04:41:37Z","next_update":"2026-11-11T04:42:37Z","status":"fresh","data_age_s":27,"source":[{"publisher":"NOAA National Weather Service","licence":"US public domain","url":"https://api.weather.gov/alerts/active","retrieved_at":null}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/alerts/{alert_id}":{"get":{"operationId":"alerts-alert-id","summary":"One alert","description":"One alert by id with description, instruction, areas, zone codes and polygon. The id `latest` is the most severe active alert right now (a stable id for probes and examples). Refreshes every 60 seconds.","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string"}}],"x-price":{"price":"$0.002","price_micro":2000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"weatherdata_alerts-alert-id","x-cache-ttl-s":30,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"country":{"type":"string"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{}},"required":["publisher","licence","url","retrieved_at"]}},"event":{"type":"string"},"severity":{"type":"string"},"urgency":{"type":"string"},"certainty":{"type":"string"},"message_type":{"type":"string"},"headline":{"type":"string"},"sender":{"type":"string"},"areas":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}},"codes":{"type":"array","items":{"type":"string"}},"sent":{"type":"string","format":"date-time"},"onset":{},"expires":{"type":"string","format":"date-time"},"ends":{},"has_geometry":{"type":"boolean"},"detail_url":{"type":"string"},"active":{"type":"boolean"},"status":{"type":"string"},"description":{"type":"string"},"instruction":{},"effective":{"type":"string","format":"date-time"},"geometry":{},"web":{"type":"string"},"first_seen_at":{"type":"string","format":"date-time"},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"data_age_s":{"type":"integer"}},"required":["id","country","source","event","severity","urgency","certainty","message_type","headline","sender","areas","regions","codes","sent","onset","expires","ends","has_geometry","detail_url","active","status","description","instruction","effective","geometry","web","first_seen_at","as_of","next_update","data_age_s"]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/current":{"get":{"operationId":"current","summary":"Current conditions","description":"Latest report from the nearest reporting station within 150 km of a coordinate in the United States or Australia. Refreshes every 5 minutes.","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":-90,"maximum":90}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","minimum":-180,"maximum":180}}],"x-price":{"price":"$0.003","price_micro":3000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"weatherdata_current","x-cache-ttl-s":150,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"}},"required":["lat","lon"]},"coverage":{"type":"string"},"country":{"type":"string"},"nearest":{},"station":{"type":"object","properties":{"icao":{"type":"string"},"name":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"elev_m":{"type":"integer"},"state":{"type":"string"},"distance_m":{"type":"integer"}},"required":["icao","name","lat","lon","elev_m","state","distance_m"]},"observation":{"type":"object","properties":{"observed_at":{"type":"string","format":"date-time"},"report_type":{"type":"string"},"temp_c_milli":{"type":"integer"},"dewpoint_c_milli":{"type":"integer"},"wind_dir_deg":{"type":"integer"},"wind_ms_milli":{"type":"integer"},"gust_ms_milli":{},"visibility_m":{"type":"integer"},"pressure_hpa_milli":{"type":"integer"},"sky_cover":{},"cloud_base_m":{},"weather":{},"flight_category":{"type":"string"},"raw":{"type":"string"}},"required":["observed_at","report_type","temp_c_milli","dewpoint_c_milli","wind_dir_deg","wind_ms_milli","gust_ms_milli","visibility_m","pressure_hpa_milli","sky_cover","cloud_base_m","weather","flight_category","raw"]},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["query","coverage","country","nearest","station","observation","as_of","next_update","status","data_age_s","source"]},"example":{"query":{"lat":-33.87,"lon":151.21},"coverage":"au","country":"AU","nearest":null,"station":{"icao":"YSSY","name":"Sydney Intl","lat":-33.946,"lon":151.173,"elev_m":3,"state":"NS","distance_m":9115},"observation":{"observed_at":"2026-11-11T04:30:00Z","report_type":"METAR","temp_c_milli":25000,"dewpoint_c_milli":11000,"wind_dir_deg":30,"wind_ms_milli":6688,"gust_ms_milli":null,"visibility_m":9656,"pressure_hpa_milli":1012869,"sky_cover":null,"cloud_base_m":null,"weather":null,"flight_category":"VFR","raw":"METAR YSSY 110430Z 03013KT CAVOK 25/11 Q1013"},"as_of":"2026-11-11T04:30:00Z","next_update":"2026-11-11T04:35:00Z","status":"fresh","data_age_s":725,"source":[{"publisher":"NOAA Aviation Weather Center (METAR cache)","licence":"US public domain","url":"https://aviationweather.gov/data/cache/","retrieved_at":null}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/forecast/daily":{"get":{"operationId":"forecast-daily","summary":"Daily forecast","description":"Daily summary (min and max temperature, mean humidity and cloud, max wind and gust, precipitation total) for a coordinate in the contiguous United States or Australia, 1 to 5 days, aggregated per UTC day from the GFS hourly series. Refreshes every 60 minutes or on a new model cycle.","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":-90,"maximum":90}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","minimum":-180,"maximum":180}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":3,"minimum":1,"maximum":5}}],"x-price":{"price":"$0.005","price_micro":5000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"weatherdata_forecast-daily","x-cache-ttl-s":1800,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"}},"required":["lat","lon"]},"coverage":{"type":"string"},"country":{"type":"string"},"nearest":{},"model":{"type":"string"},"cell":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"distance_m":{"type":"integer"}},"required":["lat","lon","distance_m"]},"cycle":{"type":"string","format":"date-time"},"published_at":{"type":"string","format":"date-time"},"units":{"type":"object","properties":{"temp_c_milli":{"type":"string"},"wind_ms_milli":{"type":"string"},"precip_mm_milli":{"type":"string"},"rh_pct":{"type":"string"},"cloud_pct":{"type":"string"}},"required":["temp_c_milli","wind_ms_milli","precip_mm_milli","rh_pct","cloud_pct"]},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"hours_covered":{"type":"integer"},"temp_min_c_milli":{"type":"integer"},"temp_max_c_milli":{"type":"integer"},"rh_mean_pct":{"type":"integer"},"wind_max_ms_milli":{"type":"integer"},"gust_max_ms_milli":{"type":"integer"},"cloud_mean_pct":{"type":"integer"},"precip_total_mm_milli":{"type":"integer"}},"required":["date","hours_covered","temp_min_c_milli","temp_max_c_milli","rh_mean_pct","wind_max_ms_milli","gust_max_ms_milli","cloud_mean_pct","precip_total_mm_milli"]}},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["query","coverage","country","nearest","model","cell","cycle","published_at","units","days","as_of","next_update","status","data_age_s","source"]},"example":{"query":{"lat":-33.87,"lon":151.21},"coverage":"au","country":"AU","nearest":null,"model":"gfs-0p25","cell":{"lat":-33.75,"lon":151.25,"distance_m":13846},"cycle":"2026-11-11T00:00:00Z","published_at":"2026-11-11T04:34:14Z","units":{"temp_c_milli":"milli degrees C","wind_ms_milli":"milli m/s","precip_mm_milli":"milli mm within the step","rh_pct":"percent","cloud_pct":"percent"},"days":[{"date":"2026-11-11","hours_covered":23,"temp_min_c_milli":17290,"temp_max_c_milli":26079,"rh_mean_pct":74,"wind_max_ms_milli":6244,"gust_max_ms_milli":14301,"cloud_mean_pct":51,"precip_total_mm_milli":1248}],"as_of":"2026-11-11T04:34:14Z","next_update":"2026-11-11T10:34:14Z","status":"fresh","data_age_s":471,"source":[{"publisher":"NOAA NCEP Global Forecast System 0.25 de…","licence":"US public domain","url":"https://nomads.ncep.noaa.gov/","retrieved_at":null}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/forecast/hourly":{"get":{"operationId":"forecast-hourly","summary":"Hourly forecast","description":"GFS 0.25 degree hourly forecast at the nearest grid cell to a coordinate in the contiguous United States or Australia, 1 to 120 hours ahead (hourly to 48 h, then 3-hourly). Refreshes every 60 minutes or on a new model cycle.","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":-90,"maximum":90}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","minimum":-180,"maximum":180}},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","default":48,"minimum":1,"maximum":120}}],"x-price":{"price":"$0.005","price_micro":5000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"weatherdata_forecast-hourly","x-cache-ttl-s":1800,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"}},"required":["lat","lon"]},"coverage":{"type":"string"},"country":{"type":"string"},"nearest":{},"model":{"type":"string"},"cell":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"distance_m":{"type":"integer"}},"required":["lat","lon","distance_m"]},"cycle":{"type":"string","format":"date-time"},"published_at":{"type":"string","format":"date-time"},"units":{"type":"object","properties":{"temp_c_milli":{"type":"string"},"wind_ms_milli":{"type":"string"},"precip_mm_milli":{"type":"string"},"rh_pct":{"type":"string"},"cloud_pct":{"type":"string"}},"required":["temp_c_milli","wind_ms_milli","precip_mm_milli","rh_pct","cloud_pct"]},"hours":{"type":"array","items":{"type":"object","properties":{"t":{"type":"string","format":"date-time"},"step_h":{"type":"integer"},"temp_c_milli":{"type":"integer"},"rh_pct":{"type":"integer"},"wind_ms_milli":{"type":"integer"},"gust_ms_milli":{"type":"integer"},"precip_mm_milli":{"type":"integer"},"cloud_pct":{"type":"integer"}},"required":["t","step_h","temp_c_milli","rh_pct","wind_ms_milli","gust_ms_milli","precip_mm_milli","cloud_pct"]}},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["query","coverage","country","nearest","model","cell","cycle","published_at","units","hours","as_of","next_update","status","data_age_s","source"]},"example":{"query":{"lat":-33.87,"lon":151.21},"coverage":"au","country":"AU","nearest":null,"model":"gfs-0p25","cell":{"lat":-33.75,"lon":151.25,"distance_m":13846},"cycle":"2026-11-11T00:00:00Z","published_at":"2026-11-11T04:34:14Z","units":{"temp_c_milli":"milli degrees C","wind_ms_milli":"milli m/s","precip_mm_milli":"milli mm within the step","rh_pct":"percent","cloud_pct":"percent"},"hours":[{"t":"2026-11-11T04:00:00Z","step_h":1,"temp_c_milli":23262,"rh_pct":52,"wind_ms_milli":5736,"gust_ms_milli":7605,"precip_mm_milli":62,"cloud_pct":100},{"t":"2026-11-11T05:00:00Z","step_h":1,"temp_c_milli":23583,"rh_pct":52,"wind_ms_milli":4076,"gust_ms_milli":6015,"precip_mm_milli":0,"cloud_pct":100}],"as_of":"2026-11-11T04:34:14Z","next_update":"2026-11-11T10:34:14Z","status":"fresh","data_age_s":471,"source":[{"publisher":"NOAA NCEP Global Forecast System 0.25 degree (NOMADS)","licence":"US public domain","url":"https://nomads.ncep.noaa.gov/","retrieved_at":null}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/stations/near":{"get":{"operationId":"stations-near","summary":"Reporting stations near a point","description":"METAR reporting stations within a radius of a coordinate in the United States or Australia, nearest first. Refreshes every 24 hours.","parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","minimum":-90,"maximum":90}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","minimum":-180,"maximum":180}},{"name":"radius_km","in":"query","required":false,"schema":{"type":"number","default":50,"maximum":500}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"minimum":1,"maximum":100}}],"x-price":{"price":"$0.001","price_micro":1000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"weatherdata_stations-near","x-cache-ttl-s":21600,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"radius_km":{"type":"integer"}},"required":["lat","lon","radius_km"]},"coverage":{"type":"string"},"country":{"type":"string"},"nearest":{},"count":{"type":"integer"},"stations":{"type":"array","items":{"type":"object","properties":{"icao":{"type":"string"},"name":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"elev_m":{"type":"integer"},"country":{"type":"string"},"state":{"type":"string"},"distance_m":{"type":"integer"}},"required":["icao","name","lat","lon","elev_m","country","state","distance_m"]}},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["query","coverage","country","nearest","count","stations","as_of","next_update","status","data_age_s","source"]},"example":{"query":{"lat":-33.87,"lon":151.21,"radius_km":50},"coverage":"au","country":"AU","nearest":null,"count":4,"stations":[{"icao":"YSSY","name":"Sydney Intl","lat":-33.946,"lon":151.173,"elev_m":3,"country":"AU","state":"NS","distance_m":9115},{"icao":"YSBK","name":"Bankstown Arpt","lat":-33.918,"lon":150.987,"elev_m":6,"country":"AU","state":"NS","distance_m":21264}],"as_of":"2026-11-11T04:41:33Z","next_update":"2026-11-12T04:41:33Z","status":"fresh","data_age_s":32,"source":[{"publisher":"NOAA Aviation Weather Center (METAR cache)","licence":"US public domain","url":"https://aviationweather.gov/data/cache/","retrieved_at":null}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"},"BearerKey":{"type":"http","scheme":"bearer","description":"`rta_live_...` platform key"}},"headers":{"PaymentRequired":{"description":"Base64-encoded JSON x402 payment requirements (same as the body).","schema":{"type":"string"}},"PaymentResponse":{"description":"Base64-encoded JSON x402 settlement receipt (paid requests only).","schema":{"type":"string"}},"Price":{"description":"Per-request price of this endpoint, e.g. `$0.010` (charged only on a paid 2xx; covered by the key in API-key mode).","schema":{"type":"string"}},"Cache":{"description":"`HIT` or `MISS`.","schema":{"type":"string","enum":["HIT","MISS"]}},"CacheLayer":{"description":"On a hit: `edge` (this data centre's cache), `global` (the quality probe's copy) or `region` (the copy kept fresh in your region; `X-RTAPI-Data-Age` says how old).","schema":{"type":"string","enum":["edge","global","region"]}},"CacheTtl":{"description":"The endpoint's cache TTL in seconds (cacheable endpoints only).","schema":{"type":"integer"}},"DataAge":{"description":"Seconds since the gateway took its copy from the provider (0 when the answer is live). The data's own timestamp, if any, is in the body.","schema":{"type":"integer"}},"CachedAt":{"description":"Unix milliseconds the gateway's copy was taken from the provider (hits only).","schema":{"type":"integer"}},"Remaining":{"description":"API-key mode: calls left in the key's current period (also `X-RateLimit-Remaining`).","schema":{"type":"integer"}},"RateLimitLimit":{"description":"API-key mode: the key's calls per period.","schema":{"type":"integer"}},"RateLimitReset":{"description":"API-key mode: unix seconds the period resets.","schema":{"type":"integer"}},"QuotaSource":{"description":"API-key mode: `do` when the quota figures are the counter's exact answer, `memo` when a cached answer was served ahead of the count (figures then approximate by a few calls; a 429 is always exact).","schema":{"type":"string","enum":["do","memo"]}},"ServerTiming":{"description":"One entry per phase the request ran (`kv`, `auth`, `quota`, `cache`, `upstream`, `settle`) and `total`, the gateway's time to first byte; `desc` names the source (`cache;dur=3;desc=\"edge\"`).","schema":{"type":"string"}},"GatewayMs":{"description":"The gateway's own time to first byte: `total` minus `upstream` and `settle`.","schema":{"type":"integer"}}},"responses":{"PaymentRequired":{"description":"Payment required. Retry with an x402 `PAYMENT-SIGNATURE` (or `X-PAYMENT`) header for one of `accepts`, or with an API key.","headers":{"PAYMENT-REQUIRED":{"$ref":"#/components/headers/PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"Error":{"description":"Error envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"PaymentRequirements":{"type":"object","required":["scheme","network","payTo","asset"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string","examples":["eip155:8453"]},"payTo":{"type":"string"},"price":{"type":"string","examples":["$0.010"]},"asset":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"resource":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"}}},"PaymentRequired":{"type":"object","required":["x402Version","accepts","error"],"properties":{"x402Version":{"type":"integer","const":2},"accepts":{"type":"array","items":{"$ref":"#/components/schemas/PaymentRequirements"}},"error":{"type":"string"},"alternatives":{"type":"object","properties":{"api_key_purchase":{"type":"string","format":"uri"},"docs":{"type":"string","format":"uri"}}}}},"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}}}}},"x-x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"externalDocs":{"url":"https://realtimeapi.ai/feeds/weatherdata"}}