# 1gateway South Korean Apartment Trade Summary

> 1gateway South Korean Apartment Trade Summary 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 aggregated market statistics (count, median/avg price, price per m², price per pyeong) for apartment trades in a South Korean district-month, excluding cancelled deals, sourced from MOLIT data.

## Facts

- Endpoint: GET https://1gateway.dev/v1/realestate/apartment-trades/summary?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-south-korean-apartment-trade-summary-4e60fe7f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RV5V_ZVcbhGMtX71sUEEy

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-south-korean-apartment-trade-summary-4e60fe7f
```

Example prompt: What's the apartment market snapshot for Gangnam-gu (region code 11680) in September 2024 — give me the median and average prices in both KRW and USD, price per square meter, and a breakdown by apartment size class, excluding any cancelled deals.

## When to prefer this

Choose this endpoint when you need a pre-aggregated statistical snapshot of a South Korean apartment district-month rather than raw individual trade records. It is ideal for market research, investment analysis, trend tracking, or any use case where you want summary statistics (median, average, price per m², price per pyeong) with cancelled deals already excluded and USD conversion already applied. Prefer this over raw trade endpoints when you don't need individual transaction details but want fast, structured market-level insights.

## Known failure modes

- Unknown or invalid LAWD_CD returns HTTP 400 (not charged)
- Month outside valid range (before 200601 or in the future) returns 400
- Malformed month pattern (not YYYYMM) returns 400
- No trades recorded for that district-month returns empty summary or zero count
- x402 payment failure results in 402 response before data is returned
- MOLIT upstream data not yet available for very recent months may return incomplete data

## 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

A JSON object containing: region metadata (district name in English and Korean, province), summary statistics overall (count, median price KRW/USD, average price KRW/USD, max/min price, price per m² and per pyeong in KRW/USD), a breakdown of the same stats by apartment area class (small, medium, large buckets), top complexes by volume or price, count of cancelled deals excluded, cache metadata, and attribution to MOLIT source data. All prices are in KRW and USD.

## 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": [
      "region",
      "month"
     ],
     "properties": {
      "month": {
       "type": "string",
       "pattern": "^(19|20)\\d{2}(0[1-9]|1[0-2])$",
       "examples": [
        "202609"
       ],
       "description": "Contract month YYYYMM, 200601 to the current month (KST)"
      },
      "region": {
       "type": "string",
       "pattern": "^\\d{5}$",
       "examples": [
        "11680"
       ],
       "description": "5-digit 시군구 code (LAWD_CD), e.g. 11680 = Seoul Gangnam-gu. Unknown codes → 400 (not charged)."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "region",
      "month",
      "currency",
      "attribution",
      "cache",
      "methodology",
      "summary"
     ],
     "properties": {
      "cache": {
       "type": "string"
      },
      "month": {
       "type": "string"
      },
      "region": {
       "type": "object",
       "properties": {
        "code": {
         "type": "string"
        },
        "known": {
         "type": "boolean"
        },
        "districtEn": {
         "type": "string"
        },
        "districtKo": {
         "type": "string"
        },
        "provinceEn": {
         "type": "string"
        },
        "provinceKo": {
         "type": "string"
        }
       }
      },
      "summary": {
       "type": "object",
       "properties": {
        "byArea": {
         "type": "array",
         "items": {
          "type": "object",
          "properties": {
           "count": {
            "type": "integer"
           },
           "label": {
            "type": "string"
           },
           "bucket": {
            "type": "string"
           },
           "avgPriceKrw": {
            "type": "integer"
           },
           "avgPriceUsd": {
            "type": "integer"
           },
           "maxPriceKrw": 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "month": "2024-09",
  "region": {
   "code": "11680",
   "districtEn": "Gangnam-gu"
  },
  "summary": {
   "overall": {
    "count": 403,
    "medianPriceKrw": 2450000000,
    "medianPriceUsd": 1788000,
    "medianPricePerM2Krw": 28800000
   },
   "totalReported": 412,
   "cancelledExcluded": 9
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/1gateway-south-korean-apartment-trade-summary-4e60fe7f/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)