基础配置首先您需要从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?keyYOUR_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调用相应接口区分首尔交易所(exchangeId60)和KOSDAQ(exchangeId110)实时数据对于实时行情必须使用WebSocket接口获取股票的PID用于订阅数据处理韩国股价通常以韩元(KRW)为单位注意交易时间韩国标准时间UTC9七、重要注意事项countryId确认文档没有明确列出韩国的countryId这是对接韩国数据的关键第一步。交易所区分韩国有两个主要交易所可能需要分别处理。数据字段韩国股票数据会包含特殊的本地化字段可能需要特别处理。API限制注意API调用频率限制合理设计数据获取策略。时区处理韩国使用UTC9时区处理时间数据时需要注意。