개별 실거래 내역
get_transactionsRead-onlyIdempotent
한 단지(또는 법정동)의 개별 거래를 최신순으로 준다 — 날짜·금액·면적·층까지. 다른 도구는 "최근 1년 102건"처럼 집계만 줘서 "가장 최근 거래가 언제 얼마"에 답할 수 없었다. "이 단지 최근 거래", "같은 평형 최근 10건", "직전 거래 대비 얼마나 올랐나"에 이 도구를 쓴다. ★아파트와 유형 전부 지원한다(kind 생략 시 아파트). ★전월세는 금액이 보증금·월세 둘이다 — price 하나로 뭉치지 말 것. 월세 0이면 순수 전세다. ★해제(취소)된 신고도 그대로 준다(canceled=true). 지우면 취소된 신고가를 확인할 방법이 없어서다 — 시세로 인용할 때는 반드시 빼고 말할 것. ★cid는 search_apartments·search_properties 응답에 들어 있다. 손으로 조립하지 말 것.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cid | Yes | 단지 식별자. 검색 응답의 cid를 그대로 쓴다 | |
| deal | No | 아파트만 해당. 기본 sale. rent면 전월세 실거래를 준다 | |
| kind | No | 기본 apt(아파트). ★_rent는 전월세라 응답 형식이 다르다 | |
| limit | No | 1~200, 기본 30 | |
| area_m2 | No | 전용면적(㎡)으로 거른다. ±1.5㎡ 안을 같은 평형으로 본다 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cid | Yes | ||
| deal | No | ||
| kind | Yes | ||
| items | Yes | 최신순. 매매=date·price·area_m2·floor·canceled · 전월세=date·deposit·monthly·area_m2·floor | |
| total | Yes | 그 단지의 전체 거래 수(반환 건수가 아니다) | |
| units | Yes | 축 이름 → 단위·뜻 설명. 숫자를 옮길 때 이 값을 그대로 읽는다 | |
| latest | No | 가장 최근 1건(해제 제외). 없으면 생략 | |
| notice | No | 참고용 통계라는 고지. 투자 자문·중개가 아니다 | |
| source | Yes | 데이터 출처와 갱신일 | |
| returned | Yes |