墨西哥股票数据 API 对接实战指南（含实时行情与 IPO 功能）

墨西哥作为拉美地区最具活力的经济体之一，其证券市场（BMV - 墨西哥证券交易所）在资产配置中占有重要地位。对于开发者而言，获取稳定、实时的墨西哥股市数据是构建金融应用的关键。

本文将带你通过 **StockTV API** 快速对接墨西哥股票（**countryId=7**）数据，重点介绍**实时行情**获取与 **IPO 新股日历**功能。

## 一、 对接核心参数

在调用接口前，请确保配置以下基础信息：

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

* **国家 ID (countryId)**：`7`（墨西哥专有 ID）

* **认证方式**：在请求参数中携带 `key`

* **支持协议**：HTTP 接口与 WebSocket (WS) 实时推送

## 二、 核心功能实现

### 1. 实时行情：秒级同步墨西哥市场

通过 StockTV API，你可以轻松获取墨西哥主要交易所（如 BMV 和 BIVA）的实时变动数据。

#### A. 获取墨西哥股票市场列表

通过设置 `countryId=7`，获取墨西哥市场的股票清单及其最新成交价。

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

* **请求示例**：

```http

GET https://api.stocktv.top/stock/stocks?countryId=7&pageSize=20&page=1&key=YOUR_KEY

```

* **实时数据字段**：

* `last`: 最新价格。

* `chgPct`: 涨跌幅（直接拼接 % 展示）。

* `high`/`low`: 当日最高与最低价。

* `volume`: 实时成交量。

#### B. 指数监控

实时追踪墨西哥 IPC 指数等大盘走势。

* **接口地址**：`/stock/indices?countryId=7`

* **核心功能**：返回指数最新价、涨跌幅，并通过 `isOpen` 字段反馈当前市场交易状态。

### 2. IPO 新股日历：把握上市先机

墨西哥 IPO 市场具有独特的投资机会。通过 IPO 接口，你可以追踪即将上市的新股及历史 IPO 记录。

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

* **参数配置**：`countryId=7`，`type=1`（未上市）或 `type=2`（已上市）。

* **关键返回信息**：

* `ipoListing`: 预计上市时间戳。

* `ipoPrice`: 发行价。

* `company`: 公司全称及其所属交易所。

### 3. K 线数据：专业级技术分析支持

支持多种周期的 K 线数据（1分钟、15分钟、1小时、日线等），满足量化与制图需求。

* **接口地址**：`/stock/kline`

* **周期参数**：`PT1M` (1分), `PT15M` (15分), `PT1H` (1时), `P1D` (1天) 等。

* **数据结构**：返回包含开盘、最高、最低、收盘、成交量及时间戳的标准 OHLC 格式。

## 三、 为什么选择 StockTV 的墨西哥股票数据？

1. **极简集成**：只需传入 `countryId=7`，即可在统一的 API 框架下获取全球多国数据。

2. **数据实时性**：提供低延迟的实时价格变动，支持 WebSocket 协议用于高频刷新场景。

3. **公司深度资料**：除了价格，还提供包含行业分类 (`industry`)、板块 (`sector`)、员工人数及详细描述的公司背景信息。

4. **免费技术支持**：提供全程辅助对接服务，助力应用快速上线。

---

**结语**：墨西哥股市的数字化投资潜力巨大。通过对接 `countryId=7`，你可以为用户提供从实时行情、指数走势到 IPO 追踪的全方位金融数据体验。立即开始集成，抢占拉美市场先机！