{"openapi": "3.0.3", "info": {"title": "KR Rates & FX", "version": "0.1.0", "description": "Official Korean interest rates (BoK ECOS) and won exchange rates (KEXIM, Korea Customs Service), each value dated and sourced. No forecasts."}, "servers": [{"url": "https://rates.pokt-agent.com"}], "paths": {"/v1/version": {"get": {"summary": "Identity", "responses": {"200": {"description": "service id, version, keys_configured"}}}}, "/v1/health": {"get": {"summary": "Readiness", "responses": {"200": {"description": "{status: ok}"}}}}, "/v1/rates": {"get": {"summary": "All rates with previous value, change in bp and curve spreads", "parameters": [{"name": "date", "in": "query", "schema": {"type": "string", "format": "date"}, "description": "as-of date (KST), default today"}], "responses": {"200": {"description": "kr-rates/v1"}}}}, "/v1/rate": {"get": {"summary": "One series history", "parameters": [{"name": "series", "in": "query", "required": true, "schema": {"type": "string", "enum": ["base", "call", "kofr", "cd91", "cp91", "msb91d", "msb1y", "msb2y", "ktb1y", "ktb2y", "ktb3y", "ktb5y", "ktb10y", "ktb20y", "ktb30y", "ktb50y", "corp3y_aa", "corp3y_bbb"]}}, {"name": "days", "in": "query", "schema": {"type": "integer", "default": 30}}, {"name": "date", "in": "query", "schema": {"type": "string", "format": "date"}, "description": "as-of date (KST), default today"}], "responses": {"200": {"description": "kr-rate-history/v1"}}}}, "/v1/fx": {"get": {"summary": "KRW deal basis, TTB, TTS (KEXIM)", "parameters": [{"name": "ccy", "in": "query", "schema": {"type": "string", "default": "USD"}, "description": "comma-separated ISO codes"}, {"name": "date", "in": "query", "schema": {"type": "string", "format": "date"}, "description": "as-of date (KST), default today"}], "responses": {"200": {"description": "kr-fx/v1"}, "503": {"description": "KEY_NOT_CONFIGURED"}}}}, "/v1/convert": {"get": {"summary": "Indicative conversion at deal basis rates", "parameters": [{"name": "amount", "in": "query", "required": true, "schema": {"type": "number"}}, {"name": "from", "in": "query", "schema": {"type": "string", "default": "USD"}}, {"name": "to", "in": "query", "schema": {"type": "string", "default": "KRW"}}, {"name": "date", "in": "query", "schema": {"type": "string", "format": "date"}, "description": "as-of date (KST), default today"}], "responses": {"200": {"description": "kr-convert/v1"}}}}, "/v1/customs-fx": {"get": {"summary": "Weekly customs FX (Customs Act art. 18)", "parameters": [{"name": "ccy", "in": "query", "schema": {"type": "string", "default": "USD"}, "description": "comma-separated ISO codes"}, {"name": "kind", "in": "query", "schema": {"type": "string", "enum": ["import", "export"]}}, {"name": "date", "in": "query", "schema": {"type": "string", "format": "date"}, "description": "as-of date (KST), default today"}], "responses": {"200": {"description": "kr-customs-fx/v1"}}}}, "/v1/query": {"post": {"summary": "Deterministic question (ko/en)", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"question": {"type": "string"}, "date": {"type": "string"}}}}}}, "responses": {"200": {"description": "kr-rates-fx-answer/v1"}}}}}}