获取股票API接口地址

StockTV 提供了一套覆盖全球多市场的金融数据接口，其核心优势在于能够通过统一的 API 密钥，便捷地接入股票、外汇、期货及加密货币的实时与历史数据。

下表为您梳理了其核心接口功能，方便您快速概览。

📊 核心接口功能一览

🌍 主要覆盖的国家与市场

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，可以简化开发流程。

如果您对某个特定市场（如印度或美国）的接口有更深入的使用问题，我很乐意提供进一步的探讨。