{"openapi": "3.0.3", "info": {"title": "KR Apartment Trades", "version": "0.1.0", "description": "Korean apartment sale transactions (MOLIT register) as normalised trades, medians and trends. Observed values only."}, "servers": [{"url": "https://apt.pokt-agent.com"}], "paths": {"/v1/version": {"get": {"summary": "Identity", "responses": {"200": {"description": "service id, version, key_configured"}}}}, "/v1/health": {"get": {"summary": "Readiness", "responses": {"200": {"description": "{status: ok}"}}}}, "/v1/regions": {"get": {"summary": "Named regions and English aliases", "responses": {"200": {"description": "kr-apt-regions/v1"}}}}, "/v1/trades": {"get": {"summary": "Trades in one district and month, with summary", "parameters": [{"name": "region", "in": "query", "required": true, "schema": {"type": "string"}, "description": "5-digit LAWD_CD, Korean name (강남구) or English alias (gangnam)"}, {"name": "month", "in": "query", "schema": {"type": "string", "pattern": "^\\d{6}$"}}, {"name": "apt", "in": "query", "schema": {"type": "string"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 50}}], "responses": {"200": {"description": "kr-apt-trades/v1"}, "503": {"description": "KEY_NOT_CONFIGURED"}}}}, "/v1/trend": {"get": {"summary": "Monthly count, median price and median price per m2", "parameters": [{"name": "region", "in": "query", "required": true, "schema": {"type": "string"}, "description": "5-digit LAWD_CD, Korean name (강남구) or English alias (gangnam)"}, {"name": "months", "in": "query", "schema": {"type": "integer", "default": 6, "maximum": 24}}, {"name": "apt", "in": "query", "schema": {"type": "string"}}], "responses": {"200": {"description": "kr-apt-trend/v1"}}}}, "/v1/complex": {"get": {"summary": "One complex across months", "parameters": [{"name": "region", "in": "query", "required": true, "schema": {"type": "string"}, "description": "5-digit LAWD_CD, Korean name (강남구) or English alias (gangnam)"}, {"name": "apt", "in": "query", "required": true, "schema": {"type": "string"}}, {"name": "months", "in": "query", "schema": {"type": "integer", "default": 12}}], "responses": {"200": {"description": "kr-apt-complex/v1"}}}}, "/v1/query": {"post": {"summary": "Deterministic question (ko/en)", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"question": {"type": "string"}, "region": {"type": "string"}, "month": {"type": "string"}, "apt": {"type": "string"}, "months": {"type": "integer"}}}}}}, "responses": {"200": {"description": "kr-apt-answer/v1"}}}}}}