概述
StockTV 提供全面的印度尼西亞股票市場數據接口,覆蓋印尼證券交易所(IDX)所有上市公司。支持實時行情、技術分析、公司信息等多種功能。
交易所信息
- 交易所: 印尼證券交易所 (Indonesia Stock Exchange, IDX)
- 國家ID:
42(從文檔中馬來西亞示例推斷,具體需確認) - 交易時間: 雅加達時間 09:00-12:00, 13:30-16:00
- 貨幣: 印尼盾 (IDR)
核心功能接口
1. 實時行情數據
獲取印尼股票列表
GET /stock/stocks?countryId=42&pageSize=50&page=1&key=您的API_KEY
參數説明:
countryId: 印尼國家IDpageSize: 每頁數量 (默認10,最大100)page: 頁碼exchangeId: 交易所ID (可選)
響應示例:
{
"code": 200,
"message": "操作成功",
"data": {
"records": [
{
"id": 41602,
"symbol": "BBCA",
"name": "Bank Central Asia Tbk",
"last": 9850,
"chg": 50,
"chgPct": 0.51,
"high": 9900,
"low": 9800,
"volume": 1241700,
"open": true,
"lastPairDecimal": 0,
"countryNameTranslated": "Indonesia",
"flag": "ID",
"exchangeId": 62,
"time": 1716448222,
"url": "/equities/bank-central-asia",
"fundamentalMarketCap": 202470000000000,
"fundamentalRevenue": "145.22T",
"performanceDay": 0.51,
"performanceWeek": 2.34,
"performanceMonth": 5.67
}
],
"total": 800,
"current": 1,
"pages": 16
}
}
2. 主要指數數據
獲取印尼主要指數
GET /stock/indices?countryId=42&key=您的API_KEY
包含的主要指數:
- IDX Composite (IHSG)
- LQ45 Index
- Jakarta Islamic Index
- Kompas100 Index
指數數據示例:
{
"code": 200,
"message": "操作成功",
"data": [
{
"id": 17950,
"name": "IDX Composite",
"symbol": "JCI",
"last": 7298.45,
"chg": 45.32,
"chgPct": 0.62,
"high": 7312.65,
"low": 7253.43,
"isOpen": true,
"flag": "ID",
"time": 1716458537
}
]
}
3. 個股查詢功能
查詢特定股票
GET /stock/queryStocks?symbol=BBCA&key=您的API_KEY
通過PID查詢股票
GET /stock/queryStocks?id=41602&key=您的API_KEY
批量查詢多個股票
GET /stock/stocksByPids?key=您的API_KEY&pids=41602,41603,41604
熱門印尼股票代碼:
BBCA: Bank Central AsiaBBRI: Bank Rakyat IndonesiaBMRI: Bank MandiriTLKM: Telkom IndonesiaASII: Astra International
4. K線數據(技術分析)
獲取股票K線數據
GET /stock/kline?pid=41602&interval=PT1H&key=您的API_KEY
時間間隔參數:
PT5M- 5分鐘PT15M- 15分鐘PT1H- 1小時P1D- 1天P1W- 1周P1M- 1月
K線數據格式:
{
"time": 1719818400000,
"open": 9800,
"high": 9850,
"low": 9780,
"close": 9850,
"volume": 1250000,
"vo": 12250000000
}
5. 漲跌排行榜
獲取印尼市場排行榜
GET /stock/updownList?countryId=42&type=1&key=您的API_KEY
排行榜類型:
type=1: 漲幅榜type=2: 跌幅榜type=3: 成交額榜type=4: 成交量榜
6. 公司基本信息
獲取印尼上市公司信息
GET /stock/companies?countryId=42&pageSize=20&page=1&key=您的API_KEY
公司信息示例:
{
"code": 200,
"message": "操作成功",
"data": {
"records": [
{
"companyName": "Bank Central Asia Tbk Company Profile",
"description": "Bank Central Asia Tbk provides banking products and services in Indonesia and internationally. The company operates through Network and Transaction Banking segments...",
"industry": "Banking",
"sector": "Financials",
"employeeCount": 25643,
"market": "Indonesia",
"countryId": 42,
"url": "/equities/bank-central-asia",
"id": 101
}
],
"total": 800,
"current": 1,
"pages": 40
}
}
7. 技術指標數據
包含的技術指標:
technicalDay: 日線技術指標technicalHour: 小時線技術指標technicalWeek: 周線技術指標technicalMonth: 月線技術指標
技術指標值:
strong_buy: 強烈買入buy: 買入neutral: 中性sell: 賣出strong_sell: 強烈賣出
8. 基本面數據
包含的基本面指標:
fundamentalBeta: Beta值fundamentalMarketCap: 市值 (印尼盾)fundamentalRevenue: 收入fundamentalRatio: 基本面比率performanceDay: 當日表現performanceWeek: 周表現performanceMonth: 月表現performanceYtd: 年初至今表現
9. WebSocket 實時數據
連接WebSocket
const wsUri = "wss://ws-api.stocktv.top/connect?key=您的API_KEY";
const websocket = new WebSocket(wsUri);
實時數據格式
{
"pid": "41602",
"last_numeric": "9850",
"bid": "9845",
"ask": "9855",
"high": "9900",
"low": "9800",
"last_close": "9800",
"pc": "50",
"pcp": "0.51",
"turnover_numeric": "1241700",
"time": "15:30:25",
"timestamp": "1717728251",
"type": 1
}
印尼市場特色
1. 行業分類
- 金融業: 銀行、保險、金融服務
- 基礎材料: 礦業、種植業
- 消費品: 食品飲料、煙草
- 基礎設施: 電信、運輸、公用事業
- 房地產: 房地產投資信託
2. 主要板塊
- LQ45: 流動性最強的45只股票
- KOMPAS100: 市值最大的100家公司
- BISNIS-27: 商業27指數
- PEFINDO25: 債券相關股票指數
3. 交易特點
- 以手為單位交易,1手通常為100股
- 價格變動最小單位為1印尼盾
- 有漲跌幅限制機制
- 支持盤後交易
使用示例
獲取LQ45成分股
GET /stock/stocks?countryId=42&pageSize=45&key=您的API_KEY
監控銀行板塊
GET /stock/queryStocks?symbol=BBCA,BBRI,BMRI,BNGA&key=您的API_KEY
獲取實時指數數據
GET /stock/indicesById?id=17950&key=您的API_KEY
數據更新頻率
- 實時行情: 秒級更新
- K線數據: 按選擇間隔實時更新
- 指數數據: 實時更新
- 公司信息: 每日更新
- 基本面數據: 實時更新
錯誤處理
{
"code": 400,
"message": "參數錯誤",
"data": null
}
常見錯誤代碼:
200: 操作成功400: 參數錯誤401: API Key無效404: 數據不存在500: 服務器內部錯誤
最佳實踐
- 批量查詢: 使用
stocksByPids接口批量獲取LQ45成分股數據 - WebSocket連接: 對於實時監控使用WebSocket連接
- 本地緩存: 對公司信息等靜態數據實施緩存
- 錯誤重試: 實現適當的錯誤重試機制
- 數據格式化: 注意印尼盾金額的格式化顯示
注意事項
- 貨幣單位: 所有價格均為印尼盾,注意數值較大時的顯示處理
- 交易時間: 注意雅加達時區與本地時區的轉換
- 數據精度: 價格精確到印尼盾,成交量精確到股
- 行業分類: 印尼有獨特的行業分類標準,需注意映射
本文檔基於 StockTV API 生成,具體接口參數以最新官方文檔為準。印尼國家ID需要向官方確認正確數值。