墨西哥證券交易所(BMV)等多個交易所股票數(shù)據(jù)API對接文檔
本文檔詳細(xì)說明如何對接StockTV全球股票API中的墨西哥股票數(shù)據(jù)。墨西哥股票市場是拉丁美洲重要的金融市場之一，包含墨西哥證券交易所(BMV)等多個交易所。
認(rèn)證方式
所有API請求都需要在URL參數(shù)中包含API Key：
key=您的API密鑰
基礎(chǔ)信息
- 墨西哥國家ID:
countryId=7 - 主要交易所ID:
- 墨西哥證券交易所(Bolsa Mexicana de Valores):
exchangeId=53 - 墨西哥 institutional exchange:
exchangeId=144
- 墨西哥證券交易所(Bolsa Mexicana de Valores):
API端點
1. 墨西哥股票市場列表
獲取墨西哥股票市場列表，支持分頁查詢。
請求示例:
GET https://api.stocktv.top/stock/stocks?countryId=7&pageSize=50&page=1&key=您的API密鑰
參數(shù)說明:
countryId: 必須為7(墨西哥)pageSize: 每頁返回數(shù)量(默認(rèn)10，最大100)page: 頁碼(默認(rèn)1)exchangeId: 可選，交易所ID
響應(yīng)示例:
{
"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密鑰
參數(shù)說明:
id: 股票PID(可選)name: 股票名稱(可選)symbol: 股票代碼(可選)url: 股票詳情頁URL(可選)
3. 墨西哥指數(shù)數(shù)據(jù)
獲取墨西哥主要股票指數(shù)信息。
請求示例:
GET https://api.stocktv.top/stock/indices?countryId=7&key=您的API密鑰
響應(yīng)包含:
- IPC指數(shù)(índice de Precios y Cotizaciones)
- S&P/BMV IPC指數(shù)
- MEXBOL指數(shù)等
4. 墨西哥股票K線數(shù)據(jù)
獲取墨西哥股票的K線圖表數(shù)據(jù)。
請求示例:
GET https://api.stocktv.top/stock/kline?pid=12345&interval=PT1H&key=您的API密鑰
時間間隔參數(shù):
- 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密鑰
類型參數(shù):
- 1: 漲幅榜
- 2: 跌幅榜
- 3: 漲停榜
- 4: 跌停榜
6. 墨西哥上市公司信息
獲取墨西哥上市公司的詳細(xì)信息。
請求示例:
GET https://api.stocktv.top/stock/companies?countryId=7&pageSize=10&page=1&key=您的API密鑰
7. WebSocket實時數(shù)據(jù)
通過WebSocket獲取墨西哥股票的實時價格數(shù)據(jù)。
連接示例:
const ws = new WebSocket("wss://ws-api.stocktv.top/connect?key=您的API密鑰");
數(shù)據(jù)說明
交易時間
- 墨西哥股市交易時間(中部標(biāo)準(zhǔn)時間CST):
- 常規(guī)交易: 8:30-15:00
- 盤后交易: 15:00-17:00
- API中的
open字段表示當(dāng)前是否處于交易時間
價格貨幣
- 所有墨西哥股票價格均以墨西哥比索(MXN)為單位
特殊處理
- 墨西哥股票代碼通常為4-5位字母
- 墨西哥市場有獨特的行業(yè)分類體系
墨西哥主要指數(shù)
| 指數(shù)代碼 | 指數(shù)名稱 | 說明 |
|---|---|---|
| MXX | IPC指數(shù) | 墨西哥主要股票指數(shù)，包含35只最具流動性的股票 |
| S&P/BMV IPC | S&P/BMV IPC | 標(biāo)普墨西哥指數(shù) |
| MEXBOL | 墨西哥Bolsa指數(shù) | 整體市場表現(xiàn)指數(shù) |
墨西哥知名上市公司
| 公司名稱 | 股票代碼 | 行業(yè) |
|---|---|---|
| América Móvil | AMXL | 電信 |
| Fomento Económico Mexicano | FEMSA | 飲料/零售 |
| Grupo México | GMEXICO | 礦業(yè) |
| Grupo Financiero Banorte | GFNORTE | 金融 |
| Wal-Mart de México | WALMEX | 零售 |
示例代碼
Python示例
import requests
def get_mexico_stocks(symbol=None):
"""獲取墨西哥股票數(shù)據(jù)"""
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股票數(shù)據(jù)
amxl_data = get_mexico_stocks("AMXL")
print(amxl_data)
# 獲取墨西哥指數(shù)數(shù)據(jù)
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);
});
// 獲取墨西哥指數(shù)
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);
});
實時監(jiān)控示例
import time
import requests
def monitor_mexico_ipc():
"""監(jiān)控墨西哥IPC指數(shù)"""
previous_value = None
while True:
try:
data = get_mexico_indices()
# 查找IPC指數(shù)
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指數(shù): {current_value} | 變化: {change:+.2f} ({change_pct:+.2f}%)")
previous_value = current_value
time.sleep(300) # 每5分鐘更新一次
except Exception as e:
print(f"獲取數(shù)據(jù)失敗: {e}")
time.sleep(60)
# 開始監(jiān)控IPC指數(shù)
monitor_mexico_ipc()
WebSocket實時數(shù)據(jù)
通過WebSocket獲取墨西哥股票的實時價格數(shù)據(jù)。
連接示例:
const ws = new WebSocket("wss://ws-api.stocktv.top/connect?key=您的API密鑰");
ws.onmessage = function(event) {
const data = JSON.parse(event.data);
// 墨西哥股票通常以.MX后綴標(biāo)識
if (data.symbol.includes('.MX')) {
console.log(`墨西哥股票 ${data.symbol}: ${data.last_numeric}`);
}
};
錯誤處理
| 錯誤代碼 | 說明 | 處理建議 |
|---|---|---|
| 400 | 參數(shù)錯誤 | 檢查countryId參數(shù)是否正確設(shè)置為7 |
| 401 | 認(rèn)證失敗 | 檢查API Key是否有效 |
| 404 | 資源不存在 | 檢查股票代碼或ID是否正確 |
| 500 | 服務(wù)器錯誤 | 稍后重試或聯(lián)系技術(shù)支持 |
墨西哥股市特點
- 交易貨幣: 墨西哥比索(MXN)
- 交易時間: 周一至周五，8:30-15:00（常規(guī)交易），15:00-17:00（盤后交易）
- 市場分類: 主要板、國際板、增長板等
- 行業(yè)分布: 電信、金融、消費、工業(yè)是主要板塊
- 外資參與: 墨西哥股市對外資相對開放
注意事項
- 墨西哥股市交易時間與北美市場有重疊，但有自己的特色
- 墨西哥比索(MXN)匯率波動可能影響投資回報
- 注意墨西哥的節(jié)假日安排，可能與其它市場不同
- 部分墨西哥公司有美國存托憑證(ADR)在美股市場交易
浙公網(wǎng)安備 33010602011771號