墨西哥证券交易所(BMV)等多个交易所股票数据API对接文档

本文档详细说明如何对接StockTV全球股票API中的墨西哥股票数据。墨西哥股票市场是拉丁美洲重要的金融市场之一，包含墨西哥证券交易所(BMV)等多个交易所。

认证方式

所有API请求都需要在URL参数中包含API Key：

key=您的API密钥

基础信息

• 墨西哥国家ID: countryId=7
• 主要交易所ID:
  • 墨西哥证券交易所(Bolsa Mexicana de Valores): exchangeId=53
  • 墨西哥 institutional exchange: exchangeId=144

API端点

1. 墨西哥股票市场列表

获取墨西哥股票市场列表，支持分页查询。

请求示例:

GET https://api.stocktv.top/stock/stocks?countryId=7&pageSize=50&page=1&key=您的API密钥

参数说明:

• countryId: 必须为7(墨西哥)
• pageSize: 每页返回数量(默认10，最大100)
• page: 页码(默认1)
• exchangeId: 可选，交易所ID

响应示例:

{"code": 200,"message": "操作成功","data": {"records": [{"id": 12345,"name": "América Móvil","symbol": "AMXL","last": 16.78,"chg": 0.25,"chgPct": 1.51,"high": 16.85,"low": 16.50,"volume": 2856400,"avgVolume": 3201500,"exchangeId": 53,"countryId": 7,"flag": "MX","open": true,"lastClose": 16.53,"time": 1716458537,"url": "/equities/america-movil","fundamentalMarketCap": 525000000000,"fundamentalRevenue": "850.75B","performanceDay": 1.51,"performanceWeek": 2.34,"performanceMonth": 5.67,"performanceYear": 15.23,"technicalDay": "buy","technicalWeek": "strong_buy"}],"total": 150,"size": 50,"current": 1,"pages": 3}
}

2. 查询特定墨西哥股票

通过股票ID、名称或代码查询墨西哥股票信息。

请求示例:

GET https://api.stocktv.top/stock/queryStocks?countryId=7&symbol=AMXL&key=您的API密钥

参数说明:

• id: 股票PID(可选)
• name: 股票名称(可选)
• symbol: 股票代码(可选)
• url: 股票详情页URL(可选)

3. 墨西哥指数数据

获取墨西哥主要股票指数信息。

请求示例:

GET https://api.stocktv.top/stock/indices?countryId=7&key=您的API密钥

响应包含:

• IPC指数(Índice de Precios y Cotizaciones)
• S&P/BMV IPC指数
• MEXBOL指数等

4. 墨西哥股票K线数据

获取墨西哥股票的K线图表数据。

请求示例:

GET https://api.stocktv.top/stock/kline?pid=12345&interval=PT1H&key=您的API密钥

时间间隔参数:

• PT5M: 5分钟
• PT15M: 15分钟
• PT1H: 1小时
• PT5H: 5小时
• P1D: 1天
• P1W: 1周
• P1M: 1月

5. 墨西哥股票涨跌排行榜

获取墨西哥股票的涨跌幅排行榜。

请求示例:

GET https://api.stocktv.top/stock/updownList?countryId=7&type=1&key=您的API密钥

类型参数:

• 1: 涨幅榜
• 2: 跌幅榜
• 3: 涨停榜
• 4: 跌停榜

6. 墨西哥上市公司信息

获取墨西哥上市公司的详细信息。

请求示例:

GET https://api.stocktv.top/stock/companies?countryId=7&pageSize=10&page=1&key=您的API密钥

7. WebSocket实时数据

通过WebSocket获取墨西哥股票的实时价格数据。

连接示例:

const ws = new WebSocket("wss://ws-api.stocktv.top/connect?key=您的API密钥");

数据说明

交易时间

• 墨西哥股市交易时间(中部标准时间CST):
  • 常规交易: 8:30-15:00
  • 盘后交易: 15:00-17:00
• API中的open字段表示当前是否处于交易时间

价格货币

• 所有墨西哥股票价格均以墨西哥比索(MXN)为单位

特殊处理

• 墨西哥股票代码通常为4-5位字母
• 墨西哥市场有独特的行业分类体系

墨西哥主要指数

指数代码	指数名称	说明
MXX	IPC指数	墨西哥主要股票指数，包含35只最具流动性的股票
S&P/BMV IPC	S&P/BMV IPC	标普墨西哥指数
MEXBOL	墨西哥Bolsa指数	整体市场表现指数

墨西哥知名上市公司

公司名称	股票代码	行业
América Móvil	AMXL	电信
Fomento Económico Mexicano	FEMSA	饮料/零售
Grupo México	GMEXICO	矿业
Grupo Financiero Banorte	GFNORTE	金融
Wal-Mart de México	WALMEX	零售

示例代码

Python示例

import requestsdef get_mexico_stocks(symbol=None):"""获取墨西哥股票数据"""url = "https://api.stocktv.top/stock/stocks"params = {"countryId": 7,"pageSize": 50,"page": 1,"key": "您的API密钥"}if symbol:params["symbol"] = symbolresponse = requests.get(url, params=params)return response.json()# 获取América Móvil股票数据
amxl_data = get_mexico_stocks("AMXL")
print(amxl_data)# 获取墨西哥指数数据
def get_mexico_indices():url = "https://api.stocktv.top/stock/indices"params = {"countryId": 7,"key": "您的API密钥"}response = requests.get(url, params=params)return response.json()indices_data = get_mexico_indices()
print(indices_data)

JavaScript示例

async function fetchMexicoStocks(symbol = null) {let url = `https://api.stocktv.top/stock/stocks?countryId=7&pageSize=50&page=1&key=您的API密钥`;if (symbol) {url += `&symbol=${symbol}`;}const response = await fetch(url);const data = await response.json();return data;
}// 使用示例
fetchMexicoStocks('AMXL').then(data => {console.log(data);
});// 获取墨西哥指数
async function fetchMexicoIndices() {const response = await fetch(`https://api.stocktv.top/stock/indices?countryId=7&key=您的API密钥`);const data = await response.json();return data;
}fetchMexicoIndices().then(data => {console.log(data);
});

实时监控示例

import time
import requestsdef monitor_mexico_ipc():"""监控墨西哥IPC指数"""previous_value = Nonewhile True:try:data = get_mexico_indices()# 查找IPC指数ipc_index = next((item for item in data["data"] if "IPC" in item["name"] or "MXX" in item["symbol"]), None)if ipc_index:current_value = ipc_index["last"]if previous_value is not None:change = current_value - previous_valuechange_pct = (change / previous_value) * 100print(f"IPC指数: {current_value} | 变化: {change:+.2f} ({change_pct:+.2f}%)")previous_value = current_valuetime.sleep(300)  # 每5分钟更新一次except Exception as e:print(f"获取数据失败: {e}")time.sleep(60)# 开始监控IPC指数
monitor_mexico_ipc()

WebSocket实时数据

通过WebSocket获取墨西哥股票的实时价格数据。

连接示例:

const ws = new WebSocket("wss://ws-api.stocktv.top/connect?key=您的API密钥");ws.onmessage = function(event) {const data = JSON.parse(event.data);// 墨西哥股票通常以.MX后缀标识if (data.symbol.includes('.MX')) {console.log(`墨西哥股票 ${data.symbol}: ${data.last_numeric}`);}
};

错误处理

错误代码	说明	处理建议
400	参数错误	检查countryId参数是否正确设置为7
401	认证失败	检查API Key是否有效
404	资源不存在	检查股票代码或ID是否正确
500	服务器错误	稍后重试或联系技术支持

墨西哥股市特点

1. 交易货币: 墨西哥比索(MXN)
2. 交易时间: 周一至周五，8:30-15:00（常规交易），15:00-17:00（盘后交易）
3. 市场分类: 主要板、国际板、增长板等
4. 行业分布: 电信、金融、消费、工业是主要板块
5. 外资参与: 墨西哥股市对外资相对开放

注意事项

1. 墨西哥股市交易时间与北美市场有重叠，但有自己的特色
2. 墨西哥比索(MXN)汇率波动可能影响投资回报
3. 注意墨西哥的节假日安排，可能与其它市场不同
4. 部分墨西哥公司有美国存托凭证(ADR)在美股市场交易