韩国股票 API 对接指南 SeoulKOSDAQ

一、基础配置文档明确要求所有 API 请求必须包含key参数您需要先从 StockTV 获取 API Key。?php// StockTV API 配置define(STOCKTV_API_KEY,YOUR_API_KEY_HERE);// 从 StockTV 获取define(STOCKTV_BASE_URL,https://api.stocktv.top);define(KOREA_COUNTRY_ID,11);// 韩国 countryId/** * 通用 API 请求函数 */functionstocktvApiRequest($endpoint,$params[]){$params[key]STOCKTV_API_KEY;// 必需参数$urlSTOCKTV_BASE_URL.$endpoint.?.http_build_query($params);$chcurl_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);$responsecurl_exec($ch);if($responsefalse){return[errorCURL Error: .curl_error($ch)];}curl_close($ch);$decodedjson_decode($response,true);if(json_last_error()!JSON_ERROR_NONE){return[errorJSON Decode Error];}return$decoded;}?二、韩国股票核心接口基于文档中的通用接口结构和您提供的countryId11以下是韩国市场的具体实现1. 获取韩国股票市场列表文档中该接口支持分页获取指定国家的股票列表。?phpfunctiongetKoreaStockList($page1,$pageSize50,$exchangeIdnull){$endpoint/stock/stocks;$params[countryIdKOREA_COUNTRY_ID,// 韩国page$page,pageSize$pageSize,];// 文档提到 exchangeId 是非必要参数可用于筛选特定交易所if($exchangeId!null){$params[exchangeId]$exchangeId;}returnstocktvApiRequest($endpoint,$params);}// 使用示例$resultgetKoreaStockList(1,10);if(isset($result[code])$result[code]200){echo韩国股票列表 (第1页):\n;foreach($result[data][records]as$stock){echo{$stock[name]}({$stock[symbol]}): 最新价{$stock[last]}涨跌{$stock[chgPct]}%\n;}}?接口返回字段根据文档中的示例id: 股票PID用于后续查询name/symbol: 股票名称和代码last/chg/chgPct: 最新价、涨跌额、涨跌幅high/low/volume: 最高价、最低价、成交量open: 是否开市flag: 国家代码应为KRcountryId: 国家ID应为112. 韩国交易所说明从文档中的市场列表接口示例可以看到交易所ID的注释exchangeId: 62, //交易所ID 1NYSE 2NASDAQ 54上海交易所 103深圳交易所 46NSE 74BSE 53Mexico 144BIVA 60Seoul 110KOSDAQ 51Toronto 108TSXV 109CSE其中明确提到了韩国的交易所60Seoul: 首尔证券交易所110KOSDAQ: 韩国科斯达克交易所因此您可以这样筛选不同交易所的股票?php// 获取首尔交易所的股票functiongetSeoulExchangeStocks(){returngetKoreaStockList(1,50,60);// exchangeId60}// 获取KOSDAQ的股票functiongetKosdaqStocks(){returngetKoreaStockList(1,50,110);// exchangeId110}?3. 查询特定韩国股票?phpfunctionqueryKoreaStock($pidnull,$symbolnull,$namenull){$endpoint/stock/queryStocks;$params[];if($pid)$params[id]$pid;if($symbol)$params[symbol]$symbol;if($name)$params[name]$name;$resultstocktvApiRequest($endpoint,$params);// 筛选韩国股票if(isset($result[code])$result[code]200is_array($result[data])){$result[data]array_filter($result[data],function($stock){return($stock[countryId]??0)KOREA_COUNTRY_ID;});}return$result;}?4. 获取韩国股票K线数据?phpfunctiongetKoreaStockKline($pid,$intervalP1D){$endpoint/stock/kline;$params[pid$pid,interval$interval,];returnstocktvApiRequest($endpoint,$params);}// 使用示例$klineDatagetKoreaStockKline(12345,P1D);// 12345为示例PIDif(isset($klineData[code])$klineData[code]200){echoK线数据获取成功共.count($klineData[data]).条记录\n;}?K线时间间隔参数来自文档PT5M: 5分钟PT15M: 15分钟PT1H: 1小时PT5H: 5小时P1D: 1天P1W: 1周P1M: 1月5. 获取韩国市场指数?phpfunctiongetKoreaIndices(){$endpoint/stock/indices;$params[countryIdKOREA_COUNTRY_ID];returnstocktvApiRequest($endpoint,$params);}?预期返回韩国主要指数如KOSPI韩国综合股价指数KOSDAQ指数6. 获取韩国ETF数据文档中有一个专门的ETF接口但需要联系客服开通。您也可以从普通股票接口中筛选ETF?phpfunctiongetKoreaETFs(){$endpoint/stock/stocks;$params[countryIdKOREA_COUNTRY_ID,pageSize100,];$resultstocktvApiRequest($endpoint,$params);// 筛选ETF根据pairType或名称包含ETFif(isset($result[code])$result[code]200!empty($result[data][records])){$result[data][records]array_filter($result[data][records],function($stock){return(isset($stock[pairType])$stock[pairType]ETF)||(stripos($stock[name]??,ETF)!false);});}return$result;}?7. 获取韩国IPO新股日历?phpfunctiongetKoreaIpo($typenull){$endpoint/stock/getIpo;$params[countryIdKOREA_COUNTRY_ID];if(in_array($type,[1,2])){$params[type]$type;// 1未上市, 2已上市}returnstocktvApiRequest($endpoint,$params);}?8. 获取韩国股票涨跌排行榜?phpfunctiongetKoreaStockRank($type1){$endpoint/stock/updownList;$params[countryIdKOREA_COUNTRY_ID,type$type,// 1涨幅榜 2跌幅榜 3涨停榜 4跌停榜];returnstocktvApiRequest($endpoint,$params);}?三、实时数据推送WebSocket对于实时行情文档推荐使用WebSocket接口。文档中提供了前端DEMO和Java DEMO链接。连接地址:wss://ws-api.stocktv.top/connect?key您的API_KEY核心步骤建立WebSocket连接发送订阅消息包含要订阅的韩国股票PID接收实时推送维持心跳连接返回数据格式来自文档示例{pid:992844,last_numeric:0.68,pc:0.000,pcp:0.00,volume:3672800,type:1}四、完整使用示例?php// 韩国股票数据监控示例classKoreaStockMonitor{publicfunctionmonitorKoreaMarket(){// 1. 获取韩国股票列表$stocksgetKoreaStockList(1,20);// 2. 获取韩国指数$indicesgetKoreaIndices();// 3. 获取涨跌榜$gainersgetKoreaStockRank(1);// 涨幅榜// 4. 获取IPO信息$iposgetKoreaIpo(1);// 未上市IPOreturn[stocks$stocks,indices$indices,gainers$gainers,ipos$ipos];}publicfunctiongetStockDetail($pid){// 获取股票详细信息$stockInfoqueryKoreaStock($pid);// 获取K线数据$klinegetKoreaStockKline($pid,P1D);return[info$stockInfo,kline$kline];}}?五、重要注意事项API Key: 所有请求必须包含有效的key参数国家ID: 韩国固定为countryId11交易所ID: 韩国有两个主要交易所首尔交易所:exchangeId60KOSDAQ:exchangeId110实时数据: 必须使用WebSocket接口获取实时行情错误处理: 检查返回的code字段200表示成功数据更新: 韩国股市交易时间为韩国标准时间UTC9六、韩国股票市场特点基于模型预训练知识补充交易时间: 韩国股市交易时间为平日 09:00-15:30韩国时间货币单位: 韩元KRW主要指数:KOSPI韩国综合股价指数KOSDAQ韩国科斯达克指数涨跌幅限制: 通常为 ±30%通过以上接口您可以全面对接韩国股票的实时行情、历史数据、市场指数等信息。请根据您的实际业务需求组合使用这些接口。