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

概述

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. 实时行情数据

获取美股列表

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

复制代码

获取墨西哥股票列表

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

复制代码

参数说明:

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

美股响应示例:

1. {
2.   "code": 200,
3.   "message": "操作成功",
4.   "data": {
5.     "records": [
6.       {
7.         "id": 1001,
8.         "symbol": "AAPL",
9.         "name": "Apple Inc",
10.         "last": 182.63,
11.         "chg": 1.25,
12.         "chgPct": 0.69,
13.         "high": 183.45,
14.         "low": 181.20,
15.         "volume": 28563420,
16.         "open": true,
17.         "exchangeId": 2,
18.         "countryNameTranslated": "United States",
19.         "flag": "US",
20.         "fundamentalMarketCap": 2860000000000,
21.         "fundamentalRevenue": "383.29B",
22.         "time": 1716448222,
23.         "technicalDay": "buy",
24.         "performanceDay": 0.69,
25.         "performanceWeek": 2.15,
26.         "performanceMonth": 5.32
27.       }
28.     ],
29.     "total": 8000,
30.     "current": 1,
31.     "pages": 160
32.   }
33. }

复制代码

墨西哥股票响应示例:

1. {
2.   "code": 200,
3.   "message": "操作成功",
4.   "data": {
5.     "records": [
6.       {
7.         "id": 2001,
8.         "symbol": "WALMEX",
9.         "name": "Wal-Mart de Mexico SAB de CV",
10.         "last": 68.45,
11.         "chg": 0.35,
12.         "chgPct": 0.51,
13.         "high": 68.80,
14.         "low": 67.90,
15.         "volume": 1250000,
16.         "open": true,
17.         "exchangeId": 53,
18.         "countryNameTranslated": "Mexico",
19.         "flag": "MX",
20.         "fundamentalMarketCap": 65000000000,
21.         "fundamentalRevenue": "25.4B",
22.         "time": 1716448222,
23.         "technicalDay": "neutral",
24.         "performanceDay": 0.51,
25.         "performanceWeek": 1.85,
26.         "performanceMonth": 4.67
27.       }
28.     ],
29.     "total": 150,
30.     "current": 1,
31.     "pages": 3
32.   }
33. }

复制代码

2. 主要指数数据

获取美股主要指数

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

复制代码

获取墨西哥主要指数

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

复制代码

包含的主要指数:

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

指数数据示例:

1. {
2.   "code": 200,
3.   "message": "操作成功",
4.   "data": [
5.     {
6.       "id": 101,
7.       "name": "S&P 500",
8.       "symbol": "SPX",
9.       "last": 5234.18,
10.       "chg": 45.32,
11.       "chgPct": 0.87,
12.       "high": 5241.65,
13.       "low": 5189.43,
14.       "isOpen": true,
15.       "flag": "US",
16.       "time": 1716458537
17.     },
18.     {
19.       "id": 401,
20.       "name": "S&P/BMV IPC",
21.       "symbol": "MXX",
22.       "last": 55230.45,
23.       "chg": 245.32,
24.       "chgPct": 0.45,
25.       "high": 55350.65,
26.       "low": 54980.43,
27.       "isOpen": true,
28.       "flag": "MX",
29.       "time": 1716458537
30.     }
31.   ]
32. }

复制代码

3. 个股查询功能

查询特定股票

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

复制代码

批量查询多个股票

1. 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线数据

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

复制代码

时间间隔参数:

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

K线数据格式:

1. {
2.   "time": 1719818400000,
3.   "open": 181.85,
4.   "high": 182.80,
5.   "low": 181.50,
6.   "close": 182.63,
7.   "volume": 125000,
8.   "vo": 22828750
9. }

复制代码

5. 涨跌排行榜

获取美股排行榜

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

复制代码

获取墨西哥股票排行榜

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

复制代码

排行榜类型:

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

6. 公司基本信息

获取美国上市公司信息

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

复制代码

获取墨西哥上市公司信息

1. 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

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

复制代码

实时数据格式

1. {
2.   "pid": "1001",
3.   "last_numeric": "182.63",
4.   "bid": "182.60",
5.   "ask": "182.65",
6.   "high": "183.45",
7.   "low": "181.20",
8.   "last_close": "181.38",
9.   "pc": "1.25",
10.   "pcp": "0.69",
11.   "turnover_numeric": "28563420",
12.   "time": "16:00:05",
13.   "timestamp": "1717728251",
14.   "type": 1
15. }

复制代码

市场特色

美股市场特点

主要交易所

• 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& 500成分股

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

复制代码

获取墨西哥IPC指数成分股

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

复制代码

跨市场比较查询

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

复制代码

分交易所获取股票

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

复制代码

获取实时指数数据

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

复制代码

行业分类查询

获取特定行业股票

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

复制代码

获取金融板块股票

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

复制代码

数据更新频率

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

错误处理

1. {
2.   "code": 400,
3.   "message": "参数错误",
4.   "data": null
5. }

复制代码

常见错误代码:

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

最佳实践

美股数据使用建议

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

墨西哥数据使用建议

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

跨市场策略

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

注意事项

美股注意事项

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

墨西哥市场注意事项

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

技术实现注意事项

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

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

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！