马来西亚、印度、韩国股票数据API接入指南

一、通用规则

1. 认证方式
   需注册获取API Key，通过请求头 Authorization 传递：

   Authorization: Bearer your_api_key
   

2. 数据格式
   请求与响应均使用 JSON 格式，字符编码为UTF-8。

3. 频率限制
   免费版：10次/分钟；付费版根据套餐调整。

---

二、API接口说明

1. 实时行情（多国支持）

Endpoint

GET /api/v1/quote

参数

参数	说明	示例
symbol	股票代码（市场前缀标识）	MY:7150, IN:TCS, KR:005930
fields	可选字段（默认全部返回）	open,high,low,last_volume

市场前缀标识

• 马来西亚：MY:（如 MY:7150 对应 AXIATA）
• 印度：IN:（如 IN:TCS 对应塔塔咨询）
• 韩国：KR:（如 KR:005930 对应三星电子）

请求示例

import requests

url = "https://pao.stocktv.top/api/v1/quote"
params = {
    "symbol": "KR:005930,MY:7150",
    "fields": "last_price,volume,change_percent"
}
headers = {"Authorization": "Bearer your_api_key"}

response = requests.get(url, params=params, headers=headers)
data = response.json()
print(data)

响应示例

{
  "code": 200,
  "data": [
    {
      "symbol": "KR:005930",
      "last_price": 78500,
      "volume": 1254321,
      "change_percent": "+1.2%"
    },
    {
      "symbol": "MY:7150",
      "last_price": 2.85,
      "volume": 450000,
      "change_percent": "-0.3%"
    }
  ]
}

---

2. 历史数据查询

Endpoint

GET /api/v1/history

参数

参数	说明	示例
symbol	股票代码	IN:RELIANCE
start_date	开始日期（YYYY-MM-DD）	2023-01-01
end_date	结束日期（YYYY-MM-DD）	2023-06-30
interval	时间粒度（daily/weekly/monthly）	daily

请求示例

params = {
    "symbol": "IN:RELIANCE",
    "start_date": "2023-01-01",
    "end_date": "2023-01-10",
    "interval": "daily"
}
response = requests.get(url, headers=headers, params=params)

响应示例

{
  "code": 200,
  "data": [
    {
      "date": "2023-01-01",
      "open": 2500,
      "high": 2532,
      "low": 2485,
      "close": 2520,
      "volume": 1500000
    },
    ...
  ]
}

---

3. 市场指数查询（如KOSPI、NIFTY 50等）

Endpoint

GET /api/v1/index

参数

参数	说明	示例
region	地区代码（my/in/kr）	kr
index	指数代码（可选）	KOSPI, NIFTY

请求示例

GET /api/v1/index?region=kr

响应示例

{
  "code": 200,
  "data": [
    {
      "index_code": "KOSPI",
      "last_value": 2615.41,
      "change": "+12.3"
    },
    {
      "index_code": "KOSDAQ",
      "last_value": 879.15,
      "change": "-2.1"
    }
  ]
}

---

三、错误处理

常见错误码：

• 401 Unauthorized: API Key无效或缺失
• 403 Forbidden: 请求频率超限
• 404 Not Found: 股票代码不存在
• 500 Internal Error: 服务器内部错误

---

四、应用场景

1. 量化交易系统：实时获取多国行情数据支持策略开发。
2. 移动端App：集成股票价格提醒功能。
3. 财务报表分析：批量下载历史数据用于回测。

---

五、注意事项

1. 韩国市场数据延迟约15分钟（免费版）。
2. 印度股票代码使用NSE的缩写格式（如IN:INFY）。
3. 需遵守平台的数据使用协议，禁止商业化转售。

---

官方文档：https://pao.stocktv.top/
技术支持：paopao

---

以上为基于公开信息的通用API设计示例，实际接口参数请以平台文档为准。