OpenBB 开放数据平台

由 openbq-org 制作工具包财务

新上架第 2 版 · 更新于 2026-11-09

星标75.2k

OpenBB 免费开源的 Open Data Platform：把金融和经济数据接一次，就能在 Python、命令行、REST API、OpenBB Workspace 和给 AI 智能体用的 MCP 服务器里使用。安装说明逐条讲解每条途径。

OpenBB 开放数据平台是一款 GitHub 上的开源项目，属于财务类，由 Mindket 上架。可免费获取。当前为第 2 版，最近更新于 2026-11-09。按它的 README 从 GitHub 安装。Mindket 的设置说明可在你的 Mindket 账户获取，以 zip 压缩包下载。

速览

用在

Python：pip install openbb 之后用 obb 对象
命令行：openbb 命令，可以执行单条命令、批处理或交互式 REPL
ODP Desktop：适用于 Windows 和 macOS 的应用，管理 Python 环境和后端服务
REST API：openbb-api 把每条已安装的命令通过 HTTP 提供出来

先运行

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip

平台

Windows操作系统

macOS操作系统

Claude Desktop桌面应用

Cursor代码编辑器

VS Code代码编辑器

关于

它是什么

Open Data Platform by OpenBB，简称 ODP，是一套开源工具，把数据源接一次，就能让很多工具来读。README 说它帮数据工程师把自有、授权和公开的数据接入 AI 副驾驶、研究仪表板这类下游应用。装好的同一套命令可以在 Python 里调用，也可以作为 REST API、MCP 工具和 OpenBB Workspace 小组件使用。README 还把 Excel 列为分析师的使用界面。它有 Python 包、命令行和桌面应用三种形式。

你安装 openbb 包，或只装几个数据源包
每个数据源包带来一个数据源和它自己的命名空间
装好的命令成为同一套数据调用
Python、REST、MCP 工具和 Workspace 小组件都用它

适合谁

用 Python 工作的量化研究员，想在 OpenBB Workspace 里用同样数据的分析师，以及想通过 MCP 给 AI 智能体提供市场和经济数据的开发者。想要一个现成的交易产品，就别选它。README 自己的免责声明说，数据不一定准确，交易金融工具风险很高。

谁在用，怎么用

行业	谁在用	怎么用	例子
量化研究	量化研究员和数据科学家	在 Python 里调用数据源的数据，拿回 pandas DataFrame	一位量化研究员取 2015 年起的 FRED 序列 GDP，再对结果调用 to_dataframe()。
分析师团队	使用 OpenBB Workspace 的分析师	用 openbb-api 提供装好的命令，再把这个服务连成后端	一位分析师启动 openbb-api，在 Workspace 里添加 http://127.0.0.1:6900，每条命令都成了一个小组件。
AI 智能体开发	给智能体提供数据的开发者	运行 openbb-mcp，让智能体把命令当工具来调用	一位开发者把 openbb-mcp 加进 Claude Desktop，让智能体查 Cboe 的苹果报价。
数据工程	给其他应用供数的工程师	在公开和授权数据源前放一个 REST API	一位工程师在服务器上用 openbb-api --host 0.0.0.0 --port 6900 启动服务并设好 Basic 登录，另一个服务调用 /api/v1/cboe/equity/quote。

用在哪里

OpenBB 的文档写了下面这些途径，这个条目给每一条都配了一页说明。

Python：pip install openbb 之后用 obb 对象
命令行：openbb 命令，可以执行单条命令、批处理或交互式 REPL
ODP Desktop：适用于 Windows 和 macOS 的应用，管理 Python 环境和后端服务
REST API：openbb-api 把每条已安装的命令通过 HTTP 提供出来
OpenBB Workspace：把运行中的 REST API 连成后端
MCP：openbb-mcp 把命令作为工具提供给 Claude Desktop、Cursor 和 VS Code

能接入的数据源

领域	数据源	密钥
市场和期权	Cboe、Nasdaq、FINRA、TMX（非官方）和提供加密货币衍生品数据的 Deribit	不需要
经济和统计	FRED、IMF、OECD、ECB、BLS 和美联储	FRED 需要免费密钥，BLS 的密钥可选
政府和能源	美国财政部、USDA、Congress.gov、EIA、JODI 和 CFTC	EIA 需要免费密钥，CFTC 和 Congress.gov 的密钥可选
申报文件和研究	SEC EDGAR 和 Kenneth French 数据库	不需要

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹，上面每条途径各有一页。主要途径是 pip，在虚拟环境里运行。

先准备好这些

需要	说明
Python	3.10 或更高，低于 4。README 说 Workspace 这条途径用 3.11 到 3.14。建议用虚拟环境
数据源密钥	只有部分数据源需要。调用 API 的 FRED 和 EIA 命令要一个免费密钥。Cboe、Deribit、FINRA、Nasdaq 和 SEC 不需要
uv	用于 Claude Desktop 这条途径，它用 uvx 启动服务，也用于从源码安装，安装步骤里用 pip 装上 uv
Workspace 登录	只有把服务连到 pro.openbb.co 上的 OpenBB Workspace 时才需要
ODP Desktop	只有用桌面应用才需要：Windows 11 或 macOS 10.15 以上，8 GB 内存，2 GB 以上可用存储空间，以及网络连接

新建一个虚拟环境并激活它。
安装 openbb 包。
对一个不需要密钥的数据源发出第一次调用。

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install openbb

在 Windows 上，用 .venv\Scripts\activate 激活。

如何使用

导入 obb，再调用一条命令。每个数据源的命令都在它自己的命名空间下，所以数据源是路径的一部分。第一次调用用的是不需要密钥的 Cboe。

from openbb import obb

quote = obb.cboe.equity.quote(symbol="AAPL", provider="cboe")
quote.to_dataframe()

想用 HTTP 提供同样的命令，就安装启动器再启动它。它监听 127.0.0.1:6900，这个端口被占用时会换到下一个空闲端口。

pip install openbb-platform-api openbb-cboe
openbb-api

路由和 Python 路径一一对应，关键字参数变成查询参数。

curl "http://127.0.0.1:6900/api/v1/cboe/equity/quote?symbol=AAPL&provider=cboe"

示例

你想让 Claude Desktop 回答一个关于苹果报价的问题。装好 uv 之后，把下面这段加进它的配置，再重启它。

{
  "mcpServers": {
    "openbb-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "openbb-mcp-server",
        "--with",
        "openbb-cboe",
        "--with",
        "openbb-imf",
        "openbb-mcp",
        "--transport",
        "stdio"
      ]
    }
  }
}

让它查苹果的报价。对应的工具是 cboe_equity_quote，文档按路由 /api/v1/cboe/equity/quote 给它命名。文档说每个已安装的数据源都会提供自己的命令，所以这个配置提供的是 Cboe 和 IMF 的命令。

新手与专家

新手：数据源包是通向一个数据源的连接器，比如 Cboe 或 FRED 经济数据库。OpenBB 不托管也不提供数据。数据源包连接的是公开或第三方服务，覆盖范围、速率限制和使用条款由那些服务决定。先从 Python 这条途径和一个不需要密钥的数据源开始，想要经济数据序列时，再为 FRED 加一个密钥。

专家：任何注册在 openbb_core_extension 入口点组下的 FastAPI 路由，都会成为一个扩展。REST API 提供它的路由，Python 接口在 openbb-build 之后或下一次导入时，把它们生成为 obb 上的方法。openbb-mcp 按路由路径给每个工具命名，所以 obb.cboe.equity.quote 就是 cboe_equity_quote。装得很多时，有一个参数可以把命令工具藏到四个工具后面，这四个工具是 available_categories、available_tools、search_tools 和 call_tool。

openbb-mcp --tool-discovery

工具 run_pipeline 在服务器上把几个工具串起来，所以价格历史不用经过对话来回传。用 openbb --generate-spec 生成的 .spec 文件，可以让 openbb-api 或 openbb-mcp 代理一个远程服务器，本机不用装任何数据源包。

注意事项

这个条目的说明依据 V5 文档。下面是可能让你意外的几点。

版本 5：V5 把命令从 obb.equity 这样的共享路由器，挪到了 obb.cboe 这样的数据源命名空间，移除了十五个 V4 数据源包，并把许可证从 AGPL-3.0 改成了 Apache-2.0。README 自己的例子仍然用 V4 的调用 obb.equity.price.historical，视频里也可能出现 V4 的命令
数据：OpenBB 不托管也不提供数据。数据源包连接的是公开或第三方服务，它们的条款可能限制存储、再分发或商业使用。许可证管的是软件，不是数据
准确性：README 说数据不一定准确，OpenBB 和它的数据提供方对交易损失或因依赖这些数据造成的损失不承担责任
默认开放：在你设置 Basic 登录和 CORS 列表之前，REST API 接受所有请求和所有来源。MCP 服务器的 install_skill 工具会替任何已连接的客户端往服务器磁盘写文件，客户端不可信时要开启 server_auth
桌面应用：它会安装 Miniforge 和环境，运行后台任务和 shell 脚本，还可以开机启动。它的卸载会连同应用数据一起把这些删掉。文档说它不适合在虚拟机或 CI 里运行
OpenBB Workspace：pro.openbb.co 上另一个需要登录的商业版 OpenBB 应用。OpenBB 的网站说它的社区版对个人免费。同一个网站还说，非营利组织 OpenBQ 正在接手 OpenBB 的资产，托管产品的用户会收到时间安排的通知。这些说明讲的是把你自己的服务连到它，不讲这个应用本身
Excel：README 在 Workspace 旁边提到了 Excel。这个工具包没有 Excel 的步骤
使用数据：README 和这里用到的页面都没有提到
移除：安装页说要用 pip 添加或移除数据源包，数据源页说移除一个之后要运行 openbb-build 或重启 Python 会话。没有哪一页给出能全部移除的命令。用 pip 卸载你装过的包，再删掉虚拟环境。设置和密钥留在 ~/.openbb_platform/ 里（user_settings.json、mcp_settings.json），openbb-sec 还在 ~/OpenBBUserData/cache/sec 里留有磁盘缓存（默认最大 8 GB），所以这些文件夹也要删掉
许可证：Apache-2.0。GitHub 的 API 把许可证列为“Other”，但 LICENSE 文件给出了完整的 Apache 2.0 文本，写的是“Copyright (c) 2021-2026 OpenBB Inc.”。许可证不授予 OpenBB 商标的任何权利

README 和文件

README

OpenBB：安装说明

这个工具包里只有安装说明，由 Mindket 编写。这个平台从 PyPI 安装，也可以从仓库安装：https://github.com/openbq-org/OpenBB

这些说明不是 OpenBB 写的，也没有得到它的认可。README 说 "Open Data Platform by OpenBB (ODP) is the open-source toolset that helps data engineers integrate proprietary, licensed, and public data sources into downstream applications like AI copilots and research dashboards."，意思是：ODP 是一套开源工具，帮数据工程师把自有、授权和公开的数据源接入 AI 副驾驶、研究仪表板这类下游应用。文档在 https://docs.openbb.co/odp

README 自己的链接和克隆命令写的是 OpenBB-finance/OpenBB，不是 openbq-org/OpenBB。这些说明照原样抄下来。

许可证：Apache-2.0。LICENSE 文件（https://github.com/openbq-org/OpenBB/blob/develop/LICENSE）开头写着 "Copyright (c) 2021-2026 OpenBB Inc." 和 "All files in this repository are licensed under the Apache License, Version 2.0."，后面是标准文本。许可证常见问题页（https://docs.openbb.co/odp/python/faqs/license）说，V4 及更早版本是 AGPL-3.0-only，V5 是 Apache-2.0，许可证管的是软件，不是数据源返回的数据，也不授予 OpenBB 商标的任何权利。

README 的免责声明说："Trading in financial instruments involves high risks including the risk of losing some, or all, of your investment amount, and may not be suitable for all investors."，意思是：交易金融工具风险很高，可能损失部分或全部投资，不一定适合所有投资者。它还说："The data contained in the Open Data Platform is not necessarily accurate."，意思是：Open Data Platform 里的数据不一定准确。

会安装什么

PyPI 上的 openbb 包。安装页（https://docs.openbb.co/odp/python/installation）说它自己不含代码。它会装上 openbb-core、所有数据源包、openbb-news、带 PyWry 的 openbb-charting、openbb-cli、openbb-platform-api、openbb-mcp-server 和 openbb-devtools。它不会装 openbb-econometrics、openbb-quantitative 和 openbb-technical。
或者只装 openbb-core，再加你挑的数据源包。每个数据源包会在 obb 上添加它自己的命名空间，比如 obb.fred 或 obb.cboe。来源见 https://docs.openbb.co/odp/python/installation
openbb 这个 Python 导入包，是根据装了什么在第一次导入时或用 openbb-build 生成的。来源见 https://docs.openbb.co/odp/python/installation
OpenBB 不托管也不提供数据。数据源页说，数据源包连接的是公开或第三方服务，覆盖范围、速率限制和使用条款由那些服务决定。来源见 https://docs.openbb.co/odp/python/extensions/providers

事先需要准备

Python。安装页说每个 V5 包都声明了 requires-python = ">=3.10,<4"，并说要装进虚拟环境。README 说 Workspace 这条途径用 Python 3.11 到 3.14。
部分数据源需要 API 密钥。凭据页（https://docs.openbb.co/odp/python/user-guide/credentials）列了五个：bls_api_key、cftc_app_token、congress_gov_api_key、eia_api_key 和 fred_api_key。cboe、deribit、finra、nasdaq 和 sec 这类数据源不需要设置。你自己的密钥放在你自己的设置文件或环境变量里，不要放进这个工具包。
桌面应用需要 Windows 11 或 macOS 10.15 以上、8 GB 内存、2 GB 以上可用存储空间和网络连接。来源见 https://docs.openbb.co/odp/desktop/installation
OpenBB Workspace 需要在 https://pro.openbb.co 登录。

主安装命令

在已激活的虚拟环境里运行。

pip install openbb

来源见 README，https://github.com/openbq-org/OpenBB/blob/develop/README.md ，以及 https://docs.openbb.co/odp/python/installation

各途径说明

setup/python.md：安装、第一次调用、API 密钥、构建，以及从源码安装
setup/cli.md：openbb 命令
setup/desktop.md：适用于 Windows 和 macOS 的 ODP Desktop
setup/rest-api-and-workspace.md：REST API，以及把它连到 OpenBB Workspace
setup/claude-desktop.md：Claude Desktop 里的 MCP 服务器
setup/cursor.md：Cursor 里的 MCP 服务器
setup/vs-code.md：VS Code 和 Cline 里的 MCP 服务器
setup/other-agents.md：其他 MCP 客户端、工具发现、技能和服务器登录

V4 和 V5

这些说明用到的文档页讲的是 V5，安装页说它在仓库的默认分支 develop 上。文档把 V4 放在另一个路径下。迁移页（https://docs.openbb.co/odp/python/migration-from-v4）列出了改动。其中一项在 README 里就能看到：它的例子调用 obb.equity.price.historical，而迁移页把 V4 的调用 obb.equity.price.historical(..., provider="cboe") 对应到 V5 的 obb.cboe.equity.historical(...)。openbb-equity 这样的共享路由器不在普通的 openbb 安装里。来源见 https://docs.openbb.co/odp/python/installation

更新或移除

安装页说，之后可以用 pip 添加或移除数据源包，Python 接口会在下一次导入时发现变化。它没有给整个平台的升级或卸载命令。对你装过的包，用 pip 自己的升级和卸载。如果你装的是 V4，安装页说要把 V5 装进一个新的虚拟环境，不要在 V4 的环境里升级。

装好或移除某个包之后运行下面这条，让 obb 客户端重新生成。来源见 https://docs.openbb.co/odp/python/extensions/providers

openbb-build

对于 ODP Desktop，卸载页（https://docs.openbb.co/odp/desktop/uninstall）说要在托盘图标菜单里选 Uninstall。它会移除 Miniforge、环境和所有应用数据，如果你同意，还会移除 OpenBBUserData 和 openbb_platform 文件夹。在 Windows 上，uninstall.exe 或控制面板只会移除界面。

凭据和数据

密钥放在 ~/.openbb_platform/user_settings.json 里，或者放在以凭据名大写命名的环境变量里。两处都有值时，设置文件优先。来源见 https://docs.openbb.co/odp/python/user-guide/credentials

使用数据

README 和这些说明用到的文档页都没有提到使用数据。

来源

README：https://github.com/openbq-org/OpenBB/blob/develop/README.md
LICENSE：https://github.com/openbq-org/OpenBB/blob/develop/LICENSE
概览：https://docs.openbb.co/odp
安装：https://docs.openbb.co/odp/python/installation
数据源：https://docs.openbb.co/odp/python/extensions/providers
凭据：https://docs.openbb.co/odp/python/user-guide/credentials
从 V4 迁移：https://docs.openbb.co/odp/python/migration-from-v4
许可证常见问题：https://docs.openbb.co/odp/python/faqs/license
CLI 安装：https://docs.openbb.co/odp/cli/installation
CLI 快速入门：https://docs.openbb.co/odp/cli/quickstart
桌面应用：https://docs.openbb.co/odp/desktop
REST API 快速入门：https://docs.openbb.co/odp/python/quickstart/rest-api
Workspace 快速入门：https://docs.openbb.co/odp/python/quickstart/workspace
MCP 快速入门：https://docs.openbb.co/odp/python/quickstart/mcp
openbb-mcp 参考：https://docs.openbb.co/odp/python/extensions/interface/openbb-mcp
OpenBB 网站，用于 Workspace 和 OpenBQ 的说明：https://openbb.co

文件

README.md  7 KB
setup/claude-desktop.md  3 KB
setup/cli.md  4 KB
setup/cursor.md  2 KB
setup/desktop.md  4 KB
setup/other-agents.md  4 KB
setup/python.md  6 KB
setup/rest-api-and-workspace.md  6 KB
setup/vs-code.md  2 KB

9 个文件，共 38 KB，以 zip 压缩包下载。