找回密码
 立即注册
首页 业界区 安全 墨西哥证券交易所(BMV)等多个交易所股票数据API对接文档 ...

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

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

所有API请求都需要在URL参数中包含API Key:
  1. key=您的API密钥
复制代码
基础信息


  • 墨西哥国家ID: countryId=7
  • 主要交易所ID:

    • 墨西哥证券交易所(Bolsa Mexicana de Valores): exchangeId=53
    • 墨西哥 institutional exchange: exchangeId=144

API端点

1. 墨西哥股票市场列表

获取墨西哥股票市场列表,支持分页查询。
请求示例:
  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
响应示例:
  1. {
  2.   "code": 200,
  3.   "message": "操作成功",
  4.   "data": {
  5.     "records": [
  6.       {
  7.         "id": 12345,
  8.         "name": "América Móvil",
  9.         "symbol": "AMXL",
  10.         "last": 16.78,
  11.         "chg": 0.25,
  12.         "chgPct": 1.51,
  13.         "high": 16.85,
  14.         "low": 16.50,
  15.         "volume": 2856400,
  16.         "avgVolume": 3201500,
  17.         "exchangeId": 53,
  18.         "countryId": 7,
  19.         "flag": "MX",
  20.         "open": true,
  21.         "lastClose": 16.53,
  22.         "time": 1716458537,
  23.         "url": "/equities/america-movil",
  24.         "fundamentalMarketCap": 525000000000,
  25.         "fundamentalRevenue": "850.75B",
  26.         "performanceDay": 1.51,
  27.         "performanceWeek": 2.34,
  28.         "performanceMonth": 5.67,
  29.         "performanceYear": 15.23,
  30.         "technicalDay": "buy",
  31.         "technicalWeek": "strong_buy"
  32.       }
  33.     ],
  34.     "total": 150,
  35.     "size": 50,
  36.     "current": 1,
  37.     "pages": 3
  38.   }
  39. }
复制代码
2. 查询特定墨西哥股票

通过股票ID、名称或代码查询墨西哥股票信息。
请求示例:
  1. GET https://api.stocktv.top/stock/queryStocks?countryId=7&symbol=AMXL&key=您的API密钥
复制代码
参数说明:

  • id: 股票PID(可选)
  • name: 股票名称(可选)
  • symbol: 股票代码(可选)
  • url: 股票详情页URL(可选)
3. 墨西哥指数数据

获取墨西哥主要股票指数信息。
请求示例:
  1. GET https://api.stocktv.top/stock/indices?countryId=7&key=您的API密钥
复制代码
响应包含:

  • IPC指数(Índice de Precios y Cotizaciones)
  • S&/BMV IPC指数
  • MEXBOL指数等
4. 墨西哥股票K线数据

获取墨西哥股票的K线图表数据。
请求示例:
  1. 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. 墨西哥股票涨跌排行榜

获取墨西哥股票的涨跌幅排行榜。
请求示例:
  1. GET https://api.stocktv.top/stock/updownList?countryId=7&type=1&key=您的API密钥
复制代码
类型参数:

  • 1: 涨幅榜
  • 2: 跌幅榜
  • 3: 涨停榜
  • 4: 跌停榜
6. 墨西哥上市公司信息

获取墨西哥上市公司的详细信息。
请求示例:
  1. GET https://api.stocktv.top/stock/companies?countryId=7&pageSize=10&page=1&key=您的API密钥
复制代码
7. WebSocket实时数据

通过WebSocket获取墨西哥股票的实时价格数据。
连接示例:
  1. 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&/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示例
  1. import requests
  2. def get_mexico_stocks(symbol=None):
  3.     """获取墨西哥股票数据"""
  4.     url = "https://api.stocktv.top/stock/stocks"
  5.     params = {
  6.         "countryId": 7,
  7.         "pageSize": 50,
  8.         "page": 1,
  9.         "key": "您的API密钥"
  10.     }
  11.    
  12.     if symbol:
  13.         params["symbol"] = symbol
  14.         
  15.     response = requests.get(url, params=params)
  16.     return response.json()
  17. # 获取América Móvil股票数据
  18. amxl_data = get_mexico_stocks("AMXL")
  19. print(amxl_data)
  20. # 获取墨西哥指数数据
  21. def get_mexico_indices():
  22.     url = "https://api.stocktv.top/stock/indices"
  23.     params = {
  24.         "countryId": 7,
  25.         "key": "您的API密钥"
  26.     }
  27.     response = requests.get(url, params=params)
  28.     return response.json()
  29. indices_data = get_mexico_indices()
  30. print(indices_data)
复制代码
JavaScript示例
  1. async function fetchMexicoStocks(symbol = null) {
  2.   let url = `https://api.stocktv.top/stock/stocks?countryId=7&pageSize=50&page=1&key=您的API密钥`;
  3.   
  4.   if (symbol) {
  5.     url += `&symbol=${symbol}`;
  6.   }
  7.   
  8.   const response = await fetch(url);
  9.   const data = await response.json();
  10.   return data;
  11. }
  12. // 使用示例
  13. fetchMexicoStocks('AMXL').then(data => {
  14.   console.log(data);
  15. });
  16. // 获取墨西哥指数
  17. async function fetchMexicoIndices() {
  18.   const response = await fetch(
  19.     `https://api.stocktv.top/stock/indices?countryId=7&key=您的API密钥`
  20.   );
  21.   const data = await response.json();
  22.   return data;
  23. }
  24. fetchMexicoIndices().then(data => {
  25.   console.log(data);
  26. });
复制代码
实时监控示例
  1. import time
  2. import requests
  3. def monitor_mexico_ipc():
  4.     """监控墨西哥IPC指数"""
  5.     previous_value = None
  6.    
  7.     while True:
  8.         try:
  9.             data = get_mexico_indices()
  10.             # 查找IPC指数
  11.             ipc_index = next((item for item in data["data"] if "IPC" in item["name"] or "MXX" in item["symbol"]), None)
  12.             
  13.             if ipc_index:
  14.                 current_value = ipc_index["last"]
  15.                
  16.                 if previous_value is not None:
  17.                     change = current_value - previous_value
  18.                     change_pct = (change / previous_value) * 100
  19.                     print(f"IPC指数: {current_value} | 变化: {change:+.2f} ({change_pct:+.2f}%)")
  20.                
  21.                 previous_value = current_value
  22.             
  23.             time.sleep(300)  # 每5分钟更新一次
  24.             
  25.         except Exception as e:
  26.             print(f"获取数据失败: {e}")
  27.             time.sleep(60)
  28. # 开始监控IPC指数
  29. monitor_mexico_ipc()
复制代码
WebSocket实时数据

通过WebSocket获取墨西哥股票的实时价格数据。
连接示例:
  1. const ws = new WebSocket("wss://ws-api.stocktv.top/connect?key=您的API密钥");
  2. ws.onmessage = function(event) {
  3.   const data = JSON.parse(event.data);
  4.   // 墨西哥股票通常以.MX后缀标识
  5.   if (data.symbol.includes('.MX')) {
  6.     console.log(`墨西哥股票 ${data.symbol}: ${data.last_numeric}`);
  7.   }
  8. };
复制代码
错误处理

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


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


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

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!
您需要登录后才可以回帖 登录 | 立即注册