get_apartment_trades
Retrieve apartment sale records and summary statistics including median, min, and max prices for a specific region and month.
Instructions
Return apartment sale records and summary statistics for a region and month.
Korean keywords: 아파트
Use summary.median_price_10k as the reference price and
min/max_price_10k to present the price range.
To compute jeonse ratio, call get_apartment_rent for the same region and
month, then divide rent summary.median_deposit_10k by this
summary.median_price_10k.
region_code must be obtained first via the get_region_code tool.
Query strategy:
- For price trend analysis, call this tool for each of the 6 consecutive
months preceding the current month.
- To check year-over-year changes, also query the same month across
3 years (e.g. 202412, 202312, 202212).
Args:
region_code: 5-digit legal district code (returned by get_region_code).
year_month: Target year-month in YYYYMM format (e.g. "202501").
Call get_current_year_month if not specified by the user.
num_of_rows: Maximum number of records to return. Default 100.
Returns:
total_count: Total record count from the API
items: Trade list (apt_name, dong, area_sqm, floor,
price_10k, trade_date, build_year, deal_type)
summary: median/min/max price_10k, sample_count
error/message: Present on API error or network failure
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year_month | Yes | ||
| num_of_rows | No | ||
| region_code | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||