新加坡作为全球领先的金融中心之一，其证券交易所（SGX）汇聚了大量优质的房地产信托基金（REITs）、银行股（如 DBS, UOB）以及跨国航运企业。对于开发者而言，获取稳定、准确的新加坡股市数据是构建东南亚金融产品的关键。
本文将指导你如何使用 StockTV 全球金融 API 快速接入新加坡股票行情。
一、 核心接入参数
在 StockTV 的全球体系中，新加坡市场的数据具有标准化的标识：
- 国家 ID (countryId)：
15（新加坡） - 交易所：新加坡证券交易所（Singapore Exchange, SGX）
- 接入协议：支持 REST (HTTP) 与 WebSocket (WS)
二、 核心接口调用流程
在开始之前，请确保你已经获取了 API Key。
1. 获取新加坡股票列表
首先，你需要通过国家 ID 筛选出所有在新加坡上市的股票及其唯一标识 pid。
- 请求示例：
GET https://api.stocktv.top/stock/stocks?countryId=15&pageSize=20&page=1&key=YOUR_KEY - 关键返回：你将获得如“星展银行 (DBS)”、“新电信 (Singtel)”等股票的
symbol、name以及对应的pid。
2. 获取实时个股详情
一旦拥有了 pid，你可以调用详情接口获取最全面的实时数据，包括基本面和技术分析指标。
- 接口地址：
https://api.stocktv.top/stock/queryStocks?id=股票PID&key=YOUR_KEY - 数据亮点：
last: 最新成交价格。chgPct: 24小时涨跌幅。technicalDay: 提供基于算法的日线买卖建议（如Buy或Sell）。fundamentalMarketCap: 实时市值数据。
3. 获取历史 K 线数据（图表绘制）
支持多种时间频率，方便集成 ECharts 或 TradingView 插件。
- 接口地址：
https://api.stocktv.top/stock/kline?pid=股票PID&interval=PT1H&key=YOUR_KEY - 参数说明：
interval可选PT1M(1分钟)、PT15M(15分钟)、P1D(日线) 等。
4. 追踪新加坡海峡时报指数 (STI)
STI 是衡量新加坡市场表现的核心指标，通过以下接口可以实时追踪其走势：
- 接口地址：
https://api.stocktv.top/stock/indices?countryId=15&key=YOUR_KEY
三、 为什么选择此方案？
- 极低门槛：无需与交易所直接签署复杂的合规协议，StockTV 已经完成了底层数据的清洗与标准化。
- 全能集成：除了股票，该 API 还支持新加坡相关的外汇（SGD/USD）以及大宗商品数据，适合构建全资产管理平台。
- 高性能响应：分布式服务器节点确保了在开盘高峰期，数据延迟依然保持在极低水平。
四、 开发小贴士
- 交易时间：新加坡股市交易时间通常为北京时间 09:00 - 17:00（含午休），在非交易时段，
last字段将保持为收盘价。 - 数据单位：SGX 股票通常以新加坡元（SGD）计价，处理跨境投资应用时需注意汇率转换。
- 错误处理：建议在代码中对
code != 200的情况进行容错处理，并增加请求频率限制逻辑。
结语
通过 StockTV API，对接新加坡股票数据不再是一个漫长的开发工程，而是仅需几行代码即可实现的标准化流程。如果你正准备开发一款面向东南亚市场的金融应用，这将是你的不二之选。
