美股（纳斯达克/纽交所）数据 API 对接实战（含实时行情与 IPO 功能）

作为全球规模最大、流动性最强的市场，美股（尤其是纳斯达克）一直是量化交易和金融应用开发者的首选。本文将带你通过 StockTV API 高效对接美股数据，利用 countryId=5 快速实现专业级的行情展示与新股追踪。
一、 核心对接配置

在开始调用之前，请配置以下基础信息：

• API 基础路径：https://api.stocktv.top
  
• 国家 ID (countryId)：5（美股专有 ID）
  
• 认证方式：在 API 请求参数中添加 key
  
• 支持协议：HTTP 接口与 WebSocket (WS) 推送。
  

二、 核心功能实现

1. 实时行情：秒级同步华尔街波动

StockTV 提供了覆盖纳斯达克（NASDAQ）和纽交所（NYSE）的极速行情。
A. 获取美股实时市场列表

通过设置 countryId=5，你可以获取美股市场的股票基础信息及最新成交价。

• 请求示例：
  

1. GET https://api.stocktv.top/stock/stocks?countryId=5&pageSize=20&page=1&key=YOUR_KEY

复制代码

• 关键数据点：
  
• last: 最新价格。
  
• chgPct: 涨跌幅（直接拼接 % 即可展示）。
  
• high/low: 当日最高及最低价。
  
• volume: 实时成交量。
  

B. 指数监控（纳指、标普、道指）

监控美股大盘走势，可调用指数接口：

• 接口地址：/stock/indices?countryId=5
  
• 特点：提供 isOpen 字段，实时反馈美股是否处于盘中交易状态。
  

2. IPO 新股日历：掌握科技巨头的诞生

美股 IPO 极其频繁，利用该接口可以轻松追踪即将上市的科技初创公司。

• 接口地址：/stock/getIpo
  
• 请求参数：countryId=5，type=1（未上市/待上市）或 type=2（已上市）。
  
• 返回核心字段：
  
• ipoListing: 预计上市时间戳。
  
• ipoPrice: 预计发行价格区间。
  
• company: 公司全称及交易代码（如 AAPL、TSLA）。
  

3. K 线数据：专业级技术分析

为您的应用提供分时、日线及周线图表支持。

• 接口地址：/stock/kline
  
• 参数说明：传入股票的 pid 和周期 interval（支持 PT1M, PT15M, PT1H, P1D 等）。
  
• 数据结构：返回标准的 OHLC 格式，包含时间戳、开盘价、最高价、最低价、收盘价及成交量。
  

4. 公司深度信息：基本面调研

除了价格，StockTV 还提供详尽的公司背景。

• 接口地址：/stock/companies?countryId=5
  
• 内容涵盖：所属行业 (industry)、板块 (sector)、员工人数及详细的公司业务描述。
  

三、 为什么选择 StockTV 的美股数据？

• 极简接入：仅需传入 countryId=5 即可在原有的多国数据逻辑下无缝切换至美股。
  
• 数据维度广：涵盖实时行情、指数、IPO 日历、K线、涨跌榜及公司基本面。
  
• 高性能支持：提供 WS 接入方式，适合对行情刷新频率有极高要求的交易类应用。
  
• 免费技术支持：提供全程辅助对接服务。
  

四、 快速集成代码 (Python)

1. import requests
3. def get_nasdaq_market():
4.     api_url = "https://api.stocktv.top/stock/stocks"
5.     params = {
6.         "countryId": 5,
7.         "pageSize": 10,
8.         "key": "YOUR_API_KEY"
9.     }
10.     response = requests.get(api_url, params=params)
11.     if response.status_code == 200:
12.         stocks = response.json()['data']['records']
13.         for stock in stocks:
14.             print(f"代码: {stock['symbol']}, 最新价: {stock['last']}, 涨幅: {stock['chgPct']}%")
16. get_nasdaq_market()

复制代码

五、 获取技术支持与测试 Key

如果您正在开发金融项目，欢迎联系获取测试授权：

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！