如何高效对接新加坡股票（SGX）实时数据 API

新加坡作为全球领先的金融中心之一，其证券交易所（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

三、 为什么选择此方案？

1. 极低门槛：无需与交易所直接签署复杂的合规协议，StockTV 已经完成了底层数据的清洗与标准化。
2. 全能集成：除了股票，该 API 还支持新加坡相关的外汇（SGD/USD）以及大宗商品数据，适合构建全资产管理平台。
3. 高性能响应：分布式服务器节点确保了在开盘高峰期，数据延迟依然保持在极低水平。

四、 开发小贴士

• 交易时间：新加坡股市交易时间通常为北京时间 09:00 - 17:00（含午休），在非交易时段，last 字段将保持为收盘价。
• 数据单位：SGX 股票通常以新加坡元（SGD）计价，处理跨境投资应用时需注意汇率转换。
• 错误处理：建议在代码中对 code != 200 的情况进行容错处理，并增加请求频率限制逻辑。

结语

通过 StockTV API，对接新加坡股票数据不再是一个漫长的开发工程，而是仅需几行代码即可实现的标准化流程。如果你正准备开发一款面向东南亚市场的金融应用，这将是你的不二之选。