{"openapi": "3.0.3", "info": {"title": "KR Market Data", "version": "0.1.0", "description": "Upbit/Bithumb KRW market data, USD/KRW and kimchi premium for agents. Observed values only."}, "servers": [{"url": "https://kr.pokt-agent.com"}], "paths": {"/v1/version": {"get": {"summary": "Identity", "responses": {"200": {"description": "service id and version"}}}}, "/v1/health": {"get": {"summary": "Readiness", "responses": {"200": {"description": "{status: ok}"}}}}, "/v1/markets": {"get": {"summary": "KRW markets (Upbit list, Bithumb listing flag), names ko/en", "responses": {"200": {"description": "kr-market-markets/v1"}}}}, "/v1/fx": {"get": {"summary": "USDKRW from Yahoo intraday and exchangerate-api daily", "responses": {"200": {"description": "kr-market-fx/v1"}}}}, "/v1/ticker/{symbol}": {"get": {"summary": "KRW ticker on Upbit and Bithumb", "parameters": [{"name": "symbol", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^[A-Za-z0-9]{2,12}$"}, "example": "BTC"}], "responses": {"200": {"description": "kr-market-ticker/v1"}, "400": {"description": "bad symbol"}}}}, "/v1/orderbook/{symbol}": {"get": {"summary": "Top-of-book on both venues", "parameters": [{"name": "symbol", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^[A-Za-z0-9]{2,12}$"}, "example": "BTC"}, {"name": "depth", "in": "query", "schema": {"type": "integer", "default": 5, "maximum": 30}}], "responses": {"200": {"description": "kr-market-orderbook/v1"}}}}, "/v1/premium/{symbol}": {"get": {"summary": "Kimchi premium per venue vs Binance USDT x USDKRW", "parameters": [{"name": "symbol", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^[A-Za-z0-9]{2,12}$"}, "example": "BTC"}], "responses": {"200": {"description": "kr-market-premium/v1"}}}}, "/v1/executable/{symbol}": {"get": {"summary": "Orderbook-walked average fill price for a quantity: coverage, slippage, fee, data lag per venue", "parameters": [{"name": "symbol", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^[A-Za-z0-9]{2,12}$"}, "example": "BTC"}, {"name": "qty", "in": "query", "required": true, "schema": {"type": "number"}}, {"name": "side", "in": "query", "schema": {"type": "string", "enum": ["buy", "sell"], "default": "buy"}}, {"name": "fee_pct", "in": "query", "schema": {"type": "number", "default": 0}}, {"name": "depth", "in": "query", "schema": {"type": "integer", "default": 30, "maximum": 30}}], "responses": {"200": {"description": "kr-market-executable/v1"}, "400": {"description": "bad quantity or fee"}}}}, "/v1/query": {"post": {"summary": "Deterministic question (ko/en) -> one of the endpoints above", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"question": {"type": "string", "example": "비트코인 김치 프리미엄 얼마야?"}, "symbol": {"type": "string"}, "depth": {"type": "integer"}}}}}}, "responses": {"200": {"description": "kr-market-answer/v1 with intent, symbol, data"}, "400": {"description": "bad request"}}}}}}