印度尼西亞作為東南亞最大的經濟體，其證券市場（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 的印尼股票數據？
- 極簡集成：只需變更
countryId=48即可在統一的架構下切換至印尼市場，無需為每個國家編寫獨立的解析邏輯。 - 數據維度豐富：涵蓋從實時行情、指數、IPO 追蹤到 K 線及公司背景的全方位數據。
- 高性能保障：支持 WebSocket 接入，確保在市場波動劇烈時數據傳輸依然穩定且低延遲。
- 全方位技術支持：提供 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();
