印度尼西亚作为东南亚最大的经济体，其证券市场（IDX - 印度尼西亚证券交易所）近年来表现活跃，吸引了大量全球投资者。对于金融应用开发者而言，获取印尼市场的实时、准确数据是进入该市场的基石。
本文将带你通过 StockTV API 高效对接印尼股票（countryId=48）数据，快速实现行情展示、指数监控及新股日历功能。
一、 核心对接配置
在开始调用之前，请确保基础环境配置正确：
- API 基础路径：
https://api.stocktv.top - 国家 ID (countryId)：
48（印尼专有 ID） - 认证方式：在 API 请求参数中添加
key - 支持协议：提供极速响应的 HTTP 接口与适合高频刷新的 WebSocket 推送。
二、 核心功能实现
1. 实时行情：同步雅加达市场波动
通过 StockTV API，你可以秒级获取印尼市场（如雅加达综合指数成份股）的最新价格。
A. 获取印尼股票列表
通过设置 countryId=48，你可以获取印尼市场的股票清单及其成交明细。
- 接口地址：
/stock/stocks - 请求示例：
```http
GET https://api.stocktv.top/stock/stocks?countryId=48&pageSize=20&page=1&key=YOUR_KEY
* **关键数据字段**：
* `last`: 最新价格。
* `chgPct`: 涨跌幅（直接拼接 % 即可展示）。
* `high`/`low`: 当日最高与最低价。
* `volume`: 实时成交量。
#### B. 指数监控（如 JKSE）
实时追踪印尼雅加达综合指数等大盘走势。
* **接口地址**：`/stock/indices?countryId=48`
* **功能亮点**：返回指数最新价、涨跌额，并包含 `isOpen` 字段，实时反馈印尼市场是否处于交易时段。
### 2. IPO 新股日历：挖掘印尼增长红利
印尼近年来有多家大型科技巨头（如 GoTo）上市。利用 IPO 接口，您可以轻松追踪最新上市动态。
* **接口地址**：`/stock/getIpo`
* **参数配置**：`countryId=48`，`type=1`（未上市/待申购）或 `type=2`（已上市记录）。
* **返回信息**：包含 `ipoListing`（上市时间）、`ipoPrice`（发行价）以及所属公司的基本面数据。
### 3. K 线数据：专业级技术分析支持
为您的应用提供分时、日线及周线图表渲染支持，方便用户进行技术指标分析。
* **接口地址**：`/stock/kline`
* **参数说明**：通过传入股票的 `pid` 和周期 `interval`（支持 `PT1M` 分钟线、`P1D` 日线等）获取标准 OHLC 数据。
### 4. 公司深度信息：基本面调研必备
除了价格波动，StockTV 还提供了详尽的公司背景资料。
* **接口地址**：`/stock/companies?countryId=48`
* **内容涵盖**：公司描述 (`description`)、所属行业 (`industry`)、板块 (`sector`) 及员工人数等信息。
## 三、 为什么选择 StockTV 的印尼股票数据？
1. **极简集成**：只需变更 `countryId=48` 即可在统一的架构下切换至印尼市场，无需为每个国家编写独立的解析逻辑。
2. **数据维度丰富**：涵盖从实时行情、指数、IPO 追踪到 K 线及公司背景的全方位数据。
3. **高性能保障**：支持 WebSocket 接入，确保在市场波动剧烈时数据传输依然稳定且低延迟。
4. **全方位技术支持**：提供 7x24 小时技术辅助，助力项目快速落地。
## 四、 快速集成示例 (JavaScript)
```javascript
const axios = require('axios');
async function getIndonesiaMarket() {
const response = await axios.get('https://api.stocktv.top/stock/stocks', {
params: {
countryId: 48,
pageSize: 5,
key: 'YOUR_API_KEY'
}
});
if (response.data.code === 200) {
const stocks = response.data.data.records;
stocks.forEach(stock => {
console.log(`代码: ${stock.symbol}, 价格: ${stock.last}, 涨跌: ${stock.chgPct}%`);
});
}
}
getIndonesiaMarket();
