美股（纳斯达克/纽交所）数据 API 对接实战（含实时行情与 IPO 功能）

作为全球规模最大、流动性最强的市场，美股（尤其是纳斯达克）一直是量化交易和金融应用开发者的首选。本文将带你通过 **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`，你可以获取美股市场的股票基础信息及最新成交价。

* **请求示例**：

```http

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 的美股数据？

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

如果您正在开发金融项目，欢迎联系获取测试授权：