Korea Ground-Truth / Tools / apartment_trade_prices
아파트 실거래가 조회 API — 시군구·월별 매매 거래 내역 (국토교통부)
Korean Apartment Transaction Price API (MOLIT real transaction data)
Cost: 3 credits/call (cache hit: 1). ≈ 30원/호출 · 출처: 국토교통부 (data.go.kr) · 캐시 24시간
어떤 문제를 푸나
특정 시군구의 월별 아파트 매매 실거래 내역(단지명, 거래금액, 전용면적, 층, 건축년도, 계약일, 해제 여부)이 필요합니다. 금액은 원 단위 정수로 변환해 계산에 바로 쓸 수 있습니다.
- 시세 비교·감정 보조
- 부동산 리포트 자동 생성
- 임대차 계약 전 주변 시세 확인
- 지역별 거래량 모니터링
호출 방법
REST
curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/tools/apartment_trade_prices \
-H "Authorization: Bearer kgt_live_..." \
-H "content-type: application/json" \
-d '{"lawd_code":"11680","deal_month":"202507","per_page":2}'MCP (Claude Code / Cursor / any MCP client)
claude mcp add --transport http kgt https://kr-groundtruth-mcp.vercel.app/api/mcp --header "Authorization: Bearer kgt_live_..."
# then ask: "apartment_trade_prices 툴로 {"lawd_code":"11680","deal_month":"202507","per_page":2} 조회해줘"API 키 발급 (사람 불필요, 무료 50 credits)
curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/accounts -H "content-type: application/json" -d '{"email":"you@example.com"}'입력
| field | type | required | description |
|---|---|---|---|
lawd_code | string | yes | 법정동코드 앞 5자리 (시군구) |
deal_month | string | yes | 계약년월 YYYYMM |
page | integer | no (default 1) | |
per_page | integer | no (default 100) |
응답 예시 (실제 응답, 2026-08-26)
{
"ok": true,
"data": {
"source": "국토교통부 아파트 매매 실거래가 (data.go.kr)",
"lawd_code": "11680",
"deal_month": "202507",
"total": 376,
"page": 1,
"results": [
{
"apartment_name": "신현대12차",
"deal_amount_krw": 8300000000,
"deal_amount_raw": "830,000",
"deal_date": "2025-07-14",
"exclusive_area_m2": 155.52,
"floor": 1,
"build_year": 1982,
"dong": "압구정동",
"jibun": "434",
"road_name": null,
"sigungu_code": "11680",
"deal_type": "중개거래",
"canceled": false,
"canceled_date": null,
"seller_type": "개인",
"buyer_type": "개인"
},
{
"apartment_name": "래미안 개포 루체하임",
"deal_amount_krw": 3300000000,
"deal_amount_raw": "330,000",
"deal_date": "2025-07-11",
"exclusive_area_m2": 84.97,
"floor": 12,
"build_year": 2018,
"dong": "일원동",
"jibun": "741",
"road_name": null,
"sigungu_code": "11680",
"deal_type": "중개거래",
"canceled": false,
"canceled_date": null,
"seller_type": "개인",
"buyer_type": "개인"
}
]
},
"meta": {
"tool": "apartment_trade_prices",
"cost": 3,
"balance_remaining": 48,
"cache_hit": false,
"source": "국토교통부 (data.go.kr)",
"fetched_at": "2026-08-26T14:00:00.000Z",
"usage_event_id": "usg_…"
}
}모든 응답은 meta.cost, meta.balance_remaining를 포함합니다. 업스트림 오류 시 자동 환불되며, 잔액 부족 시 402 INSUFFICIENT_CREDITS와 함께 충전 URL이 반환됩니다.
함께 쓰는 툴
- 주소 정규화 API — 도로명주소·우편번호·법정동코드 변환 — Cost: 1 credit/call (cache hit: 1).