印度尼西亚股票市场API对接文档

一、概述

StockTV提供全球股票市场数据接口服务，本文档专门介绍印度尼西亚股票市场的API对接方案。通过本接口，开发者可以获取印尼股市的实时行情、历史数据、公司信息等关键金融数据。

二、准备工作

1. 获取API Key

联系StockTV官方获取API访问密钥：

• Telegram: @CryptoRzz
• 所有请求需包含key参数

2. 基础信息

• 国家ID：48（印度尼西亚）
• 主要交易所：
  • IDX（印尼证券交易所）
• 数据格式：JSON
• 支持协议：HTTP/HTTPS、WebSocket

三、核心接口

1. 印尼股票市场列表

接口地址
GET /stock/stocks

请求参数：

参数	必填	说明	示例
countryId	是	印尼国家ID=48	48
pageSize	否	每页数量	20
page	否	页码	1

请求示例：

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

响应示例：

{
  "code": 200,
  "data": {
    "records": [
      {
        "id": 50123,
        "symbol": "BBCA", 
        "name": "Bank Central Asia",
        "last": 8250,
        "chg": +125,
        "chgPct": +1.54%,
        "volume": 12500000,
        "exchangeId": 85,
        "countryId": 42,
        "open": true
      },
      {...}
    ],
    "total": 843
  }
}

2. 股票详情查询

接口地址
GET /stock/queryStocks

请求参数：

参数	必填	说明	示例
id	否	股票PID	50123
symbol	否	股票代码	BBCA

请求示例：

GET https://api.stocktv.top/stock/queryStocks?symbol=BBCA&key=您的APIKey

3. 印尼股指数据

接口地址
GET /stock/indices

请求示例：

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

响应字段：

• IDX Composite（雅加达综合指数）
• LQ45指数
• 各行业板块指数

4. 历史K线数据

接口地址
GET /stock/kline

请求参数：

参数	必填	说明	可选值
pid	是	股票PID	-
interval	是	时间间隔	PT5M,PT15M,P1D等

时间间隔对照表：

参数值	说明
PT5M	5分钟
PT1H	1小时
P1D	日线

5. 公司基本信息

接口地址
GET /stock/companies

请求示例：

GET https://api.stocktv.top/stock/companies?countryId=42&pageSize=10&key=您的APIKey

四、WebSocket实时数据

连接配置

wss://ws-api.stocktv.top/connect?key=您的APIKey

数据格式

{
  "pid": "50123",
  "symbol": "BBCA",
  "last": 8250,
  "chg": "+125",
  "volume": 12500000,
  "timestamp": 1634567890
}

五、注意事项

1. 交易时间：

   • 印尼股市交易时间：雅加达时间09:00-16:00
   • UTC时间02:00-09:00（夏令时调整）

2. 特殊字段说明：

   • 价格单位：印尼卢比(IDR)
   • 最小价格变动：1 IDR

3. 频率限制：

   • 默认限制：10次/秒
   • 高频需求需申请提升限额

六、错误处理

错误码	说明	解决方案
401	无效API Key	检查Key或联系客服
404	数据不存在	检查参数是否正确
429	请求过频	降低请求频率

七、最佳实践

1. 建议先调用市场列表接口获取股票PID
2. 对高频数据使用WebSocket连接
3. 本地缓存常用股票的基本信息
4. 时区处理注意转换为WIB(UTC+7)

如需进一步协助，请联系StockTV技术支持团队。