一、通用规则
-
认证方式
需注册获取API Key，通过请求头Authorization传递：Authorization: Bearer your_api_key -
数据格式
请求与响应均使用 JSON 格式，字符编码为UTF-8。 -
频率限制
免费版：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 requestsurl = "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: 服务器内部错误
四、应用场景
- 量化交易系统：实时获取多国行情数据支持策略开发。
- 移动端App：集成股票价格提醒功能。
- 财务报表分析：批量下载历史数据用于回测。
五、注意事项
- 韩国市场数据延迟约15分钟（免费版）。
- 印度股票代码使用NSE的缩写格式（如
IN:INFY）。 - 需遵守平台的数据使用协议，禁止商业化转售。
官方文档：https://pao.stocktv.top/
技术支持：paopao
以上为基于公开信息的通用API设计示例，实际接口参数请以平台文档为准。
