印度尼西亚股票数据 API 对接实战（含实时行情与 IPO 功能）

印度尼西亚作为东南亚最大的经济体，其证券市场（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
• 请求示例：

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)

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();