作为全球规模最大、流动性最强的市场，美股（尤其是纳斯达克）一直是量化交易和金融应用开发者的首选。本文将带你通过 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，你可以获取美股市场的股票基础信息及最新成交价。
- 请求示例：
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)
import requestsdef get_nasdaq_market():api_url = "https://api.stocktv.top/stock/stocks"params = {"countryId": 5,"pageSize": 10,"key": "YOUR_API_KEY"}response = requests.get(api_url, params=params)if response.status_code == 200:stocks = response.json()['data']['records']for stock in stocks:print(f"代码: {stock['symbol']}, 最新价: {stock['last']}, 涨幅: {stock['chgPct']}%")get_nasdaq_market()五、 获取技术支持与测试 Key
如果您正在开发金融项目，欢迎联系获取测试授权：