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

概述

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 生成，具体接口参数以最新官方文档为准。美股和墨西哥股票数据实时更新，提供全面的市场覆盖和深度的财务数据。