美国股票市场（NYSE & NASDAQ）作为全球金融的风向标，聚集了苹果、英伟达、特斯拉等顶尖企业。对于金融科技开发者而言，如何稳定、低延迟地获取美股数据是开发全球资产配置工具的第一步。
本文将基于 StockTV 全球金融 API，为你详解如何快速集成美股实时行情、历史数据及指数信息。
一、 美股接口
对接美股数据通常面临着交易所授权费高昂、API 协议复杂（如 FIX 协议）等痛点。StockTV 提供了简化后的 REST 和 WebSocket 接口：
- 全市场覆盖：支持纽约证券交易所（NYSE, ID: 1）和纳斯达克（NASDAQ, ID: 2）。
- 极简调用：通过简单的
countryId或exchangeId参数即可筛选美股数据。 - 多维信息：除了价格，还提供基本面 Beta 值、市值、收入以及技术分析指标。
二、 核心接口对接指南
在开始前，请确保已获取你的 API Key
1. 获取美股市场列表
若要获取美国市场的股票信息，你需要将 countryId 设置为美股对应的代码（如获取美国列表，通常涉及交易所 ID 1 或 2）。
- 请求示例：
GET https://api.stocktv.top/stock/stocks?pageSize=10&page=1&key=YOUR_KEY - 关键筛选：在返回结果中，可以通过
exchangeId区分市场： exchangeId: 1— 纽约证券交易所 (NYSE)exchangeId: 2— 纳斯达克 (NASDAQ)
2. 精确查询个股行情
如果你已经知道股票代码（如 NVDA, AAPL），可以直接查询其最新详情。
- 接口地址：
https://api.stocktv.top/stock/queryStocks?symbol=AAPL&key=YOUR_KEY - 核心字段说明：
last: 最新成交价chgPct: 涨跌幅（直接拼接 % 即可展示）fundamentalMarketCap: 基本面市值technicalDay: 日线技术指标建议（如 "strong_buy"）
3. 调用 K 线数据（绘制图表）
K 线接口支持多种时间维度，满足从分时图到月线图的各类展示需求。
- 接口地址：
https://api.stocktv.top/stock/kline?pid=股票PID&interval=PT15M&key=YOUR_KEY - 参数配置：
interval: 支持PT1M(1分钟)、PT1H(1小时)、P1D(1天) 等。data: 返回包含open,high,low,close,volume的 JSON 数组。
4. 追踪美股三大指数
获取道琼斯、标普 500 或纳斯达克 100 指数，是判断市场大势的关键。
- 接口地址：
https://api.stocktv.top/stock/indices?countryId=US_ID&key=YOUR_KEY - 返回内容：包含指数的最新价格、最高/最低价及开盘状态
isOpen。
三、 进阶功能：IPO 日历与涨跌榜
- IPO 预告：通过
stock/getIpo接口，可以获取即将上市的美股新股名称、发行价及上市日期，助力用户捕捉打新机会。 - 涨跌幅排行榜：使用
stock/updownList接口快速获取美股全市场的“涨幅榜”或“跌幅榜”，实时挖掘热点个股。
四、 开发小贴士
- 时区差处理：美股交易时间与北京时间有较大时差，建议在处理
time（时间戳）时，根据业务需求转换为美东时间或用户本地时间。 - 数据缓存：对于
stock/companies接口提供的公司描述、行业分类等静态信息，建议在本地数据库做缓存，以优化 App 加载速度。 - WebSocket 推送：对于交易类应用，建议使用 StockTV 提供的 WS 接入方式，实现秒级价格跳动，提升用户体验。
结语
对接美股数据并不复杂，关键在于选择一个稳定且数据维度丰富的供应商。StockTV API 以其标准化的 JSON 结构和覆盖全球的金融数据，极大地降低了金融应用的开发门槛。
