本接口文档旨在帮助开发者快速接入印度尼西亚证券交易所(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: 每页记录数,默认 10
- page: 当前页码
- 核心字段说明:
- last: 最新成交价。
- chgPct: 涨跌百分比(前端展示时直接拼接 %)。
- symbol: 股票代码(如印尼主流个股代码)。
- volume: 实时交易量。
- time: 数据同步时间戳。
2.2 雅加达综合指数 (Indices)
监控印尼大盘(如 JKSE - 雅加达综合指数)的整体走势。
- 接口地址:/stock/indices
- 请求参数:countryId=48
- 关键字段:
- isOpen: 市场是否处于交易状态(0: 休市, 1: 开盘)。
- last: 指数当前点位。
2.3 IPO 新股日历
获取印尼市场近期拟上市及新近上市的股票信息。
- 接口地址:/stock/getIpo
- 请求参数:
- countryId=48
- type: 1 为未上市(打新预警),2 为已上市(历史表现)。
- 核心字段:ipoListing (上市时间戳)、ipoPrice (发行价格)、company (公司全称)。
2.4 K 线历史数据
获取指定印尼个股的历史价格波动,支持 1 分钟至月线周期。
- 接口地址:/stock/kline
- 请求参数:
- pid: 股票的唯一 ID
- interval: 周期(PT1M 1分钟, PT1H 1小时, 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,您的金融应用将具备实时洞察印尼市场脉搏的能力,助力用户把握东南亚新兴市场的投资先机。
来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作! |