DataBull

DataBull API 文档

DataBull 是面向开发者、量化研究和 AI Agent 的中国 A 股与 ETF 数据服务。 通过统一的 REST API、官方 Python SDK 或云端 MCP Server，可以查询沪深 A 股、ETF、指数及相关行情、财务与资金数据；证券代码统一使用 symbol 参数。

基础地址: https://databull.cn 版本: v2 格式: JSON

数据能力概览

以下是最常用的数据范围；每项都可从对应接口页查看请求参数、返回字段和调用示例。

数据范围 主要能力 查看文档
A 股基础与行情 股票列表、交易日历、日线与实时行情、复权因子、每日指标和技术因子 股票列表 · 日线行情
ETF 数据 ETF 基础资料、跟踪指数、日行情、复权因子、净值、份额规模、持仓与申赎篮子 ETF 基础资料 · ETF 日行情
财务与公司数据 财务指标、三大财务报表、业绩预告与快报、分红、股东和主营构成 财务指标 · 利润表
资金与市场行为 个股资金流、沪深港通、融资融券、大宗交易、龙虎榜、涨跌停与筹码分布 个股资金流 · 沪深港通
指数与分类 指数行情与权重、申万行业、概念板块及成分股 指数日线 · 概念板块

如何调用 DataBull

REST API 使用 X-API-Key 请求头调用 v2 接口，返回 JSON。 查看快速上手
Python SDK 安装 databull，以 pandas DataFrame 读取数据。 安装与示例
MCP Server 把云端 MCP 地址加入支持的客户端，让 AI Agent 直接调用数据工具。 连接 MCP

所有 v2 日期参数统一使用不带分隔符的 YYYYMMDD，例如 20260815；直接调用 v2 REST 时， 2026-08-15 属于无效格式。

接口升级公告

我们近期完成了 v2 版本接口 的重大升级：全面提升了 数据质量、接口稳定性 与 数据获取逻辑，并对 LLM 阅读的文档 提供了更全面的支持。 v1 版本仍正常提供服务。欢迎将 SDK 升级至 0.8.0 及以后版本，体验我们的最新接口。

如有问题，欢迎联系 support@databull.cn

快速上手

第一步：在 databull.cn/console/register 注册免费账号

第二步：在 控制台 创建 API Key

第三步：发起你的第一个请求：

cURL
curl -H "X-API-Key: ash_your_key_here" \
  "https://databull.cn/v2/market/daily?symbol=000001.SZ"
Python SDK
pip install databull

from databull import DataBull
client = DataBull(api_key="ash_your_key_here")
df = client.market_daily(symbol="000001.SZ")
print(df)

认证方式

所有数据接口需要通过 X-API-Key 请求头传递 API Key 进行认证。 

curl -H "X-API-Key: ash_your_key_here" https://databull.cn/v2/market/daily
⚠️ 请妥善保管你的 API Key，不要在客户端代码或公开仓库中暴露。

速率限制

每个 API Key 按天计算请求次数。超出限制时返回 429 Too Many Requests。

套餐 价格 每日限额
Free $0 100 次
Pro $19.9/月 $29.9 限时 10,000 次
Business $39.9/月 $69.9 限时 50,000 次