美股实时行情与 K 线数据对接

美国股票市场（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 接口快速获取美股全市场的“涨幅榜”或“跌幅榜”，实时挖掘热点个股。

四、 开发小贴士

1. 时区差处理：美股交易时间与北京时间有较大时差，建议在处理 time（时间戳）时，根据业务需求转换为美东时间或用户本地时间。
2. 数据缓存：对于 stock/companies 接口提供的公司描述、行业分类等静态信息，建议在本地数据库做缓存，以优化 App 加载速度。
3. WebSocket 推送：对于交易类应用，建议使用 StockTV 提供的 WS 接入方式，实现秒级价格跳动，提升用户体验。

结语

对接美股数据并不复杂，关键在于选择一个稳定且数据维度丰富的供应商。StockTV API 以其标准化的 JSON 结构和覆盖全球的金融数据，极大地降低了金融应用的开发门槛。