韩国股票市场数据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 基础配置参数

项目	固定值/说明
基础URL	https://api.stocktv.top
WebSocket地址	wss://ws-api.stocktv.top/connect
韩国countryId	11
韩国flag	KR
交易所ID	60=首尔交易所；110=KOSDAQ
认证方式	URL参数 key（必填）
请求方法	全HTTP接口为 GET
数据格式	JSON（UTF-8）
货币单位	韩元（KRW）

三、核心接口对接指南

3.1 股票列表查询

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

接口地址：GET /stock/stocks

请求参数：

参数名	必填	类型	说明	示例
countryId	是	int	韩国固定11	11
exchangeId	否	int	60=首尔；110=KOSDAQ	60
pageSize	否	int	每页条数，默认10	20
page	否	int	页码，默认1	1
key	是	string	认证密钥	服务商提供

示例请求：

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

3.2 个股详情查询

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

接口地址：GET /stock/queryStocks

查询方式示例：

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

# 通过PID查询
curl -X GET "https://api.stocktv.top/stock/queryStocks?id=953367&key=your_key"

3.3 历史K线数据

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

接口地址：GET /stock/kline

时间周期参数：

interval	说明	韩国适用场景
PT5M	5分钟线	日内高频交易
PT15M	15分钟线	短线交易
PT1H	1小时线	趋势分析
P1D	日线	技术分析主力
P1W	周线	长期投资

示例请求：

# 获取三星电子日K线
curl -X GET "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）

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

<?php
class KoreaStockAPI {
    private $apiKey;
    private $baseUrl = 'https://api.stocktv.top';
    
    public function __construct($apiKey) {
        $this->apiKey = $apiKey;
    }
    
    // 获取韩国股票列表
    public function getStockList($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);
    }
    
    // 获取个股详情
    public function getStockDetail($pid) {
        $url = $this->baseUrl . "/stock/queryStocks?id={$pid}&key={$this->apiKey}";
        return $this->makeRequest($url);
    }
    
    // 获取历史K线
    public function getKlineData($pid, $interval = 'P1D') {
        $url = $this->baseUrl . "/stock/kline?pid={$pid}&interval={$interval}&key={$this->apiKey}";
        return $this->makeRequest($url);
    }
    
    private function makeRequest($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);
        return json_decode($response, true);
    }
}

// 使用示例
$api = new KoreaStockAPI('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/

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