当前位置: 首页 > news >正文

欧美(美股、加拿大股票、墨西哥股票)股票数据接口文档

概述

StockTV 提供全面的欧美股票市场数据接口,覆盖美国、加拿大、墨西哥等主要欧美市场。支持实时行情、技术分析、公司信息等多种功能。

国家与交易所对应关系

美国市场

  • NYSE (纽约证券交易所): 交易所ID 1
  • NASDAQ (纳斯达克): 交易所ID 2

加拿大市场

  • Toronto (多伦多交易所): 交易所ID 51
  • TSXV (多伦多创业板): 交易所ID 108
  • CSE (加拿大证券交易所): 交易所ID 109

墨西哥市场

  • Mexico (墨西哥交易所): 交易所ID 53
  • BIVA (墨西哥 Institutional Stock Exchange): 交易所ID 144

核心功能接口

1. 实时行情数据

获取美国股票列表

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

获取加拿大股票列表

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

获取墨西哥股票列表

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

参数说明:

  • countryId: 国家ID (美国=5, 加拿大=6, 墨西哥=7)
  • exchangeId: 交易所ID (可选)
  • pageSize: 每页数量
  • page: 页码

响应示例 (美股):

{"code": 200,"message": "操作成功","data": {"records": [{"id": 12345,"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,"fundamentalMarketCap": 2860000000000,"fundamentalRevenue": "383.29B","time": 1716448222}],"total": 8000,"current": 1,"pages": 160}
}

2. 主要指数数据

获取欧美主要指数

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

包含指数:

  • 美国: S&P 500, Dow Jones, NASDAQ Composite, Russell 2000
  • 加拿大: S&P/TSX Composite
  • 墨西哥: S&P/BMV IPC

指数数据示例:

{"id": 1001,"name": "S&P 500","symbol": "SPX","last": 5234.18,"chg": 45.32,"chgPct": 0.87,"high": 5241.65,"low": 5189.43,"isOpen": true,"time": 1716458537
}

3. 个股查询功能

查询特定股票

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

批量查询多个股票

GET /stock/stocksByPids?key=您的API_KEY&pids=12345,67890,54321

支持查询方式:

  • id: 股票PID
  • symbol: 股票代码 (AAPL, TSLA, MSFT等)
  • name: 股票名称
  • url: 详情页链接

4. K线数据(技术分析)

获取股票K线数据

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

时间间隔参数:

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

K线数据格式:

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

5. 公司基本信息

获取欧美公司信息

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

公司信息包含:

  • 公司名称和描述
  • 所属行业和板块
  • 员工人数
  • 市值和收入数据

6. 技术指标数据

包含的技术指标:

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

技术指标值:

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

7. 基本面数据

包含的基本面指标:

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

8. WebSocket 实时数据

连接WebSocket

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

实时数据格式

{"pid": "12345","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
}

特色功能

1. 多交易所支持

  • 同时支持NYSE、NASDAQ等主要交易所
  • 实时同步交易所数据
  • 支持盘前盘后交易数据

2. 技术分析数据

  • 多种时间周期的K线数据
  • 实时技术指标计算
  • 专业的技术分析信号

3. 基本面数据

  • 实时市值和财务数据
  • 公司基本信息
  • 行业分类数据

4. 高性能实时数据

  • 秒级数据更新
  • 低延迟WebSocket连接
  • 批量数据查询支持

使用示例

获取苹果公司(AAPL)实时数据

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

获取S&P 500指数成分股

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

实时监控多个科技股

GET /stock/stocksByPids?key=您的API_KEY&pids=12345,67890,54321,98765

数据更新频率

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

错误处理

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

常见错误代码:

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

最佳实践

  1. 批量查询: 使用stocksByPids接口批量获取数据,减少API调用次数
  2. WebSocket连接: 对于实时性要求高的场景,使用WebSocket连接
  3. 缓存策略: 对公司信息等变化不频繁的数据实施缓存
  4. 错误重试: 实现适当的错误重试机制
http://www.hskmm.com/?act=detail&tid=30121

相关文章:

  • 2025年GEO(AI搜索优化)服务商口碑排行榜
  • vue播放rtsp流方案
  • 2025年GEO(AI搜索优化)源头厂家权威推荐榜单:云视有客科技领跑行业
  • 2025年GEO(AI搜索优化)公司口碑推荐排行榜单
  • 基于MATLAB的天线方向图综合与雷达天线设计
  • ​个人微信机器人开发
  • Kong Gateway 实操实例:代理上游服务并配置限流插件 - 指南
  • 2025 年最新二手手机交易公司推荐排行榜:聚焦企业的专业与诚信实力,为消费者精选可靠选择
  • 项目管理中的批量更新如何帮助节省时间和工作量?
  • 第三届大数据与数据挖掘国际会议(IEEE BDDM 2025)
  • CSS学习日记
  • 基于MATLAB的波导杆超声波传播仿真程序集设计与实现
  • for 循环中range的部分
  • JAVA函数式编程
  • 2025中国不锈钢反应釜厂家TOP5权威推荐(附技术参数对比)
  • MySQL数据库
  • 中电金信 :源启数据建模平台:自定义功能上线,实现高效模型管理
  • 国产软件项目管理革命:Gitee PPM如何重塑开发效率
  • 网关本质论
  • 用最通俗易懂的方式解读以太坊的dAI团队和ERC-8004标准
  • 赋能智慧农业:ISUP协议视频平台EasyCVR智慧农业视频远程监控管理方案
  • 集成开发工具 IDEA下载
  • 10.12一周观察
  • 视频融合平台EasyCVR在智慧水利中的实战应用:构建全域感知与智能预警平台
  • 数据流图和uml九张图 - f
  • 03_mysql运维核心基础
  • 2025.10.13+7
  • Adobe Animate 2025 中文破解版下载|HTML5 动画开发 + 2D 交互设计工具(附安装教程)
  • 2025年10月双氧水厂家最新权威推荐榜:高效消毒与环保品质之选
  • GSPO