纳斯达克前100支股票数据获取接口

🎯 StockTV API 概览

StockTV API 是一个功能全面的金融市场数据接口，特别适合需要处理美国市场数据的开发者。

• 数据覆盖面广：该API覆盖了包括纳斯达克（NASDAQ）、纽约证券交易所（NYSE）在内的美国主要交易所的股票数据。这意味着你可以获取到在纳斯达克上市的大量公司股票信息。
• 数据类型丰富：除了最基础的实时报价，API还提供历史K线数据（支持从分钟线到月线等多种时间粒度）、公司基本面信息（如市盈率、市值）、以及美国主要市场指数（如纳斯达克综合指数）等。
• 灵活的访问方式：支持 RESTful API 用于按需请求数据，同时也提供 WebSocket 连接用于接收实时的行情推送，满足不同场景下的需求。

📋 接入准备

在开始编写代码之前，你需要完成两项简单的准备：

1. 获取API密钥：API密钥是访问所有数据接口的凭证。你需要通过 StockTV 官方平台（如官网 stocktv.top）申请获取。
2. 了解基础信息：
   • API 基础地址：REST API 的请求基础 URL 通常是 https://api.stocktv.top。
   • 请求头设置：在发起HTTP请求时，一般需要在请求头中包含 Content-Type: application/json，并通过 X-Api-Key: YOUR_API_KEY 或直接在参数中添加 key=YOUR_API_KEY 的方式进行认证。

🔧 核心接口详解与代码实现

以下是获取纳斯达克股票数据最常用的几个接口及其用法。

1. 获取股票列表

要获取纳斯达克市场的股票列表，你可以使用市场列表接口。这个接口可以帮助你筛选出特定交易所的股票。

• 接口地址: GET /stock/stocks

• 请求参数:

  参数	必选	说明	示例值
  countryId	是	国家ID，美国为 1	1
  exchangeId	否	交易所ID，纳斯达克可尝试传入 2	2
  pageSize	否	每页返回的股票数量，例如设为100	100
  page	否	页码	1
  key	是	你的API密钥	your_api_key_here

• Python示例代码：

  import requests
  
  def get_nasdaq_stocks(api_key, page_size=100):
      url = "https://api.stocktv.top/stock/stocks"
      params = {
          "countryId": 1,  # 美国
          "exchangeId": 2, # 纳斯达克（请根据API文档确认此参数）
          "pageSize": page_size,
          "page": 1,
          "key": api_key
      }
      try:
          response = requests.get(url, params=params)
          response.raise_for_status()  # 检查请求是否成功
          data = response.json()
          if data.get("code") == 200:
              # 成功获取数据，返回股票列表
              return data["data"]["records"]
          else:
              print(f"API返回错误: {data.get('message')}")
              return None
      except requests.exceptions.RequestException as e:
          print(f"请求出错: {e}")
          return None
  
  # 使用示例
  api_key = "YOUR_API_KEY"  # 替换为你的真实API密钥
  stocks = get_nasdaq_stocks(api_key)
  if stocks:
      for stock in stocks[:5]:  # 打印前5只股票信息
          print(f"股票代码: {stock['symbol']}, 名称: {stock['name']}, 最新价: {stock['last']}")
  

  获取列表后，你可以根据市值等字段进行排序和筛选，以聚焦于纳斯达克前100的股票。

2. 查询特定股票实时行情

获取单只股票的详细实时信息，可以使用行情接口。

• 接口地址: GET /us/quote 或 GET /stock/queryStocks

• 请求参数（以 /us/quote 为例）:

  参数	必选	说明	示例值
  symbol	是	股票代码	AAPL
  key	是	你的API密钥	your_api_key_here

• Python示例代码：

  def get_stock_quote(symbol, api_key):
      url = "https://api.stocktv.top/us/quote"
      params = {
          "symbol": symbol,
          "key": api_key
      }
      headers = {
          "Content-Type": "application/json"
      }
      try:
          response = requests.get(url, params=params, headers=headers)
          response.raise_for_status()
          data = response.json()
          if data.get("code") == 200:
              return data["data"]
          else:
              print(f"获取 {symbol} 行情失败: {data.get('message')}")
              return None
      except requests.exceptions.RequestException as e:
          print(f"请求出错: {e}")
          return None
  
  # 使用示例
  aapl_quote = get_stock_quote("AAPL", api_key)
  if aapl_quote:
      # 实际返回字段名称请参考API文档
      print(f"苹果(AAPL) 最新价: ${aapl_quote.get('price', 'N/A')}")
      print(f"涨跌幅: {aapl_quote.get('changePercent', 'N/A')}%")
      print(f"成交量: {aapl_quote.get('volume', 'N/A')}")
  

3. 获取历史K线数据

用于技术分析的历史K线数据可以通过历史数据接口获取。

• 接口地址: GET /stock/kline

• 请求参数:

  参数	必选	说明	示例值
  pid	是	股票的唯一ID，需从股票列表接口获取	7203 (例如AAPL的ID)
  interval	是	K线时间间隔	PT1H (1小时), P1D (日线)
  key	是	你的API密钥	your_api_key_here

• Python示例代码：

  def get_historical_kline(pid, interval, api_key):
      url = "https://api.stocktv.top/stock/kline"
      params = {
          "pid": pid,
          "interval": interval,
          "key": api_key
      }
      try:
          response = requests.get(url, params=params)
          response.raise_for_status()
          data = response.json()
          if data.get("code") == 200:
              return data["data"]  # 返回K线数据列表
          else:
              print(f"获取K线失败: {data.get('message')}")
              return None
      except requests.exceptions.RequestException as e:
          print(f"请求出错: {e}")
          return None
  
  # 使用示例：首先需要获取股票的PID
  # 假设已经知道AAPL的PID是7203
  aapl_kline = get_historical_kline(7203, "P1D", api_key)  # 获取日K线
  if aapl_kline:
      for kline in aapl_kline[:3]:  # 打印最近3根K线
          print(f"时间: {kline['time']}, 开盘: {kline['open']}, 最高: {kline['high']}, 最低: {kline['low']}, 收盘: {kline['close']}")
  

4. 通过WebSocket订阅实时数据

对于需要低延迟和高频更新的场景（如实时监控看板），WebSocket是比反复HTTP轮询更高效的选择。

• 连接地址: wss://ws-api.stocktv.top/us?key=YOUR_API_KEY

• 基本步骤:

  1. 建立WebSocket连接。
  2. 发送订阅消息，指定关注的股票列表（通常使用股票ID pids 或代码 symbols）。
  3. 监听服务器推送的实时消息。
  4. 定期发送心跳包（例如每30秒一次）以保持连接活跃。

• JavaScript示例代码（适用于Node.js环境）：

  const WebSocket = require('ws');
  const API_KEY = 'YOUR_API_KEY';
  
  const ws = new WebSocket(`wss://ws-api.stocktv.top/us?key=${API_KEY}`);
  
  ws.on('open', function open() {
      console.log('WebSocket连接已建立');
      // 订阅股票，例如AAPL和MSFT
      const subscribeMsg = {
          action: "subscribe",
          symbols: ["AAPL", "MSFT"]  // 或使用 "pids": [7203, 7204]
      };
      ws.send(JSON.stringify(subscribeMsg));
  });
  
  ws.on('message', function incoming(data) {
      const message = JSON.parse(data);
      // 处理实时行情推送
      if (message.symbol) {
          console.log(`实时报价: ${message.symbol} - 价格: ${message.last} | 涨跌: ${message.change} (${message.changePercent}%)`);
      }
  });
  
  ws.on('error', function error(err) {
      console.error('WebSocket错误: ', err);
  });
  
  ws.on('close', function close() {
      console.log('WebSocket连接关闭');
  });
  
  // 每30秒发送心跳保活
  setInterval(() => {
      if (ws.readyState === WebSocket.OPEN) {
          ws.send(JSON.stringify({ action: "ping" }));
      }
  }, 30000);
  

⚠️ 注意事项与最佳实践

为了确保稳定高效地使用API，请关注以下几点：

• 频率限制：几乎所有API服务都会对请求频率有所限制。基础版本通常有每分钟或每日的调用次数上限。请务必查阅 StockTV 的官方文档了解具体的限流策略，并在代码中合理设计请求间隔，避免触发限制导致服务暂时不可用。
• 错误处理：网络请求难免会出现异常。在代码中务必添加完善的错误处理机制（如使用 try...catch），妥善处理网络超时、API返回错误码、数据解析失败等情况，增强程序的健壮性。
• 缓存策略：对于一些变化不频繁的数据，例如公司的基本信息、历史K线数据，可以考虑在本地进行缓存。这不仅能减少不必要的API调用，节省请求额度，还能提升应用的响应速度。
• 安全管理API密钥：API密钥是访问服务的凭证，务必妥善保管。切勿将其直接硬编码在客户端代码或公开的版本控制系统（如GitHub）中。建议使用环境变量或安全的配置文件来管理密钥。

💡 替代方案简介

虽然本文重点介绍了 StockTV API，但了解其他选择也有助于你做出最佳决策。市场上还有其他一些提供美股行情的数据接口，它们各有特点：

• Alpha Vantage：提供全球多个市场的股票、外汇等数据，有免费层级，但免费数据通常有15分钟延迟。
• IEX Cloud：提供美国市场数据，免费层有一定使用量，但其实时数据主要覆盖IEX交易所。
• Polygon.io：提供美股实时和高频数据，有免费试用，但限制较多。
• 雅虎财经（Yahoo Finance）：可通过非官方库（如 yfinance）获取大量免费数据，但稳定性和合规性需要自行评估。

选择时，需要综合权衡数据的实时性、准确性、覆盖范围、成本以及技术支持等因素。

希望这份详细的指南能帮助你顺利对接纳斯达克股票数据！如果你在具体实现中遇到更具体的问题，例如需要处理特定的错误码或进行更复杂的数据分析，可以随时提出。