StockTV API 对接全攻略（股票、期货、IPO）

在构建全球化资产配置工具或交易系统时，数据的实时性、准确性以及覆盖面是核心竞争力。本文将介绍如何通过 **StockTV API** 快速接入全球多个主流市场的股票及期货数据，重点讲解如何利用 `countryId` 实现多国切换，并集成特色的 IPO 追踪功能。

## 一、 核心架构与接入准备

StockTV 采用标准的 RESTful 架构，并提供 WebSocket 协议支持高频行情推送。

* **API 基础路径**：`https://api.stocktv.top`

* **认证方式**：所有请求需在 URL 参数中携带 `key=YOUR_KEY`。

* **数据格式**：统一的 JSON 格式，方便前端与后端快速解析。

## 二、 关键参数：通过 `countryId` 路由全球市场

StockTV 的最大特点是“一套代码，全球接入”。通过修改 `countryId` 参数，您可以无缝切换不同国家的市场数据：

| 国家/市场 | countryId | 市场重点 |

| --- | --- | --- |

| **美国 (USA)** | `5` | 纳斯达克、纽交所，全球科技股风向标 |

| **印度 (India)** | `14` | NSE/BSE，近年来增长最快的新兴市场 |

| **日本 (Japan)** | `35` | 东证交易所，日经 225 与五大商社 |

| **墨西哥 (Mexico)** | `7` | 拉美核心市场，IPC 指数追踪 |

## 三、 核心功能模块实现

### 1. 实时行情：股票列表与指数

获取特定国家的所有股票最新成交价、涨跌幅及成交量。

* **接口**：`/stock/stocks`

* **代码示例 (Python)**：

```python

import requests

# 以印度市场 (countryId=14) 为例

url = "https://api.stocktv.top/stock/stocks?countryId=14&key=YOUR_KEY"

data = requests.get(url).json()

# 核心字段：last (最新价), chgPct (涨跌幅), volume (成交量)

```

### 2. 独家功能：IPO 新股日历

对于打新投资者或基本面分析工具，IPO 数据是极具价值的。StockTV 提供了完整的 IPO 日历。

* **接口**：`/stock/getIpo`

* **功能说明**：

* `type=1`：未上市新股（预警/申购期）。

* `type=2`：已上市新股（上市首日表现）。

* **字段亮点**：`ipoListing` (上市日期)、`ipoPrice` (发行价)、`company` (公司背景)。

### 3. K 线数据：专业图表支持

支持分时、日线、周线等多种周期（`PT1M`, `PT1H`, `P1D` 等），满足 TradingView 等图表的渲染需求。

* **接口**：`/stock/kline` 或 `/futures/kline`

* **输出**：标准 OHLC（开盘、最高、最低、收盘）及成交量。

## 四、 黄金、白银及全球期货对接

除了股票，避险资产（贵金属）和能源期货也是金融平台的标配。

* **重点品种**：伦敦金 (XAU)、伦敦银 (XAG)、原油 (WTI/Brent)。

* **实时接口**：`/futures/market`

* **优势**：提供买一/卖一价 (Bid/Ask)，适合展示高精度的差价合约行情。

## 五、 技术优势与开发者支持

1. **极简接入**：无需针对每个国家编写复杂的解析逻辑，字段高度统一。

2. **低延迟推送**：支持 WebSocket (WS) 接入，实现毫秒级的盘面跳动。

3. **深度调研**：提供 `/stock/companies` 接口，涵盖公司所属行业、板块及详细业务描述，助力基本面分析。

## 六、 获取测试授权

如果您正在开发量化系统、行情 App 或金融资讯站，可以联系技术团队获取免费测试 Key

**结语**：全球资产配置的时代，高效的数据源就是开发者的“倍增器”。通过对接 StockTV API，仅需简单的 `countryId` 参数调整，即可让您的应用具备横跨亚、美、拉美三大洲的实时金融追踪能力。立即动手，开启您的全球行情开发之旅！