当前位置： 首页 > news >正文

美股市场股票数据API对接文档

news 2025/9/8 8:23:07

本文档提供StockTV美股市场数据API的完整对接指南，涵盖实时行情、历史数据、公司信息、财务指标等核心功能

一、接口概览

1.1 支持交易所

交易所代码交易所名称主要上市公司
NYSE纽约证券交易所蓝筹股、传统行业巨头
NASDAQ纳斯达克交易所科技股、成长型公司
AMEX美国证券交易所中小型公司、ETF

1.2 数据特性

  • 实时行情：毫秒级延迟（WebSocket）
  • 历史数据：支持最长20年历史数据
  • 基本面数据：完整财务指标、分析师评级
  • 多维度数据：分时K线、盘前盘后、期权数据
  • 数据格式：统一JSON格式

二、接入准备

2.1 获取API Key

联系官方获取密钥：https://t.me/CryptoRzz

2.2 请求基础URL

https://api.stocktv.top

2.3 请求头设置

X-Api-Key: YOUR_API_KEY
Content-Type: application/json

三、核心接口说明

3.1 股票实时行情

获取单只股票实时数据

接口地址：

GET /us/quote

请求参数：

参数必选说明示例值
symbol是股票代码AAPL

响应示例：

{"code": 200,"data": {"symbol": "AAPL","name": "Apple Inc.","exchange": "NASDAQ","price": 175.43,           // 最新价"prevClose": 173.75,       // 前收盘"open": 174.20,            // 开盘价"high": 175.85,            // 最高价"low": 173.90,             // 最低价"volume": 58439210,        // 成交量"marketCap": 2735000000000,// 市值(美元)"peRatio": 28.7,           // 市盈率"eps": 6.11,               // 每股收益"dividendYield": 0.55,     // 股息率"beta": 1.23,              // Beta值"lastUpdated": 1725008213  // 最后更新时间戳}
}

3.2 批量查询行情

获取多只股票实时数据

接口地址：

POST /us/batch-quotes

请求体：

{"symbols": ["AAPL", "MSFT", "GOOGL"]
}

响应示例：

{"code": 200,"data": {"AAPL": {"price": 175.43,"change": 1.68,"changePercent": 0.97},"MSFT": {"price": 342.54,"change": -0.86,"changePercent": -0.25},"GOOGL": {"price": 143.28,"change": 2.15,"changePercent": 1.52}}
}

3.3 历史K线数据

获取股票历史价格

接口地址：

GET /us/historical

请求参数：

参数必选说明示例值
symbol是股票代码AAPL
period否时间周期1d, 1w, 1m, 3m, 6m, 1y, 5y
interval否时间粒度1m, 5m, 15m, 30m, 1h, 1d
start否开始日期(YYYYMMDD)20230901
end否结束日期(YYYYMMDD)20230930

响应示例：

{"code": 200,"data": [{"date": "2023-09-01","open": 174.20,"high": 175.85,"low": 173.90,"close": 175.43,"volume": 58439210,"adjClose": 175.43},{"date": "2023-08-31","open": 173.15,"high": 174.25,"low": 172.80,"close": 173.75,"volume": 52387125,"adjClose": 173.75}]
}

3.4 公司基本信息

获取公司概况

接口地址：

GET /us/company

请求参数：

参数必选说明示例值
symbol是股票代码AAPL

响应示例：

{"code": 200,"data": {"symbol": "AAPL","name": "Apple Inc.","description": "全球领先的科技公司，设计、制造和销售智能手机、个人电脑、平板电脑、可穿戴设备和配件...","sector": "Technology","industry": "Consumer Electronics","ceo": "Tim Cook","employees": 164000,"headquarters": "Cupertino, California","website": "https://www.apple.com","ipoDate": "1980-12-12"}
}

3.5 财务数据

获取财务指标

接口地址：

GET /us/financials

请求参数：

参数必选说明示例值
symbol是股票代码AAPL
period否年度/季度annual, quarterly

响应示例：

{"code": 200,"data": {"symbol": "AAPL","financials": {"2023": {"revenue": 383285000000,   // 营收"grossProfit": 169148000000, // 毛利润"netIncome": 96950000000,   // 净利润"eps": 6.11,               // 每股收益"dividend": 0.96            // 每股股息},"2022": {"revenue": 365817000000,"grossProfit": 152836000000,"netIncome": 99803000000,"eps": 6.05,"dividend": 0.92}}}
}

四、高级数据接口

4.1 分时数据

获取当日分时数据

接口地址：

GET /us/intraday

请求参数：

参数必选说明示例值
symbol是股票代码AAPL
interval否时间粒度(1m, 5m)5m

响应示例：

{"code": 200,"data": [{"timestamp": 1725004800000, // 时间戳(毫秒)"price": 174.32,"volume": 125432},{"timestamp": 1725005100000,"price": 174.56,"volume": 143256}]
}

4.2 盘前盘后数据

获取盘前盘后交易数据

接口地址：

GET /us/prepost

请求参数：

参数必选说明示例值
symbol是股票代码AAPL

响应示例：

{"code": 200,"data": {"preMarket": {"lastPrice": 176.20,"change": 0.77,"changePercent": 0.44,"volume": 1254321,"time": "07:45:23"},"postMarket": {"lastPrice": 175.80,"change": 0.37,"changePercent": 0.21,"volume": 876543,"time": "18:32:11"}}
}

4.3 期权数据

获取期权合约信息

接口地址：

GET /us/options

请求参数：

参数必选说明示例值
symbol是股票代码AAPL
expiration否到期日期(YYYYMMDD)20231215

响应示例：

{"code": 200,"data": {"symbol": "AAPL","expirations": ["2023-12-15", "2024-01-19", "2024-03-15"],"options": [{"contractId": "AAPL231215C00175000","strike": 175.00,       // 行权价"lastPrice": 6.45,      // 最后成交价"bid": 6.40,            // 买价"ask": 6.50,            // 卖价"volume": 1245,         // 成交量"openInterest": 5423,   // 未平仓合约"impliedVolatility": 0.35, // 隐含波动率"type": "call"          // 看涨/看跌}]}
}

五、实时数据推送

5.1 WebSocket连接

wss://ws-api.stocktv.top/us?key=YOUR_API_KEY

5.2 订阅消息

{"action": "subscribe","symbols": ["AAPL", "MSFT", "TSLA"]
}

5.3 实时数据格式

{"symbol": "AAPL",       // 股票代码"price": 175.43,        // 最新价"change": 1.68,         // 涨跌额"changePercent": 0.97,  // 涨跌幅%"volume": 58439210,     // 成交量"bid": 175.42,          // 买一价"ask": 175.44,          // 卖一价"bidSize": 125,         // 买一量"askSize": 85,          // 卖一量"timestamp": 1725008213 // 时间戳
}

5.4 心跳机制

客户端需每30秒发送心跳消息：

{"action": "ping"}

六、代码示例

6.1 Python获取股票数据

import requestsdef get_stock_quote(symbol):url = "https://api.stocktv.top/us/quote"params = {"symbol": symbol}headers = {"X-Api-Key": "YOUR_API_KEY","Content-Type": "application/json"}response = requests.get(url, params=params, headers=headers)if response.status_code == 200:data = response.json()if data["code"] == 200:return data["data"]return None# 获取苹果股票数据
aapl = get_stock_quote("AAPL")
if aapl:print(f"{aapl['name']} ({aapl['symbol']})")print(f"价格: ${aapl['price']} ({aapl['changePercent']}%)")print(f"市值: ${aapl['marketCap']/1e9:.2f}B")

6.2 Node.js实时数据订阅

const WebSocket = require('ws');
const ws = new WebSocket('wss://ws-api.stocktv.top/us?key=YOUR_API_KEY');ws.on('open', () => {console.log('Connected to US Stock API');// 订阅股票ws.send(JSON.stringify({action: "subscribe",symbols: ["AAPL", "MSFT", "TSLA"]}));
});ws.on('message', (data) => {const message = JSON.parse(data);if(message.symbol) {const arrow = message.change >= 0 ? '↑' : '↓';console.log(`[${message.symbol}] ${message.price} ${arrow} ${message.changePercent}%`);}
});// 心跳维持
setInterval(() => {ws.send(JSON.stringify({action: "ping"}));
}, 30000);

6.3 Java获取历史数据

import com.fasterxml.jackson.databind.ObjectMapper;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;public class StockHistoryFetcher {private static final String API_KEY = "YOUR_API_KEY";private static final ObjectMapper mapper = new ObjectMapper();public static void main(String[] args) throws Exception {String symbol = "AAPL";String url = "https://api.stocktv.top/us/historical?symbol=" + symbol + "&period=1y";OkHttpClient client = new OkHttpClient();Request request = new Request.Builder().url(url).addHeader("X-Api-Key", API_KEY).build();try (Response response = client.newCall(request).execute()) {if (response.isSuccessful()) {String json = response.body().string();JsonNode root = mapper.readTree(json);if (root.path("code").asInt() == 200) {JsonNode data = root.path("data");System.out.println("AAPL Historical Data:");data.forEach(day -> {System.out.printf("%s: Open=%.2f, Close=%.2f, Volume=%d%n",day.path("date").asText(),day.path("open").asDouble(),day.path("close").asDouble(),day.path("volume").asLong());});}}}}
}

七、最佳实践

7.1 数据缓存策略

from cachetools import TTLCache
import timeclass StockDataCache:def __init__(self, maxsize=100, ttl=60):self.cache = TTLCache(maxsize=maxsize, ttl=ttl)def get_quote(self, symbol):if symbol in self.cache:return self.cache[symbol]# 从API获取quote = api_get_quote(symbol)  # 实际API调用函数if quote:self.cache[symbol] = quotereturn quote# 使用示例
cache = StockDataCache()
aapl = cache.get_quote("AAPL")

7.2 批量请求优化

async function fetchBatchQuotes(symbols, batchSize=10) {const results = {};for (let i = 0; i < symbols.length; i += batchSize) {const batch = symbols.slice(i, i + batchSize);const response = await fetch('https://api.stocktv.top/us/batch-quotes', {method: 'POST',headers: {'X-Api-Key': API_KEY,'Content-Type': 'application/json'},body: JSON.stringify({ symbols: batch })});const data = await response.json();if (data.code === 200) {Object.assign(results, data.data);}// 避免请求过快await new Promise(resolve => setTimeout(resolve, 300));}return results;
}

7.3 实时数据批处理

class RealTimeProcessor:def __init__(self, batch_size=10, batch_interval=0.5):self.buffer = {}self.batch_size = batch_sizeself.batch_interval = batch_intervalself.last_process_time = time.time()def add_update(self, symbol, data):if symbol not in self.buffer:self.buffer[symbol] = []self.buffer[symbol].append(data)# 检查是否处理批次current_time = time.time()if (len(self.buffer[symbol]) >= self.batch_size or current_time - self.last_process_time >= self.batch_interval):self.process_batch(symbol)self.last_process_time = current_timedef process_batch(self, symbol):data_points = self.buffer.get(symbol, [])if not data_points:return# 计算平均价格、总成交量等prices = [d['price'] for d in data_points]avg_price = sum(prices) / len(prices)total_volume = sum(d['volume'] for d in data_points)print(f"{symbol} 批次统计: {len(data_points)}次更新")print(f"平均价格: {avg_price:.2f}, 总成交量: {total_volume}")# 清空缓冲区self.buffer[symbol] = []

7.4 错误处理与重试

public JsonNode fetchWithRetry(String url, int maxRetries) {int retries = 0;while (retries < maxRetries) {try {Request request = new Request.Builder().url(url).addHeader("X-Api-Key", API_KEY).build();try (Response response = client.newCall(request).execute()) {if (response.isSuccessful()) {return mapper.readTree(response.body().string());} else if (response.code() == 429) {// 请求过多，等待后重试int waitTime = 30; // 默认等待30秒String retryAfter = response.header("Retry-After");if (retryAfter != null) {waitTime = Integer.parseInt(retryAfter);}Thread.sleep(waitTime * 1000);}}} catch (Exception e) {// 记录错误}retries++;}return null; // 达到最大重试次数
}

八、数据字典

8.1 美股主要指数

代码指数名称包含公司
.DJI道琼斯工业平均指数30家大型企业
.IXIC纳斯达克综合指数所有纳斯达克上市公司
.INX标普500指数500家大型公司
.RUT罗素2000指数2000家小型公司

8.2 交易时间

交易时段美东时间北京时间
盘前交易04:00-09:3016:00-21:30
常规交易09:30-16:0021:30-04:00(+1)
盘后交易16:00-20:0004:00-08:00(+1)

十、附录

10.1 常见问题解答

Q: 如何获取历史分时数据？
A: 使用/us/intraday接口，设置interval参数为1m

Q: 是否支持分页？
A: 对于列表接口（如历史数据），使用page和size参数控制数据范围

10.2 错误代码表

错误码含义解决方案
400请求参数错误检查请求参数
401未授权检查API Key
404资源不存在检查请求路径
429请求过于频繁降低请求频率
500服务器错误联系技术支持

本文档版本：v3.0.1
最后更新：2025年9月5日
下载PDF版本：https://stocktv.top/
示例代码库：https://github.com/cryptorzz/


文章转载自：

http://PLztzmJk.Lxjcr.cn
http://Ee9eFd0K.Lxjcr.cn
http://QzYgl0Ij.Lxjcr.cn
http://WqQhHnaw.Lxjcr.cn
http://2MzGY2FO.Lxjcr.cn
http://dKtOJwbn.Lxjcr.cn
http://gYA4vasd.Lxjcr.cn
http://lmVJUbpF.Lxjcr.cn
http://LrW17IAC.Lxjcr.cn
http://GxV08EhE.Lxjcr.cn
http://RKeXLoZc.Lxjcr.cn
http://m0q4x4CH.Lxjcr.cn
http://dMzaPLpc.Lxjcr.cn
http://ZH62P1nW.Lxjcr.cn
http://9MkltEva.Lxjcr.cn
http://A8n1ebPm.Lxjcr.cn
http://ZDrK3obU.Lxjcr.cn
http://ni3htlqh.Lxjcr.cn
http://SfflpjwW.Lxjcr.cn
http://vhOY2YRy.Lxjcr.cn
http://CStzMFFD.Lxjcr.cn
http://rMfOoEh3.Lxjcr.cn
http://vD6afcop.Lxjcr.cn
http://UgNZpTx7.Lxjcr.cn
http://wpoCuYMP.Lxjcr.cn
http://8hLznVqb.Lxjcr.cn
http://eqisMq66.Lxjcr.cn
http://UOgTX1Sb.Lxjcr.cn
http://A29vnxJR.Lxjcr.cn
http://dFUmmffm.Lxjcr.cn
http://www.dtcms.com/a/372071.html

相关文章：

  • Coze源码分析-资源库-删除插件-前端源码-核心接口与工具
  • 【深度学习】重采样（Resampling）
  • http接口幂等性
  • 无重复字符的最长子串
  • 架构思维：架构师视角的 FullGC 治理
  • pytest（1）：fixture从入门到精通
  • Logstash中http_poller插件的用法
  • 软考中级习题与解答——第三章_操作系统（1）
  • 基于Python的智能工程资料自动生成模型设计与实现
  • 硬件：传感器（DS18B20）
  • muduo库搭建客户端
  • smpp3.4 协议
  • 阿里云高可用生产环境网络架构实战：VPC规划与多可用区部署
  • 中国移动中兴云电脑W132D-RK3528-2+32G-刷机固件包（非原机制作）
  • 疯狂星期四文案网第63天运营日记
  • 【PCIe EP 设备入门学习专栏 -- 8.2 PCIe EP 寄存器配置空间介绍】
  • Android开发-按钮触控
  • RocketMQ分布式消息中间件的核心原理与应用
  • MySQL 之 InnoDB 存储架构解析
  • 【LeetCode - 每日1题】构造和为0的n个不同整数数组
  • 使用MobaXterm连接Ubuntu时connection refused解决方法
  • Windows 内存整理和优化工具 - Wise Memory Optimize
  • VuePress 与 VitePress 深度对比：特性、差异与选型指南
  • Dockerfile文件常用配置详解
  • Logstash常用插件-ES集群加密
  • NT路径指的是什么？
  • AutoHotkey将脚本编译为exe文件
  • 【Java笔记】单例模式
  • 腕部骨折X光检测识别数据集：2w+图像，6类，yolo标注
  • 当没办法实现从win复制东西到Linux虚拟机时的解决办法