실거래 조회
search_dealsQuery official Korean real-estate transaction records by region, property type, deal type, date, area, or complex name to review recent sales and rent data.
Instructions
국토교통부 실거래 원자료를 최신순으로 조회합니다. 금액은 원 단위입니다. 시세·전세가율 계산이 필요하면 market_summary, jeonse_ratio를 쓰세요.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"propertyType": "<propertyType>",
"dealType": "<dealType>",
"region": "<region>"
},
"name": "search_deals"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | 끝 계약년월 YYYYMM (기본 이번 달) | |
| from | No | 시작 계약년월 YYYYMM (months 대신, 최대 24개월) | |
| name | No | 단지·건물 이름 (공백 무시 부분 일치). 예: '래미안푸르지오' | |
| limit | No | 돌려줄 건수 (기본 20, 최대 50) | |
| months | No | 최근 몇 개월 (1~24, 기본 3) | |
| region | Yes | 지역. 예: '마포구 아현동', '수원시 영통구', '세종', 시군구 코드 5자리, 법정동코드 10자리 | |
| areaMax | No | 최대 면적 ㎡ | |
| areaMin | No | 최소 면적 ㎡ | |
| dealType | Yes | sale 매매, rent 전월세 (apt·rh·sh·offi만) | |
| propertyType | Yes | apt 아파트, rh 연립·다세대, sh 단독·다가구, offi 오피스텔, presale 분양·입주권, commercial 상업업무용, land 토지, industrial 공장·창고 | |
| includeCancelled | No | 해제된 거래 포함 (기본 false) |