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

一、基础配置在对接任何接口前您需要从 StockTV 获取 API Key并设置基础请求函数。?php// StockTV API 配置define(STOCKTV_API_KEY,您从StockTV获取的Key);// 务必替换define(STOCKTV_BASE_URL,https://api.stocktv.top);/** * 发起 HTTP GET 请求 * param string $endpoint API路径 * param array $params 查询参数 * return array */functionstocktvApiRequest($endpoint,$params[]){$params[key]STOCKTV_API_KEY;// 必须包含 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){curl_close($ch);return[errorCURL Error: .curl_error($ch)];}$httpCodecurl_getinfo($ch,CURLINFO_HTTP_CODE);curl_close($ch);$decodedjson_decode($response,true);if(json_last_error()!JSON_ERROR_NONE){return[errorJSON Decode Error];}return$decoded;}?二、马来西亚股票核心数据对接文档显示股票相关的接口主要集中在/stock/路径下。马来西亚的关键参数是countryId42。1. 获取马来西亚市场股票列表这是最基础的接口用于分页获取马来西亚交易所的股票列表包含实时行情、基本面和技术指标。?php/** * 获取马来西亚股票市场列表 * param int $page 页码 * param int $pageSize 每页数量 * param int|null $exchangeId 交易所ID (非必需) * return array */functiongetMalaysiaStockList($page1,$pageSize50,$exchangeIdnull){$endpoint/stock/stocks;$params[countryId42,// 马来西亚page$page,pageSize$pageSize,];if($exchangeId!null){$params[exchangeId]$exchangeId;// 可用于筛选特定交易所}returnstocktvApiRequest($endpoint,$params);}// 使用示例$resultgetMalaysiaStockList(1,10);if(isset($result[code])$result[code]200){$stocks$result[data][records];echo马来西亚股票列表 (第1页共.$result[data][total].只):\n;foreach($stocksas$stock){$trend$stock[chgPct]0?↑:↓;echosprintf( %s (%s): %.3f %s%.2f%%\n,$stock[name],$stock[symbol],$stock[last],$trend,abs($stock[chgPct]));}}else{echo请求失败: .($result[message]??未知错误);}?接口返回字段说明摘录自文档id: 股票的唯一PID用于后续查询如K线。name/symbol: 股票名称和代码。last/chg/chgPct: 最新价、涨跌额、涨跌幅。high/low: 当日最高/最低价。volume: 成交量。open: 是否开市。technicalDay/technicalHour等: 日线/小时线技术指标信号如strong_buy。2. 查询特定马来西亚股票可以通过股票PID、名称或代码进行精确查询。?php/** * 查询马来西亚股票 * param int|null $pid 股票PID * param string|null $symbol 股票代码 * param string|null $name 股票名称 * return array */functionqueryMalaysiaStock($pidnull,$symbolnull,$namenull){$endpoint/stock/queryStocks;$params[];if($pid)$params[id]$pid;if($symbol)$params[symbol]$symbol;if($name)$params[name]$name;// 注意此接口本身不包含countryId参数结果中会包含所有匹配项需自行筛选flag为MY的$resultstocktvApiRequest($endpoint,$params);// 筛选马来西亚股票if(isset($result[code])$result[code]200is_array($result[data])){$result[data]array_filter($result[data],function($stock){returnisset($stock[flag])$stock[flag]MY;});}return$result;}?3. 获取马来西亚市场指数获取马来西亚的主要市场指数如富时大马综合指数 (FTSE Bursa Malaysia KLCI)。?php/** * 获取马来西亚市场指数 * return array */functiongetMalaysiaIndices(){$endpoint/stock/indices;$params[countryId42,// 马来西亚// flag MY // 非必要参数];returnstocktvApiRequest($endpoint,$params);}?4. 获取马来西亚股票K线数据这是进行技术分析的核心接口支持多种时间周期。?php/** * 获取马来西亚股票K线数据 * param int $pid 股票PID * param string $interval K线周期: PT5M, PT15M, PT1H, PT5H, P1D, P1W, P1M * return array */functiongetMalaysiaStockKline($pid,$intervalP1D){$endpoint/stock/kline;$params[pid$pid,interval$interval,];returnstocktvApiRequest($endpoint,$params);}// 使用示例获取某股票PID41602的日K线$klineDatagetMalaysiaStockKline(41602,P1D);if(isset($klineData[code])$klineData[code]200){$klines$klineData[data];echoK线数据日线最新3条:\n;$recentarray_slice($klines,-3);// 取最后3条foreach($recentas$bar){$datedate(Y-m-d,$bar[time]/1000);echo日期:{$date}, 开:{$bar[open]}, 高:{$bar[high]}, 低:{$bar[low]}, 收:{$bar[close]}, 量:{$bar[volume]}\n;}}?5. 获取马来西亚IPO新股日历了解马来西亚市场的新股发行和上市计划。?php/** * 获取马来西亚IPO信息 * param int|null $type 1未上市, 2已上市 * return array */functiongetMalaysiaIpo($typenull){$endpoint/stock/getIpo;$params[countryId42];if(in_array($type,[1,2])){$params[type]$type;}returnstocktvApiRequest($endpoint,$params);}?6. 获取马来西亚股票涨跌排行榜实时了解市场热点。?php/** * 获取马来西亚股票排行榜 * param int $type 1涨幅榜 2跌幅榜 3涨停榜 4跌停榜 * return array */functiongetMalaysiaStockRank($type1){$endpoint/stock/updownList;$params[countryId42,type$type,];returnstocktvApiRequest($endpoint,$params);}?三、高级功能WebSocket 实时数据对于实时行情推送文档推荐使用WebSocket这比HTTP轮询更高效。马来西亚股票的实时数据同样通过此方式获取。关键步骤连接连接到wss://ws-api.stocktv.top/connect?key您的Key。订阅连接成功后发送订阅消息指定要订阅的马来西亚股票的pid。接收服务器会持续推送订阅股票的实时行情。心跳需要定期发送心跳消息以保持连接。文档中提供了一个前端Demo并提到有Java Demo。对于PHP您可以使用ratchet/pawl等WebSocket客户端库来实现。由于实现相对复杂且依赖具体业务逻辑此处不展开详细代码但核心流程如上。四、完整对接流程与注意事项获取API Key这是第一步也是必须的一步。所有请求都必须携带key参数。确定数据需求批量列表/监控使用getMalaysiaStockList或getMalaysiaStockRank。特定股票查询使用queryMalaysiaStock或先通过列表接口找到股票的pid。历史数据分析使用getMalaysiaStockKline。实时推送必须使用WebSocket接口。市场概况使用getMalaysiaIndices。新股信息使用getMalaysiaIpo。核心参数countryId: 马来西亚固定为42。pid: 股票的唯一标识用于K线、WebSocket订阅等精细操作。务必从列表或查询接口获取正确的pid。interval: K线周期根据分析需求选择。错误处理与日志在生产环境中务必对API返回的code和message字段进行判断并记录日志。性能与频率虽然文档未明确说明频率限制但应避免不必要的高频请求。对于大量股票的实时监控WebSocket是唯一推荐的方式。通过以上接口您可以全面对接马来西亚股票的实时行情、历史K线、市场指数、IPO信息等数据。请根据您的实际应用场景组合使用这些接口。