欧美（美股、加拿大股票、墨西哥股票）股票数据接口文档
概述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: 服务器内部错误
最佳实践
[*]批量查询: 使用stocksByPids接口批量获取数据，减少API调用次数
[*]WebSocket连接: 对于实时性要求高的场景，使用WebSocket连接
[*]缓存策略: 对公司信息等变化不频繁的数据实施缓存
[*]错误重试: 实现适当的错误重试机制
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
页:
[1]