首页/资讯中心/详情

美股及墨西哥股票数据接口文档

美股及墨西哥股票数据接口文档
📅 发布时间：2026/6/20 8:58:25

概述

StockTV 提供全面的美国及墨西哥股票市场数据接口，覆盖纽约证券交易所（NYSE）、纳斯达克（NASDAQ）、墨西哥证券交易所（BMV）等主要交易所。支持实时行情、技术分析、公司信息等多种功能。

交易所信息

美国市场

  • NYSE (纽约证券交易所): 交易所ID 1
  • NASDAQ (纳斯达克): 交易所ID 2
  • 交易时间: 美东时间 09:30-16:00
  • 货币: 美元 (USD)

墨西哥市场

  • 墨西哥证券交易所 (BMV): 交易所ID 53
  • BIVA (墨西哥 Institutional Stock Exchange): 交易所ID 144
  • 交易时间: 墨西哥时间 08:30-15:00
  • 货币: 墨西哥比索 (MXN)

核心功能接口

1. 实时行情数据

获取美股列表

GET /stock/stocks?countryId=1&pageSize=50&page=1&key=您的API_KEY

获取墨西哥股票列表

GET /stock/stocks?countryId=4&pageSize=50&page=1&key=您的API_KEY

参数说明:

  • countryId: 国家ID (美国=1, 墨西哥=4)
  • exchangeId: 交易所ID (可选)
  • pageSize: 每页数量
  • page: 页码

美股响应示例:

{"code": 200,"message": "操作成功","data": {"records": [{"id": 1001,"symbol": "AAPL","name": "Apple Inc","last": 182.63,"chg": 1.25,"chgPct": 0.69,"high": 183.45,"low": 181.20,"volume": 28563420,"open": true,"exchangeId": 2,"countryNameTranslated": "United States","flag": "US","fundamentalMarketCap": 2860000000000,"fundamentalRevenue": "383.29B","time": 1716448222,"technicalDay": "buy","performanceDay": 0.69,"performanceWeek": 2.15,"performanceMonth": 5.32}],"total": 8000,"current": 1,"pages": 160}
}

墨西哥股票响应示例:

{"code": 200,"message": "操作成功","data": {"records": [{"id": 2001,"symbol": "WALMEX","name": "Wal-Mart de Mexico SAB de CV","last": 68.45,"chg": 0.35,"chgPct": 0.51,"high": 68.80,"low": 67.90,"volume": 1250000,"open": true,"exchangeId": 53,"countryNameTranslated": "Mexico","flag": "MX","fundamentalMarketCap": 65000000000,"fundamentalRevenue": "25.4B","time": 1716448222,"technicalDay": "neutral","performanceDay": 0.51,"performanceWeek": 1.85,"performanceMonth": 4.67}],"total": 150,"current": 1,"pages": 3}
}

2. 主要指数数据

获取美股主要指数

GET /stock/indices?countryId=1&key=您的API_KEY

获取墨西哥主要指数

GET /stock/indices?countryId=4&key=您的API_KEY

包含的主要指数:

  • 美国: S&P 500, Dow Jones Industrial Average, NASDAQ Composite, Russell 2000
  • 墨西哥: S&P/BMV IPC, FTSE BIVA

指数数据示例:

{"code": 200,"message": "操作成功","data": [{"id": 101,"name": "S&P 500","symbol": "SPX","last": 5234.18,"chg": 45.32,"chgPct": 0.87,"high": 5241.65,"low": 5189.43,"isOpen": true,"flag": "US","time": 1716458537},{"id": 401,"name": "S&P/BMV IPC","symbol": "MXX","last": 55230.45,"chg": 245.32,"chgPct": 0.45,"high": 55350.65,"low": 54980.43,"isOpen": true,"flag": "MX","time": 1716458537}]
}

3. 个股查询功能

查询特定股票

GET /stock/queryStocks?symbol=AAPL&key=您的API_KEY

批量查询多个股票

GET /stock/stocksByPids?key=您的API_KEY&pids=1001,2001,1002,2002

热门美股代码:

  • AAPL: Apple Inc
  • MSFT: Microsoft Corporation
  • GOOGL: Alphabet Inc (Google)
  • AMZN: Amazon.com Inc
  • TSLA: Tesla Inc
  • META: Meta Platforms Inc
  • NVDA: NVIDIA Corporation
  • JPM: JPMorgan Chase & Co

热门墨西哥股票代码:

  • WALMEX: Wal-Mart de Mexico
  • AMXL: America Movil
  • GFNORTE: Grupo Financiero Banorte
  • CEMEX: Cemex SAB de CV
  • FEMSA: Fomento Economico Mexicano
  • GMEXICO: Grupo Mexico
  • TLEVISA: Grupo Televisa

4. K线数据（技术分析）

获取股票K线数据

GET /stock/kline?pid=1001&interval=PT1H&key=您的API_KEY

时间间隔参数:

  • PT5M - 5分钟
  • PT15M - 15分钟
  • PT1H - 1小时
  • P1D - 1天
  • P1W - 1周
  • P1M - 1月

K线数据格式:

{"time": 1719818400000,"open": 181.85,"high": 182.80,"low": 181.50,"close": 182.63,"volume": 125000,"vo": 22828750
}

5. 涨跌排行榜

获取美股排行榜

GET /stock/updownList?countryId=1&type=1&key=您的API_KEY

获取墨西哥股票排行榜

GET /stock/updownList?countryId=4&type=1&key=您的API_KEY

排行榜类型:

  • type=1: 涨幅榜
  • type=2: 跌幅榜
  • type=3: 成交额榜
  • type=4: 成交量榜

6. 公司基本信息

获取美国上市公司信息

GET /stock/companies?countryId=1&pageSize=20&page=1&key=您的API_KEY

获取墨西哥上市公司信息

GET /stock/companies?countryId=4&pageSize=20&page=1&key=您的API_KEY

7. 技术指标数据

包含的技术指标:

  • technicalDay: 日线技术指标
  • technicalHour: 小时线技术指标
  • technicalWeek: 周线技术指标
  • technicalMonth: 月线技术指标

技术指标值:

  • strong_buy: 强烈买入
  • buy: 买入
  • neutral: 中性
  • sell: 卖出
  • strong_sell: 强烈卖出

8. 基本面数据

包含的基本面指标:

  • fundamentalBeta: Beta值
  • fundamentalMarketCap: 市值
  • fundamentalRevenue: 收入
  • fundamentalRatio: 基本面比率
  • performanceDay: 当日表现
  • performanceWeek: 周表现
  • performanceMonth: 月表现
  • performanceYtd: 年初至今表现

9. WebSocket 实时数据

连接WebSocket

const wsUri = "wss://ws-api.stocktv.top/connect?key=您的API_KEY";
const websocket = new WebSocket(wsUri);

实时数据格式

{"pid": "1001","last_numeric": "182.63","bid": "182.60","ask": "182.65","high": "183.45","low": "181.20","last_close": "181.38","pc": "1.25","pcp": "0.69","turnover_numeric": "28563420","time": "16:00:05","timestamp": "1717728251","type": 1
}

市场特色

美股市场特点

主要交易所

  • NYSE: 传统蓝筹股集中地
  • NASDAQ: 科技股和创新公司集中地

交易机制

  • T+2结算制度
  • 盘前交易 (04:00-09:30 ET)
  • 盘后交易 (16:00-20:00 ET)
  • 涨跌幅无限制（但有熔断机制）

主要板块

  • 科技板块: FAANG股票 (Facebook, Apple, Amazon, Netflix, Google)
  • 金融板块: 银行、保险、投资公司
  • 医疗保健: 制药、生物科技
  • 消费品: 零售、消费品公司
  • 工业: 制造业、航空航天

墨西哥市场特点

主要交易所

  • BMV (Bolsa Mexicana de Valores): 主要交易所
  • BIVA (Bolsa Institucional de Valores): 新兴交易所

市场特色

  • 拉丁美洲第二大股票市场
  • 以比索计价交易
  • 受美国经济影响较大
  • 大宗商品相关股票占比较高

主要行业

  • 电信业: America Movil主导
  • 零售业: Walmart de Mexico
  • 金融业: 银行和金融机构
  • 材料业: 水泥、矿业公司
  • 工业: 制造业公司

使用示例

获取S&P 500成分股

GET /stock/stocks?countryId=1&pageSize=500&key=您的API_KEY

获取墨西哥IPC指数成分股

GET /stock/stocks?countryId=4&pageSize=35&key=您的API_KEY

跨市场比较查询

GET /stock/stocksByPids?key=您的API_KEY&pids=1001,2001,1002,2002,1003,2003

分交易所获取股票

GET /stock/stocks?countryId=1&exchangeId=2&pageSize=100&key=您的API_KEY

获取实时指数数据

GET /stock/indicesById?id=101&key=您的API_KEY

行业分类查询

获取特定行业股票

GET /stock/queryStocks?industry=Technology&countryId=1&key=您的API_KEY

获取金融板块股票

GET /stock/queryStocks?sector=Financials&countryId=4&key=您的API_KEY

数据更新频率

  • 实时行情: 秒级更新
  • K线数据: 按选择间隔实时更新
  • 指数数据: 实时更新
  • 公司信息: 每日更新
  • 基本面数据: 实时更新

错误处理

{"code": 400,"message": "参数错误","data": null
}

常见错误代码:

  • 200: 操作成功
  • 400: 参数错误
  • 401: API Key无效
  • 404: 数据不存在
  • 500: 服务器内部错误

最佳实践

美股数据使用建议

  1. 批量查询: 使用stocksByPids接口批量获取FAANG等科技股数据
  2. 盘前盘后: 注意交易时间，可获取盘前盘后数据
  3. 行业分析: 利用行业分类进行板块轮动分析
  4. 实时监控: 对高波动性股票使用WebSocket实时监控

墨西哥数据使用建议

  1. 货币转换: 注意比索与美元的汇率转换
  2. 本地化信息: 关注墨西哥本地经济数据和政策
  3. 大宗商品关联: 注意大宗商品价格对墨西哥股票的影响
  4. 美国市场联动: 关注美股对墨西哥市场的传导效应

跨市场策略

  1. 比较分析: 比较同类行业在不同市场的表现
  2. 汇率风险: 注意汇率波动对投资回报的影响
  3. 时区考虑: 考虑不同交易时间的重叠和影响
  4. 风险分散: 利用两个市场的低相关性进行风险分散

注意事项

美股注意事项

  1. 交易时间: 注意美东时间与本地时区的差异
  2. 财报季节: 关注季度财报发布对股价的影响
  3. 美联储政策: 关注利率政策对市场的影响
  4. 期权到期日: 注意月度期权到期对市场波动的影响

墨西哥市场注意事项

  1. 政治风险: 关注墨西哥国内政治环境变化
  2. 汇率波动: 比索汇率波动对投资收益的影响
  3. 美国经济: 美国经济数据对墨西哥市场的传导
  4. 大宗商品: 原油等大宗商品价格对相关股票的影响

技术实现注意事项

  1. API限制: 注意API调用频率限制
  2. 数据格式: 价格和交易量的数值格式化
  3. 错误处理: 实现完善的错误处理和重试机制
  4. 数据缓存: 对静态数据实施适当的缓存策略

本文档基于 StockTV API 生成，具体接口参数以最新官方文档为准。美股和墨西哥股票数据实时更新，提供全面的市场覆盖和深度的财务数据。