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

概述

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

获取美国股票列表

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

复制代码

获取加拿大股票列表

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

复制代码

获取墨西哥股票列表

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

复制代码

参数说明:

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

响应示例 (美股):

1. {
2.   "code": 200,
3.   "message": "操作成功",
4.   "data": {
5.     "records": [
6.       {
7.         "id": 12345,
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.         "fundamentalMarketCap": 2860000000000,
19.         "fundamentalRevenue": "383.29B",
20.         "time": 1716448222
21.       }
22.     ],
23.     "total": 8000,
24.     "current": 1,
25.     "pages": 160
26.   }
27. }

复制代码

2. 主要指数数据

获取欧美主要指数

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

复制代码

包含指数:

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

指数数据示例:

1. {
2.   "id": 1001,
3.   "name": "S&P 500",
4.   "symbol": "SPX",
5.   "last": 5234.18,
6.   "chg": 45.32,
7.   "chgPct": 0.87,
8.   "high": 5241.65,
9.   "low": 5189.43,
10.   "isOpen": true,
11.   "time": 1716458537
12. }

复制代码

3. 个股查询功能

查询特定股票

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

复制代码

批量查询多个股票

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

复制代码

支持查询方式:

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

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

获取股票K线数据

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

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

复制代码

5. 公司基本信息

获取欧美公司信息

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

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

复制代码

实时数据格式

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

复制代码

特色功能

1. 多交易所支持

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

2. 技术分析数据

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

3. 基本面数据

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

4. 高性能实时数据

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

使用示例

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

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

复制代码

获取S& 500指数成分股

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

复制代码

实时监控多个科技股

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

复制代码

数据更新频率

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

错误处理

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

复制代码

常见错误代码:

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

最佳实践

• 批量查询: 使用stocksByPids接口批量获取数据，减少API调用次数
  
• WebSocket连接: 对于实时性要求高的场景，使用WebSocket连接
  
• 缓存策略: 对公司信息等变化不频繁的数据实施缓存
  
• 错误重试: 实现适当的错误重试机制
  

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