当前位置：首页 > news >正文

使用PHP对接韩国股票市场API 实时数据、IPO和K线（Kline）的PHP对接方案

news 2026/7/2 5:44:25

基础配置

首先，您需要从StockTV获取API Key。所有API请求都必须包含key参数。

<?php // StockTV API 配置 define('STOCKTV_API_KEY', 'YOUR_API_KEY_HERE'); // 请替换为从StockTV获取的实际Key define('STOCKTV_BASE_URL', 'https://api.stocktv.top'); /** * 通用API请求函数 * @param string $endpoint API路径 * @param array $params 查询参数 * @return array */ function stocktvApiRequest($endpoint, $params = []) { $params['key'] = STOCKTV_API_KEY; // 必需参数 $url = STOCKTV_BASE_URL . $endpoint . '?' . http_build_query($params); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch, CURLOPT_TIMEOUT, 30); $response = curl_exec($ch); if ($response === false) { return ['error' => 'CURL Error: ' . curl_error($ch)]; } curl_close($ch); $decoded = json_decode($response, true); if (json_last_error() !== JSON_ERROR_NONE) { return ['error' => 'JSON Decode Error']; } return $decoded; } ?>

二、韩国股票核心接口

虽然文档没有明确列出韩国的countryId具体数值，但根据文档中提到的国家列表，韩国肯定是支持的。您可以通过以下方式确定韩国的countryId：

测试获取韩国国家ID：

<?php function findKoreaCountryId() { // 先获取股票列表，查看包含"Korea"或"KR"的记录 $endpoint = '/stock/stocks'; $params = [ 'pageSize' => 100, 'page' => 1, 'key' => STOCKTV_API_KEY ]; $result = stocktvApiRequest($endpoint, $params); if (isset($result['code']) && $result['code'] == 200) { foreach ($result['data']['records'] as $stock) { if (isset($stock['countryNameTranslated']) && (stripos($stock['countryNameTranslated'], 'korea') !== false || stripos($stock['countryNameTranslated'], '韩国') !== false || ($stock['flag'] ?? '') === 'KR')) { return [ 'countryId' => $stock['countryId'] ?? null, 'countryName' => $stock['countryNameTranslated'] ?? null, 'flag' => $stock['flag'] ?? null ]; } } } return null; } // 使用示例 $koreaInfo = findKoreaCountryId(); if ($koreaInfo) { echo "韩国国家ID: {$koreaInfo['countryId']}, 国家名称: {$koreaInfo['countryName']}, 国旗代码: {$koreaInfo['flag']}"; } else { echo "未找到韩国信息，可能需要联系客服确认countryId"; } ?>

假设韩国countryId后的通用接口（假设countryId为11，根据文档中提到的交易所ID推断）：
文档中提到交易所ID时有一行注释：

"exchangeId": 62, //交易所ID 1NYSE 2NASDAQ 54上海交易所 103深圳交易所 46NSE 74BSE 53Mexico 144BIVA 60Seoul 110KOSDAQ 51Toronto 108TSXV 109CSE

这里明确提到60Seoul（首尔交易所）和110KOSDAQ（韩国科斯达克），这可能是韩国的交易所ID，而不是countryId。但我们可以参考这个信息。

基于模型预训练知识的补充：从常见的国际分类和StockTV的编号模式来看，韩国可能的countryId范围可能在50-70之间。最安全的方式是通过实际API调用测试或联系客服确认。

三、韩国股票数据主要接口

一旦确定韩国的countryId（假设为11），您可以使用以下接口：

1. 获取韩国股票市场列表

<?php function getKoreaStockList($page = 1, $pageSize = 50) { $endpoint = '/stock/stocks'; $params = [ 'countryId' => 11, // 假设韩国countryId为11，实际需确认 'page' => $page, 'pageSize' => $pageSize, ]; return stocktvApiRequest($endpoint, $params); } ?>

2. 获取韩国市场指数

韩国主要有KOSPI和KOSDAQ指数：

<?php function getKoreaIndices() { $endpoint = '/stock/indices'; $params = ['countryId' => 11]; // 假设值 return stocktvApiRequest($endpoint, $params); } ?>

3. 获取K线数据

<?php function getKoreaStockKline($pid, $interval = 'P1D') { $endpoint = '/stock/kline'; $params = [ 'pid' => $pid, 'interval' => $interval, // PT5M, PT15M, PT1H, PT5H, P1D, P1W, P1M ]; return stocktvApiRequest($endpoint, $params); } ?>

4. 获取韩国ETF数据

文档中有专门的ETF接口，韩国ETF市场也很活跃：

<?php function getKoreaETFs() { // 注意：文档中ETFs接口需要联系客服开通 $endpoint = '/stock/stocks'; // 使用普通股票接口，筛选ETF类型 $params = [ 'countryId' => 11, 'pageSize' => 100, ]; $result = stocktvApiRequest($endpoint, $params); // 在结果中筛选pairType为"ETF"或名称包含"ETF"的记录 return $result; } ?>

四、韩国交易所的特殊性

从文档中可以看到，韩国有两个主要交易所：

首尔证券交易所（Seoul）：交易所ID可能为60
韩国科斯达克（KOSDAQ）：交易所ID可能为110

这在获取数据时可以用于筛选：

<?php // 获取首尔交易所的股票 function getSeoulExchangeStocks() { $endpoint = '/stock/stocks'; $params = [ 'countryId' => 11, // 韩国 'exchangeId' => 60, // 首尔交易所 'pageSize' => 50, ]; return stocktvApiRequest($endpoint, $params); } // 获取KOSDAQ的股票 function getKosdaqStocks() { $endpoint = '/stock/stocks'; $params = [ 'countryId' => 11, // 韩国 'exchangeId' => 110, // KOSDAQ 'pageSize' => 50, ]; return stocktvApiRequest($endpoint, $params); } ?>

五、实时数据（WebSocket）

对于韩国股票的实时行情，必须使用WebSocket接口：

连接地址：wss://ws-api.stocktv.top/connect?key=YOUR_API_KEY

<?php // WebSocket连接示例（概念代码） // 实际需要安装WebSocket客户端库，如ratchet/pawl /* require __DIR__ . '/vendor/autoload.php'; $wsUrl = "wss://ws-api.stocktv.top/connect?key=" . STOCKTV_API_KEY; // 连接后发送订阅消息 $subscribeMsg = json_encode([ 'action' => 'subscribe', 'pids' => ['韩国股票PID1', '韩国股票PID2'] // 需要先获取股票的PID ]); */ ?>

六、完整对接流程

确认countryId：
- 联系StockTV客服获取准确的韩国countryId
- 或通过API测试确定（如上面的findKoreaCountryId()函数）
获取数据：
- 使用确定后的countryId调用相应接口
- 区分首尔交易所(exchangeId=60)和KOSDAQ(exchangeId=110)
实时数据：
- 对于实时行情，必须使用WebSocket接口
- 获取股票的PID用于订阅
数据处理：
- 韩国股价通常以韩元(KRW)为单位
- 注意交易时间（韩国标准时间，UTC+9）