动态

详情 返回 返回

python對接印度尼西亞股票數據接口文檔 - 动态 详情

概述

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: 印尼國家ID
  • pageSize: 每頁數量 (默認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 Asia
  • BBRI: Bank Rakyat Indonesia
  • BMRI: Bank Mandiri
  • TLKM: Telkom Indonesia
  • ASII: 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: 服務器內部錯誤

最佳實踐

  1. 批量查詢: 使用stocksByPids接口批量獲取LQ45成分股數據
  2. WebSocket連接: 對於實時監控使用WebSocket連接
  3. 本地緩存: 對公司信息等靜態數據實施緩存
  4. 錯誤重試: 實現適當的錯誤重試機制
  5. 數據格式化: 注意印尼盾金額的格式化顯示

注意事項

  1. 貨幣單位: 所有價格均為印尼盾,注意數值較大時的顯示處理
  2. 交易時間: 注意雅加達時區與本地時區的轉換
  3. 數據精度: 價格精確到印尼盾,成交量精確到股
  4. 行業分類: 印尼有獨特的行業分類標準,需注意映射

本文檔基於 StockTV API 生成,具體接口參數以最新官方文檔為準。印尼國家ID需要向官方確認正確數值。

user avatar cyzf 头像 zaotalk 头像 freeman_tian 头像 chongdianqishi 头像 lenglengdechaomian 头像 yuzhihui 头像 bugDiDiDi 头像 DingyLand 头像 huangmingji 头像 lovecola 头像 weishiledanhe 头像 shuyuanutil 头像
点赞 86 用户, 点赞了这篇动态!
点赞

Add a new 评论

Some HTML is okay.