当前位置：首页 > news >正文

印尼雅加达综合指数(JCI)数据对接实战指南

news 2025/9/30 14:04:56

印尼雅加达综合指数(JCI)数据对接实战指南

本文介绍了如何通过API接口获取印尼股市数据，重点讲解雅加达综合指数(JCI)的实时行情、历史K线等数据的获取方法，并提供完整的代码示例。

一、API接口概述

本文使用的金融数据API提供了全面的印尼股市数据服务，包括：

股票列表查询 - 获取印尼交易所所有上市公司信息
指数数据 - 获取雅加达综合指数(JCI)等主要指数
实时行情 - 获取个股和指数的实时价格数据
历史K线 - 获取不同时间周期的K线数据
公司信息 - 获取上市公司基本资料
WebSocket推送 - 实时行情推送

二、印尼市场标识

在调用API前，需要了解印尼市场的标识参数：

国家ID: 42 (印尼的国家编号)
交易所: 雅加达证券交易所(IDX)
主要指数: 雅加达综合指数(JCI)

三、核心API接口详解

3.1 获取印尼股票列表

接口地址: GET /stock/stocks

请求参数:

GET https://api.stocktv.top/stock/stocks?countryId=42&pageSize=50&page=1&key=您的API_KEY

参数说明:

countryId=42 - 印尼国家编号
pageSize=50 - 每页返回数量
page=1 - 页码
key - API访问密钥

响应示例:

{"code": 200,"message": "操作成功","data": {"records": [{"id": 41602,"name": "Bank Central Asia","symbol": "BBCA","last": 9250,"chg": 50,"chgPct": 0.54,"volume": 1241700,"marketCap": "2024700000000","sector": "Financials","industry": "Banking","url": "/equities/bank-central-asia"},// 更多股票...],"total": 683,"size": 50,"current": 1,"pages": 14}
}

3.2 获取印尼指数数据

接口地址: GET /stock/indices

请求参数:

GET https://api.stocktv.top/stock/indices?countryId=42&key=您的API_KEY

响应示例:

{"code": 200,"message": "操作成功","data": [{"id": 17940,"name": "Jakarta Composite Index","symbol": "JCI","last": 7296.83,"high": 7312.45,"low": 7254.67,"chg": 42.16,"chgPct": 0.58,"time": 1725002394,"url": "/indices/jakarta-composite"},{"id": 17941,"name": "LQ45 Index","symbol": "LQ45","last": 985.32,"chg": 8.45,"chgPct": 0.86,"time": 1725002394}// 更多指数...]
}

3.3 获取指数K线数据

接口地址: GET /stock/kline

请求参数:

GET https://api.stocktv.top/stock/kline?pid=17940&interval=P1D&key=您的API_KEY

参数说明:

pid=17940 - 雅加达综合指数的产品ID
interval=P1D - 时间周期(日线)
可选周期: PT5M(5分钟), PT15M(15分钟), PT1H(1小时), P1D(日线), P1W(周线), P1M(月线)

响应示例:

{"code": 200,"message": "操作成功","data": [{"time": 1722384000000,"open": 7254.67,"high": 7312.45,"low": 7248.92,"close": 7296.83,"volume": 4521800000,"vo": 32845600000000},{"time": 1722297600000,"open": 7236.45,"high": 7268.92,"low": 7215.28,"close": 7254.67,"volume": 4125600000,"vo": 29874500000000}// 更多K线数据...]
}

3.4 通过ID查询特定指数

接口地址: GET /stock/indicesById

请求参数:

GET https://api.stocktv.top/stock/indicesById?id=17940&key=您的API_KEY

四、代码实战示例

4.1 Python获取雅加达综合指数数据

import requests
import pandas as pd
from datetime import datetimeclass IndonesiaStockAPI:def __init__(self, api_key):self.base_url = "https://api.stocktv.top"self.api_key = api_keyself.headers = {'Content-Type': 'application/json'}def get_jci_index(self):"""获取雅加达综合指数实时数据"""url = f"{self.base_url}/stock/indices?countryId=42&key={self.api_key}"try:response = requests.get(url, headers=self.headers)data = response.json()if data['code'] == 200:# 查找雅加达综合指数for index in data['data']:if index['symbol'] == 'JCI':return indexreturn Noneexcept Exception as e:print(f"获取指数数据失败: {e}")return Nonedef get_jci_kline(self, interval='P1D', limit=100):"""获取JCI历史K线数据"""# 首先获取JCI的PIDjci_data = self.get_jci_index()if not jci_data:return Nonepid = jci_data['id']url = f"{self.base_url}/stock/kline?pid={pid}&interval={interval}&key={self.api_key}"try:response = requests.get(url, headers=self.headers)data = response.json()if data['code'] == 200:# 转换为DataFramedf = pd.DataFrame(data['data'])df['date'] = pd.to_datetime(df['time'], unit='ms')df.set_index('date', inplace=True)return dfreturn Noneexcept Exception as e:print(f"获取K线数据失败: {e}")return None# 使用示例
if __name__ == "__main__":api = IndonesiaStockAPI("您的API_KEY")# 获取实时指数jci_data = api.get_jci_index()if jci_data:print(f"雅加达综合指数: {jci_data['last']}")print(f"涨跌: {jci_data['chg']} ({jci_data['chgPct']}%)")# 获取历史K线jci_kline = api.get_jci_kline(interval='P1D', limit=30)if jci_kline is not None:print("\n最近5个交易日数据:")print(jci_kline[['open', 'high', 'low', 'close', 'volume']].head())

4.2 JavaScript实时监控示例

// 印尼股市实时监控面板
class IndonesiaStockMonitor {constructor(apiKey) {this.apiKey = apiKey;this.baseUrl = 'https://api.stocktv.top';this.wsUrl = 'wss://ws-api.stocktv.top/connect';this.socket = null;}// 初始化监控面板async init() {await this.loadIndices();this.connectWebSocket();this.setupAutoRefresh();}// 加载指数数据async loadIndices() {try {const response = await fetch(`${this.baseUrl}/stock/indices?countryId=42&key=${this.apiKey}`);const data = await response.json();if (data.code === 200) {this.displayIndices(data.data);}} catch (error) {console.error('加载指数数据失败:', error);}}// 显示指数数据displayIndices(indices) {const container = document.getElementById('indices-container');container.innerHTML = '';indices.forEach(index => {const changeClass = index.chg >= 0 ? 'positive' : 'negative';const changeIcon = index.chg >= 0 ? '↑' : '↓';const indexElement = `<div class="index-card"><h3>${index.name} (${index.symbol})</h3><div class="price">${index.last.toLocaleString()}</div><div class="change ${changeClass}">${changeIcon} ${Math.abs(index.chg)} (${Math.abs(index.chgPct)}%)</div><div class="time">${this.formatTime(index.time)}</div></div>`;container.innerHTML += indexElement;});}// 连接WebSocket获取实时数据connectWebSocket() {this.socket = new WebSocket(`${this.wsUrl}?key=${this.apiKey}`);this.socket.onopen = () => {console.log('WebSocket连接已建立');// 订阅印尼指数this.socket.send(JSON.stringify({action: 'subscribe',symbols: ['PID:17940'] // JCI的PID}));};this.socket.onmessage = (event) => {const data = JSON.parse(event.data);this.updateRealTimeData(data);};this.socket.onerror = (error) => {console.error('WebSocket错误:', error);};}// 更新实时数据updateRealTimeData(data) {if (data.pid === 17940) { // JCI的PIDconst jciElement = document.querySelector('.index-card:first-child');if (jciElement) {const priceElement = jciElement.querySelector('.price');const changeElement = jciElement.querySelector('.change');const timeElement = jciElement.querySelector('.time');priceElement.textContent = data.last_numeric.toLocaleString();const changeClass = data.pc >= 0 ? 'positive' : 'negative';const changeIcon = data.pc >= 0 ? '↑' : '↓';changeElement.className = `change ${changeClass}`;changeElement.innerHTML = `${changeIcon} ${Math.abs(data.pc)} (${Math.abs(data.pcp)}%)`;timeElement.textContent = this.formatTime(data.timestamp);}}}// 设置自动刷新setupAutoRefresh() {// 每分钟刷新一次指数数据setInterval(() => {this.loadIndices();}, 60000);}// 时间格式化formatTime(timestamp) {return new Date(timestamp * 1000).toLocaleTimeString();}
}// 页面加载完成后初始化
document.addEventListener('DOMContentLoaded', () => {const monitor = new IndonesiaStockMonitor('您的API_KEY');monitor.init();
});

4.3 对应的HTML结构

<!DOCTYPE html>
<html>
<head><title>印尼股市实时监控</title><style>.index-card {border: 1px solid #ddd;border-radius: 8px;padding: 15px;margin: 10px;background: #f9f9f9;}.price {font-size: 24px;font-weight: bold;margin: 10px 0;}.change.positive {color: green;}.change.negative {color: red;}.time {color: #666;font-size: 12px;}#indices-container {display: grid;grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));gap: 15px;}</style>
</head>
<body><h1>印尼雅加达综合指数实时监控</h1><div id="indices-container"><!-- 指数数据将在这里动态显示 --></div><script src="indonesia-stock-monitor.js"></script>
</body>
</html>