from openbb import obb

# 获取股票数据，返回 Standard DataFrame
result = obb.equity.price.historical("AAPL")
print(result.data)  # Pandas DataFrame

# 获取期权链
options = obb.options.chains("AAPL")
print(options.data)

{
  "polygon": {
    "api_key": "YOUR_POLYGON_API_KEY"
  },
  "fmp": {
    "api_key": "YOUR_FMP_API_KEY"
  }
}

from openbb import obb

# 股票数据
stocks = obb.equity.price.historical(
    symbol="AAPL",
    start_date="2024-01-01",
    end_date="2024-12-31"
)
df = stocks.to_dataframe()

# 期权数据
options = obb.options.chains("AAPL")
puts = options.data[options.data.type == "put"]

# 加密货币
crypto = obb.crypto.price.historical("BTC")
btc_usd = crypto.to_dataframe()

# 经济指标
gdp = obb.economy.gdp(country="USA")

# 安装
pip install openbb-cli

# 启动 CLI
obb

# 常用命令
obb stocks AAPL            # 查看股票
obb options AAPL           # 查看期权
obb crypto BTC             # 查看加密货币
obb economy gdp            # 查看 GDP
obb forecast aapl          # AI 预测

# 启动 MCP Server
openbb-mcp

# 配置 Claude Desktop
# ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "openbb": {
      "command": "openbb-mcp"
    }
  }
}

# 启动 API Server
openbb-api

# 访问 http://127.0.0.1:6900

# REST 调用
curl http://127.0.0.1:6900/api/v1/equity/price?symbol=AAPL

# 基础安装
pip install openbb

# 完整安装（含所有 Provider）
pip install "openbb[all]"

# CLI 单独安装
pip install openbb-cli

# 克隆代码仓库
git clone https://github.com/OpenBB-finance/OpenBB.git
cd OpenBB

# 安装
pip install -e openbb_platform
pip install -e cli

# 拉取镜像
docker pull openbb/openbb-platform

# 运行容器
docker run -p 6900:6900 openbb/openbb-platform

pip install openbb

from openbb import obb

# 获取苹果公司股票数据
result = obb.equity.price.historical("AAPL")
print(result.to_dataframe())

openbb-api
# 访问 http://127.0.0.1:6900/docs

# 方式一：环境变量
export OPENBB_POLYGON_API_KEY="your_key"

# 方式二：配置文件
# ~/.openbb_provider.json
{
  "polygon": {
    "api_key": "your_key"
  }
}

# 启动本地 Backend
openbb-api

# 在 Workspace 中添加 Backend
# Settings → Connect Backend → http://127.0.0.1:6900

# openbb_platform/openbb/my_provider/
from openbb.core.provider import Provider
from openbb.core.model import Model
from pydantic import BaseModel

class MyProviderModels(BaseModel):
    stock_data: pd.DataFrame

class MyProvider(Provider):
    name = "my_provider"
    
    @staticmethod
    def get_stock_data(symbol: str) -> pd.DataFrame:
        # 实现数据获取逻辑
        response = requests.get(f"https://api.myprovider.com/{symbol}")
        return pd.DataFrame(response.json())

# 安装 Cookiecutter
pip install cookiecutter

# 创建扩展模板
cookiecutter gh:OpenBB-finance/openbb-cookiecutter

# 填写信息
# project_name: openbb-mystocks
# provider_name: mystocks
# description: My custom stock data provider

from openbb import obb
from agent import Agent

class FinanceAgent(Agent):
    def __init__(self):
        super().__init__()
        self.openbb = obb
    
    def handle_price_query(self, symbol: str) -> str:
        data = self.openbb.equity.price.historical(symbol)
        return f"{symbol} 最新价格: ${data['close'].iloc[-1]:.2f}"
    
    def handle_options_query(self, symbol: str) -> str:
        chains = self.openbb.options.chains(symbol)
        # 处理期权查询
        return formatted_chains

# docker-compose.yml
version: '3.8'
services:
  openbb-api:
    image: openbb/openbb-platform
    container_name: openbb-api
    ports:
      - "6900:6900"
    environment:
      - OPENBB_POLYGON_API_KEY=${POLYGON_API_KEY}
    volumes:
      - ~/.openbb_provider.json:/app/provider.json
    restart: unless-stopped

# 启动
docker-compose up -d

# 查看日志
docker logs -f openbb-api

# /etc/systemd/system/openbb-api.service
[Unit]
Description=OpenBB API Server
After=network.target

[Service]
Type=simple
User=openbb
WorkingDirectory=/home/openbb
ExecStart=/usr/local/bin/openbb-api
Restart=always

[Install]
WantedBy=multi-user.target

# .env 文件
OPENBB_API_KEY=your_api_key
OPENBB_POLYGON_API_KEY=your_polygon_key
OPENBB_FMP_API_KEY=your_fmp_key

# API 安全
# 默认 localhost:6900，仅监听本地
# 生产环境使用 Nginx 反向代理 + HTTPS

obb.equity.price.historical(
    "AAPL",
    provider="polygon"  # 指定 Provider
)

# 使用 AkShare（免费）
obb.equity.price.historical(
    "600519",  # 茅台
    provider="akshare"
)