欧美（美股、加拿大股票、墨西哥股票）股票数据接口文档
概述
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: 股票PIDsymbol: 股票代码 (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: 服务器内部错误
最佳实践
- 批量查询: 使用
stocksByPids接口批量获取数据，减少API调用次数 - WebSocket连接: 对于实时性要求高的场景，使用WebSocket连接
- 缓存策略: 对公司信息等变化不频繁的数据实施缓存
- 错误重试: 实现适当的错误重试机制