概述
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: 服务器内部错误
