首页/资讯中心/详情

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

欧美（美股、加拿大股票、墨西哥股票）股票数据接口文档
📅 发布时间：2026/6/20 15:05:47

概述

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. 错误重试: 实现适当的错误重试机制