墨西哥证券交易所(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 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参数是否正确设置为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)在美股市场交易
posted @ 2025-10-08 23:00  CryptoRzz  阅读(17)  评论(0)    收藏  举报