Finnhub Pro — 美股金融数据 CLI
Python CLI 封装 Finnhub API，聚焦免费层实际可用的 10 个功能。
安装
CODEBLOCK0
API Key
- 1. 去 finnhub.io 注册获取免费 API Key
- 设置环境变量： INLINECODE0
- 或写入 INLINECODE1
⚠️ 脚本不硬编码 Key，必须通过环境变量 FINNHUB_API_KEY 传入！
使用方法
CODEBLOCK1
免费层支持的命令（10 个）
实时报价
CODEBLOCK2
公司档案
CODEBLOCK3
公司新闻（最近 7 天）
CODEBLOCK4
分析师推荐趋势
CODEBLOCK5
内部人交易记录（最近 90 天）
CODEBLOCK6
盈利日历（未来 30 天）
CODEBLOCK7
基本面财务指标
CODEBLOCK8
市场状态
CODEBLOCK9
同行公司
CODEBLOCK10
股票代码搜索
CODEBLOCK11
不可用功能（付费层）
- - K 线数据（
stock_candles） - 分析师目标价（
price_target） - 新闻情绪分析（
news_sentiment）
限制
- - 免费层：60 次/分钟
- 403 = 需付费升级
- 429 = 触发限速
依赖
- - Python 3.10+
- INLINECODE6 （
pip install finnhub-python）
Finnhub Pro — 美股金融数据 CLI
Python CLI 封装 Finnhub API，聚焦免费层实际可用的 10 个功能。
安装
bash
pip install finnhub-python
API Key
- 1. 前往 finnhub.io 注册获取免费 API Key
- 设置环境变量：export FINNHUBAPI_KEY=your-key-here
- 或写入 ~/.openclaw/.env
⚠️ 脚本不硬编码 Key，必须通过环境变量 FINNHUBAPIKEY 传入！
使用方法
bash
基础格式
FINNHUB
APIKEY=your-key python3 scripts/finnhub_cli.py
[args] [--json] [--limit N]
推荐：设好环境变量后直接用
python3 scripts/finnhub_cli.py quote AAPL
免费层支持的命令（10 个）
实时报价
bash
python3 scripts/finnhub_cli.py quote AAPL
python3 scripts/finnhub_cli.py quote NVDA --json # 原始 JSON
公司档案
bash
python3 scripts/finnhub_cli.py profile AAPL
公司新闻（最近 7 天）
bash
python3 scripts/finnhub_cli.py news NVDA
python3 scripts/finnhub_cli.py news AAPL --from 2026-02-01 --to 2026-02-21 --limit 5
分析师推荐趋势
bash
python3 scripts/finnhub_cli.py recommend NVDA
内部人交易记录（最近 90 天）
bash
python3 scripts/finnhub_cli.py insiders AAPL
python3 scripts/finnhub_cli.py insiders NVDA --from 2026-01-01 --to 2026-02-21
盈利日历（未来 30 天）
bash
python3 scripts/finnhub_cli.py earnings # 所有股票
python3 scripts/finnhub_cli.py earnings NVDA # 指定股票
python3 scripts/finnhub_cli.py earnings --from 2026-02-21 --to 2026-03-07
基本面财务指标
bash
python3 scripts/finnhub_cli.py financials AAPL
python3 scripts/finnhub_cli.py financials NVDA --json # 全部指标
市场状态
bash
python3 scripts/finnhub_cli.py market # 默认美国
python3 scripts/finnhub_cli.py market NYSE
同行公司
bash
python3 scripts/finnhub_cli.py peers AAPL
股票代码搜索
bash
python3 scripts/finnhub_cli.py search apple
不可用功能（付费层）
- - K 线数据（stockcandles）
- 分析师目标价（pricetarget）
- 新闻情绪分析（news_sentiment）
限制
- - 免费层：60 次/分钟
- 403 = 需付费升级
- 429 = 触发限速
依赖
- - Python 3.10+
- finnhub-python（pip install finnhub-python）
