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)：

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 参数调整，即可让您的应用具备横跨亚、美、拉美三大洲的实时金融追踪能力。立即动手，开启您的全球行情开发之旅！