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

概述

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

获取美国股票列表

http 复制代码

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

获取加拿大股票列表

http 复制代码

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

获取墨西哥股票列表

http 复制代码

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

参数说明:

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

响应示例 (美股):

json 复制代码

{
  "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. 主要指数数据

获取欧美主要指数

http 复制代码

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

指数数据示例:

json 复制代码

{
  "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. 个股查询功能

查询特定股票

http 复制代码

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

批量查询多个股票

http 复制代码

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

支持查询方式:

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

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

获取股票K线数据

http 复制代码

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

json 复制代码

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

5. 公司基本信息

获取欧美公司信息

http 复制代码

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

javascript 复制代码

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

实时数据格式

json 复制代码

{
  "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)实时数据

http 复制代码

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

获取S&P 500指数成分股

http 复制代码

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

实时监控多个科技股

http 复制代码

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

数据更新频率

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

错误处理

json 复制代码

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

常见错误代码:

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

最佳实践

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