墨西哥证券交易所(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位字母
[*]墨西哥市场有独特的行业分类体系
墨西哥主要指数
指数代码指数名称说明MXXIPC指数墨西哥主要股票指数，包含35只最具流动性的股票S&P/BMV IPCS&P/BMV IPC标普墨西哥指数MEXBOL墨西哥Bolsa指数整体市场表现指数墨西哥知名上市公司
公司名称股票代码行业América MóvilAMXL电信Fomento Económico MexicanoFEMSA饮料/零售Grupo MéxicoGMEXICO矿业Grupo Financiero BanorteGFNORTE金融Wal-Mart de MéxicoWALMEX零售示例代码
Python示例
import requests
def 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"] = symbol
response = 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 requests
def monitor_mexico_ipc():
"""监控墨西哥IPC指数"""
previous_value = None
while 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_value
change_pct = (change / previous_value) * 100
print(f"IPC指数: {current_value} | 变化: {change:+.2f} ({change_pct:+.2f}%)")
previous_value = current_value
time.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参数是否正确设置为7401认证失败检查API Key是否有效404资源不存在检查股票代码或ID是否正确500服务器错误稍后重试或联系技术支持墨西哥股市特点
[*]交易货币: 墨西哥比索(MXN)
[*]交易时间: 周一至周五，8:30-15:00（常规交易），15:00-17:00（盘后交易）
[*]市场分类: 主要板、国际板、增长板等
[*]行业分布: 电信、金融、消费、工业是主要板块
[*]外资参与: 墨西哥股市对外资相对开放
注意事项
[*]墨西哥股市交易时间与北美市场有重叠，但有自己的特色
[*]墨西哥比索(MXN)汇率波动可能影响投资回报
[*]注意墨西哥的节假日安排，可能与其它市场不同
[*]部分墨西哥公司有美国存托凭证(ADR)在美股市场交易
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
页:
[1]