韩国股票市场数据API对接技术指南

韩国股票市场数据API对接技术指南

韩国作为全球半导体与电子产业的枢纽，其股市（如三星电子、SK海力士等）一直是国际投资者关注的焦点。对于金融科技开发者而言，如何稳定地获取韩国综合股价指数（KOSPI）及高斯达克（KOSDAQ）的实时行情是构建相关应用的核心。本文将详细介绍如何通过标准化API接口快速接入韩国股票市场数据。

一、核心特性与优势

1.1 低延迟实时数据流

• 交易所直连：与韩国Seoul、KOSDAQ行情源直连，端到端延迟≤400ms，数据与交易所盘口同步更新。
• 高频刷新：实时价格、成交量、涨跌幅秒级推送，最小支持1分钟粒度K线更新，时间戳精准到毫秒级。
• 全时段覆盖：支持韩国股市盘中、盘后全时段数据采集，无行情断档。

1.2 开发者友好设计

• 极简接入：全接口GET请求，仅需API Key鉴权，无复杂配置。
• 标准化响应：字段命名统一，注释清晰，降低解析成本。
• 灵活查询：支持分页、按交易所筛选、批量查询。
• 免费技术支持：全程辅助对接，覆盖开发—测试—上线全流程。

二、基础配置与参数说明

2.1 韩国市场特性

• 韩国交易所：KRX（Korea Exchange）
• 交易时间：韩国时间 09:00-15:30
• 交易货币：韩元（KRW）
• 涨跌限制：±30%
• 主要市场板块：
  • 主板市场（KOSPI）
  • 创业板（KOSDAQ）
  • 科斯达克（KONEX）

2.2 基础配置参数

三、核心接口对接指南

3.1 股票列表查询

获取韩国全市场股票分页列表，支持按交易所筛选。

接口地址：GET /stock/stocks

请求参数：

示例请求：

curl-XGET"https://api.stocktv.top/stock/stocks?countryId=11&pageSize=20&page=1&exchangeId=60&key=your_key"

3.2 个股详情查询

根据多种条件查询韩国个股详细信息。

接口地址：GET /stock/queryStocks

查询方式示例：

# 通过股票代码查询（三星电子）curl-XGET"https://api.stocktv.top/stock/queryStocks?symbol=005930&key=your_key"# 通过PID查询curl-XGET"https://api.stocktv.top/stock/queryStocks?id=953367&key=your_key"

3.3 历史K线数据

获取韩国股票的历史价格数据。

接口地址：GET /stock/kline

时间周期参数：

示例请求：

# 获取三星电子日K线curl-XGET"https://api.stocktv.top/stock/kline?pid=953367&interval=P1D&key=your_key"

3.4 韩国IPO信息

获取韩国市场的IPO发行信息。

接口地址：GET /stock/getIpo

请求参数：

countryId=11&type=1&key=your_key

type参数说明：

• 1：未上市IPO
• 2：已上市IPO

四、实时数据推送（WebSocket）

对于实时行情，推荐使用WebSocket接口实现低延迟数据推送。

连接地址：

wss://ws-api.stocktv.top/connect?key=您的API_KEY

核心步骤：

1. 建立WebSocket连接
2. 发送订阅消息（包含要订阅的韩国股票PID）
3. 接收实时推送
4. 维持心跳连接

五、完整使用示例（PHP）

以下代码封装了韩国股票数据的常用操作：

<?phpclassKoreaStockAPI{private$apiKey;private$baseUrl='https://api.stocktv.top';publicfunction__construct($apiKey){$this->apiKey=$apiKey;}// 获取韩国股票列表publicfunctiongetStockList($exchangeId=60,$pageSize=20,$page=1){$url=$this->baseUrl."/stock/stocks?countryId=11&exchangeId={$exchangeId}&pageSize={$pageSize}&page={$page}&key={$this->apiKey}";return$this->makeRequest($url);}// 获取个股详情publicfunctiongetStockDetail($pid){$url=$this->baseUrl."/stock/queryStocks?id={$pid}&key={$this->apiKey}";return$this->makeRequest($url);}// 获取历史K线publicfunctiongetKlineData($pid,$interval='P1D'){$url=$this->baseUrl."/stock/kline?pid={$pid}&interval={$interval}&key={$this->apiKey}";return$this->makeRequest($url);}privatefunctionmakeRequest($url){$ch=curl_init();curl_setopt($ch,CURLOPT_URL,$url);curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);curl_setopt($ch,CURLOPT_SSL_VERIFYPEER,false);$response=curl_exec($ch);curl_close($ch);returnjson_decode($response,true);}}// 使用示例$api=newKoreaStockAPI('your_api_key_here');$stocks=$api->getStockList(60);// 获取首尔交易所股票列表$detail=$api->getStockDetail(953367);// 获取三星电子详情$kline=$api->getKlineData(953367,'P1D');// 获取日K线数据?>

六、注意事项

1. 价格格式：韩国股票价格通常为整数，成交额单位较大（韩元），成交量单位为股。
2. 时区处理：所有时间戳均为韩国时间（KST），需在客户端进行时区转换。
3. API限制：注意接口调用频率限制，建议合理设计缓存机制。
4. 错误处理：所有接口返回标准HTTP状态码，错误信息包含在响应体中。

七、总结

通过本文介绍的API接口，开发者可以快速接入韩国股票市场的实时行情、历史数据、公司基本面等多维度信息。该方案具有低延迟、高稳定性、开发者友好等特点，适用于行情展示、量化系统、金融工具、投研平台等多种场景。

如需获取API密钥或了解更多详细信息

参考资料：

1. hhttps://documenter.getpostman.com/view/42914868/2sB3dLTBM8
2. ttps://pao.stocktv.top/

本文基于公开技术文档整理，具体实现细节请以最新官方文档为准。