本文档详细说明如何对接StockTV全球股票API中的墨西哥股票数据。墨西哥股票市场是拉丁美洲重要的金融市场之一,包含墨西哥证券交易所(BMV)等多个交易所。
认证方式
所有API请求都需要在URL参数中包含API Key:基础信息
- 墨西哥国家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&
/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字段表示当前是否处于交易时间
价格货币
特殊处理
- 墨西哥股票代码通常为4-5位字母
- 墨西哥市场有独特的行业分类体系
墨西哥主要指数
指数代码指数名称说明MXXIPC指数墨西哥主要股票指数,包含35只最具流动性的股票S& /BMV IPCS& /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)在美股市场交易
来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作! |