StockTV 提供了一套覆盖全球多市场的金融数据接口，其核心优势在于能够通过统一的 API 密钥，便捷地接入股票、外汇、期货及加密货币的实时与历史数据。
下表为您梳理了其核心接口功能，方便您快速概览。
📊 核心接口功能一览
| 资产类别 | 核心功能 | 主要接口示例 | 协议支持 |
|---|---|---|---|
| 全球股票 | 实时行情、历史K线、市场列表、指数、公司信息、IPO新股 | /stock/stocks, /stock/queryStocks, /stock/kline |
HTTP, WebSocket |
| 外汇 | 实时汇率、汇率列表、K线图表 | /market/currency, /market/todayMarket |
HTTP |
| 期货 | 市场列表、当前行情、K线数据 | /futures/list, /futures/querySymbol |
HTTP |
| 加密货币 | 交易对信息、最新行情、K线数据、近期成交 | /crypto/tickerPrice, /crypto/getKlines |
HTTP |
🌍 主要覆盖的国家与市场
StockTV 支持包括美国、印度、日本、马来西亚、中国、韩国、新加坡、巴西等多个国家和地区的股票市场数据。对接时，常需要通过 countryId 参数指定市场，例如：
- 美国：
countryId=5或countryId=1 - 印度：
countryId=14 - 日本：
countryId=2 - 马来西亚：
countryId=42
⚡ 实时数据推送 (WebSocket)
对于需要毫秒级延迟的实时数据看板或交易应用，WebSocket 是比 HTTP 轮询更高效的选择。
基础连接与订阅示例 (Node.js)
const WebSocket = require('ws');
const ws = new WebSocket('wss://ws-api.stocktv.top/connect?key=YOUR_API_KEY'); // 连接地址
ws.on('open', function open() {
console.log('WebSocket 连接成功');
// 发送订阅消息，支持多国股票代码
const subscribeMsg = {
action: "subscribe",
symbols: ["AAPL", "RELIANCE.NS", "7203.T"] // 示例：美股、印度股、日股
};
ws.send(JSON.stringify(subscribeMsg));
});
ws.on('message', function incoming(data) {
const quote = JSON.parse(data);
console.log(`实时报价: ${
quote.symbol} - 价格: ${
quote.last_numeric}`); // 处理实时数据
});
// 心跳机制，保持连接活跃
setInterval(() => {
if (ws.readyState === WebSocket.OPEN) {
ws.send(JSON.stringify({
"action": "ping" }));
}
}, 30000);
💻 基础代码示例 (Python)
以下是一个使用 Python 获取股票行情的简单示例。
import requests
# 配置您的 API Key
API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.stocktv.top"
def get_stock_quote(symbol):
"""
获取单只股票实时行情
对于美股等市场，也可能使用专门的端点，如 /us/quote
"""
url = f"{BASE_URL}/stock/queryStocks"
params = {
"symbol": symbol,
"key": API_KEY
}
try:
response = requests.get(url, params=params, timeout=10)
response.raise_for_status() # 检查请求是否成功
data = response.json()
if data.get("code") == 200:
return data["data"]
else:
print(f"API 返回错误: {data.get('message')}")
return None
except requests.exceptions.RequestException as e:
print(f"请求出错: {e}")
return None
# 调用示例：查询苹果公司股票
quote_data = get_stock_quote("AAPL")
if quote_data:
# 注意：实际字段名请参考接口文档，例如可能是 'last', 'price' 等
print(f"苹果公司最新价: {quote_data[0]['last']}")
⚠️ 开发注意事项
在集成使用过程中，有几个关键点需要留意：
- API Key：所有接口调用都必须在请求参数中包含有效的
key。 - 频率限制：请注意接口的调用频率限制，例如免费版可能限制为每分钟100次请求，超出限制会收到429错误。
- 错误处理：在代码中务必添加完善的错误处理机制，例如网络异常、超时等情况。
- 数据延迟：实时行情通常有微小的延迟（约200毫秒），历史数据则没有延迟。
- 密钥安全：切勿在前端代码中硬编码 API Key，建议通过后端服务调用或将密钥设置在环境变量中。
📚 总结与资源
希望这份大全能帮助您快速上手 StockTV API。其核心价值在于一站式接入全球主要金融市场的数据，为开发量化策略、财经App或内部监控系统提供了很大便利。
- 获取API Key：您需要联系 StockTV 官方或其客服团队申请 API 密钥。
- 详细文档：更详细的参数说明和响应字段，请参考 StockTV 官方接口文档。
- SDK支持：社区及官方可能提供了 Python、JavaScript、Java 等语言的 SDK，可以简化开发流程。
如果您对某个特定市场（如印度或美国）的接口有更深入的使用问题，我很乐意提供进一步的探讨。
