在全球投资版图中，德国作为欧洲最大的经济体，其法兰克福证券交易所（Frankfurt Stock Exchange）汇聚了 SAP、西门子、大众等工业与技术巨头。对于开发者而言，获取低延迟、高精度的德国股票数据是切入欧洲市场的首要任务。
本文将详细介绍如何使用 StockTV API，通过指定 countryId=17 快速接入德国股市的实时行情、K线及指数数据。
一、 德国市场接入核心参数
在 StockTV 全球数据体系中，德国市场的接入非常标准化：
- 国家 ID (
countryId):17 - 主要指数: DAX（德国核心 40 指数）
- 认证方式: 通过 URL 参数
key=您的密钥进行鉴权。 - 接入协议: 支持 RESTful HTTP 和 WebSocket (WS) 双重模式。
二、 德国股票核心接口指南
1. 德国股票市场列表（实时全览）
通过此接口，您可以分页获取德国市场所有上市公司的最新价格、涨跌幅及成交信息。
- 接口地址:
https://api.stocktv.top/stock/stocks - 请求示例:
?countryId=17&pageSize=20&page=1&key=YOUR_KEY - 实时性体现: 返回数据包含
last（最新价）和time（毫秒级时间戳），确保数据新鲜度。
2. DAX 指数及德国主要大盘指数
监控德国整体市场走势，DAX 指数是核心。
- 接口地址:
https://api.stocktv.top/stock/indices - 请求参数:
countryId=17&key=YOUR_KEY - 应用场景: 实时展示法兰克福综指、DAX 40 指数等，作为市场情绪的晴雨表。
3. 德股实时 K 线图表
提供覆盖分钟级到月级的 K 线数据，支持毫秒级更新。
- 接口地址:
https://api.stocktv.top/stock/kline - 参数配置:
pid={产品ID}&interval=PT15M（获取德国某只股票的 15 分钟 K 线）。 - 时间间隔: 支持
PT1M（1分）、PT1H（1时）、P1D（天）等。
4. 德国股市涨跌排行榜（异动监控）
实时锁定德国市场的领涨股和领跌股，捕捉市场热点。
- 接口地址:
https://api.stocktv.top/stock/updownList - 参数:
countryId=17&type=1（type=1为涨幅榜，type=2为跌幅榜）。
三、 极致实时性方案：从 HTTP 到 WebSocket
对于对速度有极致要求的量化系统或交易终端，StockTV 提供了更强大的推送能力：
- WebSocket (WS) 推送: 相比 HTTP 轮询，WS 能够实现在价格变动的毫秒级瞬间将增量数据推送至您的服务器。
- 多路聚合: 您可以通过
stocksByPids接口一次性获取多个德国权重股的实时报价，减少网络往返延迟。 - 全球机房优化: 数据源直连欧洲核心交换机，通过 StockTV 全球分发节点，确保即使在亚洲或美洲也能获得极速响应。
四、 代码实战：Python 获取德国龙头股行情
以下代码展示了如何获取德国软件巨头 SAP 的实时行情：
import requests
def get_german_stock_quote(symbol="SAP"):
# 通过查询接口获取特定股票实时信息
url = "https://api.stocktv.top/stock/queryStocks"
params = {
"symbol": symbol,
"key": "YOUR_API_KEY" # 替换为您获取的真实Key
}
try:
response = requests.get(url, params=params)
res_data = response.json()
if res_data['code'] == 200 and res_data['data']:
stock = res_data['data'][0]
print(f"--- 德国股票实时行情 ---")
print(f"名称: {stock['name']}")
print(f"最新价: {stock['last']} EUR")
print(f"涨跌幅: {stock['chgPct']}%")
print(f"更新时间: {stock['time']}")
else:
print(f"查询失败: {res_data.get('message')}")
except Exception as e:
print(f"请求异常: {e}")
get_german_stock_quote()
五、 结语
对接德国股票市场不仅是获取数据，更是获取欧洲经济的脉搏。StockTV API 以其极简的集成难度和卓越的实时性能，为您的金融产品提供了强有力的支持。
