# Seoul Weather API — Historical Data

> Seoul Weather API — Historical Data is a paid API for AI agents from seoul-weather-402.fly.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns historical hourly weather records for Seoul, South Korea sourced from the Korea Meteorological Administration (KMA), paid via $0.01 USDC on Base Mainnet.

## Facts

- Endpoint: GET https://seoul-weather-402.fly.dev/weather/seoul/history
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/seoul-weather-api-historical-data-1c7bc37d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_znwOD8l0rHARVZGmh9aso

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 seoul-weather-api-historical-data-1c7bc37d
```

Example prompt: Can you pull the historical weather records for Seoul from the KMA data feed — I need the hourly conditions and temperatures?

## When to prefer this

Choose this endpoint when you specifically need historical (past) hourly weather data for Seoul, South Korea sourced directly from the Korea Meteorological Administration, and your agent stack supports x402 micropayments on Base Mainnet at $0.01 per call. Prefer this over general weather APIs when KMA provenance or Seoul-specific historical granularity matters.

## Known failure modes

- Payment failure: USDC transaction on Base Mainnet not completed, request blocked
- Service unavailable: fly.dev instance down or cold-starting, returns 5xx
- KMA upstream outage: source data unavailable, may return empty data array
- Invalid query parameters: malformed request returns 4xx error
- Rate limiting: too many concurrent requests may result in throttling

## How this service works

Seoul historical weather observations — query by date range (up to 31 days)

## Output

A JSON array of up to 24 hourly weather records for Seoul, each containing a UTC timestamp, a condition label (e.g. 'clear'), and a temperature in Celsius, along with a total count and location string ('Seoul, South Korea').

## 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",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "time": "2026-05-01T09:00:00Z",
    "condition": "clear",
    "temperature": {
     "celsius": 18
    }
   }
  ],
  "count": 24,
  "location": "Seoul, South Korea"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/seoul-weather-api-historical-data-1c7bc37d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from seoul-weather-402.fly.dev](https://www.zero.xyz/host/seoul-weather-402.fly.dev/llms.txt)