作为全球规模最大、流动性最强的市场，美股（尤其是纳斯达克）一直是量化交易和金融应用开发者的首选。本文将带你通过 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，你可以获取美股市场的股票基础信息及最新成交价。
* **关键数据点**：
* `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 的美股数据？
1. **极简接入**：仅需传入 `countryId=5` 即可在原有的多国数据逻辑下无缝切换至美股。
2. **数据维度广**：涵盖实时行情、指数、IPO 日历、K线、涨跌榜及公司基本面。
3. **高性能支持**：提供 WS 接入方式，适合对行情刷新频率有极高要求的交易类应用。
4. **免费技术支持**：提供全程辅助对接服务。
## 四、 快速集成代码 (Python)
```python
import requests
def 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
如果您正在开发金融项目，欢迎联系获取测试授权：
