这是一篇关于如何通过 StockTV API 对接美股（NYSE & NASDAQ）实作为全球市值最高、流动性最强的金融市场，美股（美国股票）一直是量化交易和金融信息服务的核心。无论是构建一个跨平台股票 App，还是开发自动交易策略，稳定、低延迟的美股数据流都是成败的关键。
本文将手把手教你如何通过 StockTV 全球金融 API 对接美股数据，涵盖实时行情、专业 K 线以及新股 IPO 数据。
一、 核心优势
在对接美股时，开发者常面临交易所授权费贵、接口复杂等问题。StockTV 提供了极简的集成方案：
- 全交易所覆盖：支持纽约证券交易所（NYSE，ID: 1）和纳斯达克（NASDAQ，ID: 2）。
- 多维度指标：不仅有价格，还包含实时市值、技术面分析建议（Strong Buy/Sell）。
- 极速连接：提供 WebSocket 实时推送，告别传统 HTTP 轮询的延迟。
二、 对接准备
- 获取 API Key：联系官方 获取授权 Key。
- 接口文档：所有请求均为 RESTful 风格，返回标准 JSON 格式。
三、 核心接口调用实操
1. 获取美股列表（市场筛选）
通过指定交易所 ID，你可以快速获取纳斯达克或纽交所的所有股票及其唯一标识 pid。
- 请求地址：
GET https://api.stocktv.top/stock/stocks?exchangeId=2&pageSize=10&page=1&key=YOUR_KEY - 说明：将
exchangeId设置为1即为纽交所，2为纳斯达克。
2. 获取个股详情与实时报价
如果你已知股票代码（如苹果 AAPL 或英伟达 NVDA），可以直接查询详情。
- 请求示例：
https://api.stocktv.top/stock/queryStocks?symbol=NVDA&key=YOUR_KEY - 关键返回字段：
last: 最新成交价。chgPct: 今日涨跌幅（含正负号）。technicalDay: 系统内置的日线技术评分。
3. 调用专业 K 线数据
StockTV 支持从 1 分钟到月线的完整 K 线序列，非常适合对接 TradingView 图表。
- 接口：
https://api.stocktv.top/stock/kline?pid=股票ID&interval=PT1M&key=YOUR_KEY - 优势：毫秒级响应，数据结构包含
open,high,low,close,volume。
四、 进阶功能：IPO 数据与实时推送
1. 实时 IPO 日历
美股打新是很多投资者的刚需。通过 stock/getIpo 接口，你可以获取即将上市的新股代码、预计发行价区间及上市日期。
- 接口：
https://api.stocktv.top/stock/getIpo?key=YOUR_KEY
2. WebSocket 实时行情推送
对于高频看盘应用，传统的请求方式太慢。StockTV 的 WebSocket 允许服务器在价格变动的第一时间“推”给客户端。
- 优势：极低带宽消耗，极速报价更新。
- 流程：连接
ws://api.stocktv.top/ws-> 订阅个股pid-> 接收实时成交包。
五、 开发小贴士
- 时区处理：美股交易时间为美东时间（EST/EDT）。API 返回的时间戳通常为 UTC 格式，展示时请根据本地时区转换。
- 指数追踪：除了个股，别忘了通过
stock/indices接口获取标普 500、纳斯达克 100 等大盘指数，作为市场走势的参考。 - 数据缓存：对于公司简介、行业分类等变动较慢的数据，建议本地缓存 24 小时，以提高 App 加载速度。
结语
借助 StockTV API，对接美股数据不再是复杂的系统工程。只需几行代码，你的应用就能拥有同步华尔街的视野。现在就开始集成，为你的用户提供最专业的美股投资体验吧！
