{"uid":"cap_RV5V_ZVcbhGMtX71sUEEy","slug":"1gateway-south-korean-apartment-trade-summary-4e60fe7f","name":"1gateway South Korean Apartment Trade Summary","description":"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.","url":"https://1gateway.dev/v1/realestate/apartment-trades/summary?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":{"type":"integer"},"minPriceKrw":{"type":"integer"},"medianPriceKrw":{"type":"integer"},"medianPriceUsd":{"type":"integer"},"avgPricePerM2Krw":{"type":"integer"},"avgPricePerM2Usd":{"type":"number"},"medianPricePerM2Krw":{"type":"integer"},"medianPricePerM2Usd":{"type":"number"},"medianPricePerPyeongKrw":{"type":"integer"}}}},"overall":{"type":"object","properties":{"count":{"type":"integer"},"avgPriceKrw":{"type":"integer"},"avgPriceUsd":{"type":"integer"},"maxPriceKrw":{"type":"integer"},"minPriceKrw":{"type":"integer"},"medianPriceKrw":{"type":"integer"},"medianPriceUsd":{"type":"integer"},"avgPricePerM2Krw":{"type":"integer"},"avgPricePerM2Usd":{"type":"number"},"medianPricePerM2Krw":{"type":"integer"},"medianPricePerM2Usd":{"type":"number"},"medianPricePerPyeongKrw":{"type":"integer"}}},"topComplexes":{"type":"array","items":{"type":"object","properties":{"trades":{"type":"integer"},"complexNameEn":{"type":"string"},"complexNameKo":{"type":"string"},"medianPricePerM2Krw":{"type":"integer"}}}},"dealTypeShare":{"type":"object","properties":{"direct":{"type":"integer"},"brokered":{"type":"integer"}}},"totalReported":{"type":"integer"},"cancelledExcluded":{"type":"integer"}}},"currency":{"type":"object","properties":{"base":{"type":"string"},"fxAsOf":{"type":"string"},"fxSource":{"type":"string"},"converted":{"type":"string"},"krwPerUsd":{"type":"number"}}},"attribution":{"type":"string"},"methodology":{"type":"string"}}}}}}},"responseSchema":{"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}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0045","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0045/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0045","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0045","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fvwV0j5mB655JbMtvVUYj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0045","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Monthly Seoul district price check","prompt":"What were the median and average apartment sale prices in Seoul's Mapo-gu (region code 11440) for August 2024, broken down by apartment size, in both Korean won and USD?"},{"title":"Cross-district investment comparison","prompt":"I'm comparing apartment markets — can you pull the market summary for Seocho-gu (11650) and Gangnam-gu (11680) for October 2024? I want median price per square meter in KRW for each so I can compare them side by side."},{"title":"Quarterly trend tracking for Korean real estate","prompt":"Pull the apartment trade summary for Songpa-gu (region 11710) for each month from July to September 2024 — I want the total transaction count and median price per pyeong so I can track price trends over the quarter."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:37:52.093Z","isFirstParty":false,"canonicalSlug":"1gateway-south-korean-apartment-trade-summary-4e60fe7f"}