获取马来西亚股票数据API：KLSE、MRY市场对接完全指南

获取马来西亚股票数据API：KLSE、MRY市场对接完全指南

本文提供马来西亚股票市场（KLSE、MRY）的完整API对接方案，包含实时行情、历史数据、公司信息等接口

概述

本文介绍了如何通过API接口获取马来西亚证券交易所（Bursa Malaysia，简称KLSE）的股票数据。该API支持获取实时行情、历史K线、公司基本信息、市场新闻等多种数据，覆盖马来西亚股市的所有上市股票。

核心功能特性

• ✅ 实时行情数据 - 获取最新股价、涨跌幅、成交量等信息
• ✅ 历史K线数据 - 支持多时间粒度（5分钟、15分钟、1小时、日线等）
• ✅ 市场指数数据 - 获取马来西亚主要指数行情
• ✅ 公司基本信息 - 查询上市公司详细信息和财务数据
• ✅ 实时新闻资讯 - 获取与马来西亚市场相关的财经新闻
• ✅ WebSocket实时推送 - 支持实时行情推送

API接口详情

1. 获取马来西亚市场股票列表

接口地址: GET /stock/stocks

请求参数:

GET https://api.stocktv.top/stock/stocks?countryId=42&pageSize=10&page=1&key=您的API密钥

参数说明:

• countryId: 国家ID，马来西亚为42
• pageSize: 每页显示数量，默认10
• page: 页码，默认1
• key: API访问密钥

响应示例:

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "id": 41602,
        "name": "Media Chinese Int",
        "symbol": "MDCH",
        "last": 0.12,
        "chg": 0,
        "chgPct": 0,
        "high": 0.12,
        "low": 0.12,
        "volume": 1241700,
        "avgVolume": 441318,
        "countryNameTranslated": "Malaysia",
        "flag": "MY",
        "open": false,
        "time": 1716448222
      }
    ],
    "total": 1000,
    "size": 10,
    "current": 1,
    "pages": 500
  }
}

2. 查询特定股票信息

接口地址: GET /stock/queryStocks

请求参数:

GET https://api.stocktv.top/stock/queryStocks?id=7310&key=您的API密钥

参数说明:

• id: 股票PID（可通过市场列表接口获取）
• name: 股票名称（可选）
• symbol: 股票代码（可选）
• key: API访问密钥

3. 获取马来西亚市场指数

接口地址: GET /stock/indices

请求参数:

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

4. 获取K线数据

接口地址: GET /stock/kline

请求参数:

GET https://api.stocktv.top/stock/kline?pid=7310&interval=PT15M&key=您的API密钥

时间间隔参数:

• PT5M: 5分钟
• PT15M: 15分钟
• PT1H: 1小时
• P1D: 1天
• P1W: 1周
• P1M: 1月

5. WebSocket实时行情推送

连接地址:

wss://ws-api.stocktv.top/connect?key=您的API密钥

数据格式:

{
  "pid": "992844",
  "last_numeric": "0.68",
  "last_dir": "greenBg",
  "bid": "0.675",
  "ask": "0.680",
  "high": "0.680",
  "low": "0.650",
  "last_close": "0.680",
  "pc": "0.000",
  "pcp": "0.00",
  "time": "02:44:11",
  "timestamp": "1717728251",
  "turnover_numeric": "3672800",
  "type": 1
}

使用示例

Python请求示例

import requests
import json

# 配置API密钥
API_KEY = "您的API密钥"
BASE_URL = "https://api.stocktv.top"

# 获取马来西亚股票列表
def get_malaysia_stocks(page=1, page_size=10):
    url = f"{BASE_URL}/stock/stocks"
    params = {
        "countryId": 42,  # 马来西亚国家ID
        "page": page,
        "pageSize": page_size,
        "key": API_KEY
    }
    
    response = requests.get(url, params=params)
    if response.status_code == 200:
        return response.json()
    else:
        return None

# 获取特定股票信息
def get_stock_info(pid):
    url = f"{BASE_URL}/stock/queryStocks"
    params = {
        "id": pid,
        "key": API_KEY
    }
    
    response = requests.get(url, params=params)
    if response.status_code == 200:
        return response.json()
    else:
        return None

# 示例使用
if __name__ == "__main__":
    # 获取第一页的马来西亚股票
    stocks = get_malaysia_stocks(1, 10)
    if stocks and stocks["code"] == 200:
        print("获取到马来西亚股票数据:")
        for stock in stocks["data"]["records"]:
            print(f"{stock['symbol']} - {stock['name']}: {stock['last']}")

JavaScript使用示例

// 使用Fetch API获取数据
const API_KEY = '您的API密钥';
const BASE_URL = 'https://api.stocktv.top';

// 获取马来西亚股票列表
async function getMalaysiaStocks(page = 1, pageSize = 10) {
  const url = `${BASE_URL}/stock/stocks?countryId=42&page=${page}&pageSize=${pageSize}&key=${API_KEY}`;
  
  try {
    const response = await fetch(url);
    const data = await response.json();
    return data;
  } catch (error) {
    console.error('获取数据失败:', error);
    return null;
  }
}

// 使用示例
getMalaysiaStocks(1, 10)
  .then(data => {
    if (data && data.code === 200) {
      console.log('马来西亚股票数据:', data.data.records);
    }
  });

注意事项

1. API密钥申请：需要联系API提供商获取有效的API密钥
2. 请求频率限制：请注意API的请求频率限制，避免过于频繁的请求
3. 数据更新频率：实时数据更新频率取决于API供应商的设置
4. 错误处理：在实际使用中应添加适当的错误处理机制
5. 数据缓存：考虑对不常变的数据进行缓存，减少API调用次数

常见问题

Q: 如何获取API密钥？
A: 需要联系API服务提供商申请API密钥。

Q: 支持哪些时间粒度的K线数据？
A: 支持5分钟、15分钟、1小时、5小时、1天、1周、1月等多种时间粒度。

Q: 是否有请求次数限制？
A: 是的，具体限制请咨询API服务提供商。

Q: 数据延迟是多少？
A: 实时数据通常有微小延迟，具体延迟取决于API供应商。

总结

通过本文介绍的API接口，开发者可以轻松获取马来西亚股票市场的实时行情、历史数据和其他相关信息。这些接口设计简单易懂，支持多种编程语言调用，适合用于开发股票分析应用、投资决策工具或金融数据平台。

无论是个人投资者还是金融机构，都可以利用这些API构建自己的马来西亚股市分析系统，实现数据驱动的投资决策。

---

版权声明：本文涉及API接口由相应服务商提供，使用前请确保已获得合法授权。本文仅做技术交流用途，不构成任何投资建议。