本接口文档旨在帮助开发者快速接入印度尼西亚证券交易所（IDX）的实时市场数据。通过统一的 API 架构，开发者只需指定 countryId=48 即可获取印尼市场的全量金融信息。
1. 接入准备
- API 基础路径：
https://api.stocktv.top - 国家代码 (countryId)：
48（代表印度尼西亚） - 鉴权方式：所有请求必须在 URL 参数中携带有效
key。 - 数据格式：统一为
JSON格式。
2. 核心 API 接口说明
2.1 股票市场列表 (实时行情)
获取印尼市场所有活跃股票的最新价格、涨跌幅及成交量。
- 接口地址：
/stock/stocks - 请求方式：
GET - 请求参数：
countryId=48(必填)pageSize: 每页记录数，默认 10page: 当前页码
- 核心字段说明：
last: 最新成交价。chgPct: 涨跌百分比（前端展示时直接拼接%）。symbol: 股票代码（如印尼主流个股代码）。volume: 实时交易量。time: 数据同步时间戳。
2.2 雅加达综合指数 (Indices)
监控印尼大盘（如 JKSE - 雅加达综合指数）的整体走势。
- 接口地址：
/stock/indices - 请求参数：
countryId=48 - 关键字段：
isOpen: 市场是否处于交易状态（0: 休市, 1: 开盘）。last: 指数当前点位。
2.3 IPO 新股日历
获取印尼市场近期拟上市及新近上市的股票信息。
- 接口地址：
/stock/getIpo - 请求参数：
countryId=48type: 1 为未上市（打新预警），2 为已上市（历史表现）。
- 核心字段：
ipoListing(上市时间戳)、ipoPrice(发行价格)、company(公司全称)。
2.4 K 线历史数据
获取指定印尼个股的历史价格波动，支持 1 分钟至月线周期。
- 接口地址：
/stock/kline - 请求参数：
pid: 股票的唯一 IDinterval: 周期（PT1M1分钟,PT1H1小时,P1D日线等）
- 数据结构：返回包含
open,high,low,close,volume的数组。
2.5 公司基本面深度信息
获取印尼上市公司的业务描述、所属行业及员工规模。
- 接口地址：
/stock/companies - 请求参数：
countryId=48 - 关键字段：
description(业务详述)、sector(所属板块)、industry(行业分类)。
3. 快速接入代码示例 (Node.js)
const axios = require('axios');
const config = {
baseURL: 'https://api.stocktv.top',
apiKey: 'YOUR_API_KEY', // 联系官方获取
indonesiaId: 48
};
async function getIndonesianStocks() {
try {
const response = await axios.get(`${
config.baseURL}/stock/stocks`, {
params: {
countryId: config.indonesiaId,
key: config.apiKey,
pageSize: 5
}
});
if (response.data.code === 200) {
console.log('印尼股票行情数据:', response.data.data.records);
}
} catch (error) {
console.error('API请求错误:', error.message);
}
}
getIndonesianStocks();
4. 为什么选择该数据源？
- 极简切换：仅需修改
countryId即可横跨印尼、印度、美国等 10+ 国家市场。 - 全量数据：不仅有实时报价，更包含关键的 IPO 打新日历和公司深度背景数据。
- 技术保障：提供 HTTP 和 WebSocket 双向接入，支持极速盘面刷新。
结语：通过对接 countryId=48，您的金融应用将具备实时洞察印尼市场脉搏的能力，助力用户把握东南亚新兴市场的投资先机。
