作为东南亚最大的经济体，印度尼西亚股票市场（IDX）凭借其丰富的矿产资源股、银行股以及蓬勃发展的科技独角兽，正成为全球资本的新宠。对于金融科技开发者而言，获取雅加达综合指数（JKSE）以及个股的实时行情，是构建区域性投资工具的必备环节。
本文将介绍如何利用 StockTV 全球金融 API，以极简的代码实现对印尼股市数据的深度接入。
一、 为什么选择 StockTV API 对接印尼数据？
直接对接印尼证券交易所（IDX）通常涉及高昂的数据授权费和复杂的跨境技术协议。StockTV 提供了一套标准化的解决方案：
- 全面覆盖：支持印尼证券交易所（Exchange ID: 73）的所有挂牌个股。
- 多维数据：除了基础价格，还提供基本面市值、市盈率以及系统自动生成的每日技术分析建议。
- 灵活接入：提供 RESTful 接口用于调取历史 K 线，以及 WebSocket (WS) 用于实时价格推送。
二、 核心接口对接实操
在开始之前，请确保你已获取 API Key。
1. 获取印尼股票资产列表
通过 countryId 或筛选交易所 ID 来获取印尼市场的全部股票及其唯一标识 pid。
- 请求方式：
GET - 接口地址：
https://api.stocktv.top/stock/stocks?countryId=13&pageSize=10&page=1&key=YOUR_KEY - 关键字段：在返回的 JSON 中，你可以找到股票代码（Symbol，如 BBCA、TLKM）和对应的
pid。
2. 获取个股实时详情与技术指标
通过 pid 查询特定股票的实时报价。StockTV 的独特之处在于其内置的技术面评分。
- 接口地址：
https://api.stocktv.top/stock/queryStocks?id=股票PID&key=YOUR_KEY - 核心字段说明：
last: 最新价格（印尼盾 IDR）。chgPct: 24小时涨跌幅。technicalDay: 提供“强力买入”、“卖出”等实时技术建议。fundamentalMarketCap: 该公司的实时市值。
3. 调用 K 线数据（历史行情）
无论是构建 1 分钟分时图还是日线趋势图，K 线接口都能提供完整的 OHLC 数据。
- 接口地址：
https://api.stocktv.top/stock/kline?pid=股票PID&interval=PT15M&key=YOUR_KEY - 参数建议：
interval支持PT1M(1分钟)、PT1H(1小时)、P1D(日线) 等。
4. 追踪雅加达综合指数 (JKSE)
获取大盘指数是分析印尼市场情绪的第一步。
- 接口地址：
https://api.stocktv.top/stock/indices?countryId=13&key=YOUR_KEY
三、 进阶：涨跌榜与新股预告
- 涨跌榜单：通过
stock/updownList接口，快速获取印尼市场当日表现最强的 Top 10 股票。 - IPO 日历：印尼市场 IPO 活动频繁，利用
stock/getIpo接口可以获取最新的新股发行价及上市日期。
四、 开发小贴士
- 交易时间：注意印尼雅加达时间（WIB，UTC+7）。印尼股市通常有午休时段，在非交易时间内，
last字段将返回最后一次收盘价。 - 货币单位：印尼股票报价以印尼盾（IDR）为单位，处理显示时建议进行适当的千分位格式化。
- 连接稳定性：对于实时性要求极高的行情显示，建议使用 StockTV 的 WebSocket 连接，通过订阅模式实时获取价格跳动。
结语
通过 StockTV API，开发者可以跨越复杂的地域限制，将印尼市场的脉动直接引入自己的应用中。无论是开发量化机器人，还是构建资讯类 App，稳定且标准化的数据流都是成功的关键。
