# 1gateway Korean Weather Forecast

> 1gateway Korean Weather Forecast is a paid API for AI agents from 1gateway.dev, paid per call via x402, $0.0045/call, status unknown (last checked 2026-10-10).

Returns the official Korea Meteorological Administration (KMA) village-level weather forecast for any point in South Korea for the next ~5 days, including hourly temperature, precipitation, wind, sky, and daily min/max.

## Facts

- Endpoint: GET https://1gateway.dev/v1/weather/forecast?utm_source=zero.xyz
- Price: $0.0045/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/1gateway-korean-weather-forecast-2a70edc8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ULVFlkQTBvdkV6O0YpgWB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 1gateway-korean-weather-forecast-2a70edc8
```

Example prompt: What's the official KMA weather forecast for Seoul (37.5665, 126.978) for the next 5 days — give me hourly temperature, rain probability, and daily highs and lows?

## When to prefer this

Choose this endpoint when you need official, authoritative Korean government weather data (KMA) for any point in South Korea — especially for applications requiring accurate, hyper-local forecasts on a 5 km grid with precipitation type, snow amounts, and wind details. Prefer this over generic global weather APIs when South Korea coverage accuracy and official sourcing are important, or when the user specifically needs KMA data.

## Known failure modes

- Coordinates outside KMA domain (lat <32 or >44, lon <123 or >133) return HTTP 400 and are not charged
- KMA API temporarily unavailable may return a 5xx error
- Stale or cached data if KMA has not issued a new forecast recently
- Floating-point precision issues in lat/lon may snap to a different 5km grid cell than intended

## How this service works

1gateway is a pay-per-call API gateway for AI agents and developers: data APIs normalized to clean English JSON, paid per request with USDC on Base via x402 — no signup, no API key. Current coverage: Korean data (real estate trades, weather forecasts, holidays); more APIs and countries are coming.

## Output

Returns a JSON object with: a location object (lat, lon, KMA grid coordinates), an issuedAt timestamp, timezone, attribution, cache info, an hourly array (each entry has time, resolution, temperatureC, sky, precipitationType, precipitationProbabilityPct, precipitation1h, snowfall1h, humidityPct, windSpeedMs, windDirectionDeg, windEastwardMs, windNorthwardMs, waveHeightM, windCategory), and a daily array (date, minTempC, maxTempC, maxPopPct).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "maximum": 44,
       "minimum": 32,
       "examples": [
        37.5665
       ],
       "description": "Latitude, WGS84 decimal degrees (KMA domain ≈ 32–44; outside → 400, not charged)"
      },
      "lon": {
       "type": "number",
       "maximum": 133,
       "minimum": 123,
       "examples": [
        126.978
       ],
       "description": "Longitude, WGS84 decimal degrees (KMA domain ≈ 123–133)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "location",
      "issuedAt",
      "timezone",
      "attribution",
      "cache",
      "hourly",
      "daily"
     ],
     "properties": {
      "cache": {
       "type": "string"
      },
      "daily": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "date": {
          "type": "string"
         },
         "maxTempC": {
          "type": [
           "integer",
           "null"
          ]
         },
         "minTempC": {
          "type": [
           "integer",
           "null"
          ]
         },
         "maxPopPct": {
          "type": "integer"
         }
        }
       }
      },
      "hourly": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "sky": {
          "type": "string"
         },
         "time": {
          "type": "string"
         },
         "resolution": {
          "type": "string"
         },
         "snowfall1h": {
          "type": "object",
          "properties": {
           "cm": {
            "type": "integer"
           },
           "raw": {
            "type": "string"
           },
           "category": {
            "type": "string"
           }
          }
         },
     
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "daily": [
   {
    "date": "2026-10-09",
    "maxTempC": 23,
    "minTempC": 14
   }
  ],
  "hourly": [
   {
    "sky": "clear",
    "time": "2026-10-09T12:00:00+09:00",
    "temperatureC": 21,
    "precipitationType": "none",
    "precipitationProbabilityPct": 0
   }
  ],
  "issuedAt": "2026-10-09T11:00:00+09:00",
  "location": {
   "lat": 37.5665,
   "lon": 126.978,
   "gridNx": 60,
   "gridNy": 127
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/1gateway-korean-weather-forecast-2a70edc8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 1gateway.dev](https://www.zero.xyz/host/1gateway.dev/llms.txt)