美股及墨西哥股票数据接口文档
概述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_KEY7. 技术指标数据
包含的技术指标:
[*]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: 服务器内部错误
最佳实践
美股数据使用建议
[*]批量查询: 使用stocksByPids接口批量获取FAANG等科技股数据
[*]盘前盘后: 注意交易时间，可获取盘前盘后数据
[*]行业分析: 利用行业分类进行板块轮动分析
[*]实时监控: 对高波动性股票使用WebSocket实时监控
墨西哥数据使用建议
[*]货币转换: 注意比索与美元的汇率转换
[*]本地化信息: 关注墨西哥本地经济数据和政策
[*]大宗商品关联: 注意大宗商品价格对墨西哥股票的影响
[*]美国市场联动: 关注美股对墨西哥市场的传导效应
跨市场策略
[*]比较分析: 比较同类行业在不同市场的表现
[*]汇率风险: 注意汇率波动对投资回报的影响
[*]时区考虑: 考虑不同交易时间的重叠和影响
[*]风险分散: 利用两个市场的低相关性进行风险分散
注意事项
美股注意事项
[*]交易时间: 注意美东时间与本地时区的差异
[*]财报季节: 关注季度财报发布对股价的影响
[*]美联储政策: 关注利率政策对市场的影响
[*]期权到期日: 注意月度期权到期对市场波动的影响
墨西哥市场注意事项
[*]政治风险: 关注墨西哥国内政治环境变化
[*]汇率波动: 比索汇率波动对投资收益的影响
[*]美国经济: 美国经济数据对墨西哥市场的传导
[*]大宗商品: 原油等大宗商品价格对相关股票的影响
技术实现注意事项
[*]API限制: 注意API调用频率限制
[*]数据格式: 价格和交易量的数值格式化
[*]错误处理: 实现完善的错误处理和重试机制
[*]数据缓存: 对静态数据实施适当的缓存策略
本文档基于 StockTV API 生成，具体接口参数以最新官方文档为准。美股和墨西哥股票数据实时更新，提供全面的市场覆盖和深度的财务数据。
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！ 分享、互助 让互联网精神温暖你我 yyds。多谢分享 yyds。多谢分享
页:
[1]