DataBull API 文档

本页所有接口均以下表中的真实地址为准，参数、必填与默认值与本服务的 OpenAPI 描述保持一致。接口清单由 OpenAPI 自动生成，不会出现文档与实现不一致的情况。

接口索引

如何调用

日期参数的格式按接口而异：指数历史行情、个股/ETF/美股/港股历史行情使用 YYYYMMDD；财务数据、恐惧与贪婪指数使用 YYYY-MM-DD；新闻接口（含旧版）的时间参数为 ISO 8601。每个接口页的参数表都标注了其自身格式。

快速上手

curl "https://api.databull.cn/cn/stocks" -H "Authorization: Bearer $DATABULL_API_KEY"

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get("https://api.databull.cn/cn/stocks", headers=headers, timeout=10)
stocks = resp.json()["data"]
print(len(stocks), stocks[0])

认证方式

全部数据接口都必须携带 API 密钥，不带或密钥无效会返回 401。密钥在控制台「API Token」页面自助创建，明文只显示一次，请立即保存。

两种等价的携带方式，任选其一：

Authorization: Bearer dbt_xxxxxxxx
X-API-Key: dbt_xxxxxxxx

Python SDK 会自动带上该请求头，只要在初始化时传入密钥：DataBull(api_key="...")。密钥可设置有效期，也可在控制台随时吊销；吊销后立即失效。

调用限额与缓存

调用次数按账号 + 自然日计（同一账号的多个密钥共享一份额度），额度大小取决于所选套餐，见定价页。超出后返回 429，响应头 Retry-After 给出到次日零点的秒数。每次成功响应都带 X-RateLimit-Limit 与 X-RateLimit-Remaining，便于自查余量。

部分接口另带服务端结果缓存（个股基本信息、公司简介、A 股历史行情为 1 小时），命中缓存同样计入调用次数。批量拉取时请控制并发，避免对上游行情源造成压力。

可访问的市场范围

接口按市场分为 A 股、港股、美股。默认免费版仅覆盖 A 股，港股、美股需付费套餐；越权请求返回 403，且不计入当日调用次数。各市场对应的套餐见定价页；越权响应的响应体会给出当前套餐 (plan_key)、请求的市场 (scope) 与允许的市场 (allowed_scopes)。