名称： finnhub
描述： 通过 Finnhub API 获取实时股票报价、公司新闻、市场数据、财务报表和交易信号。适用于需要当前股价、公司新闻、财报数据或市场分析的场景。
主页： https://finnhub.io
元数据：
{
"openclaw": {
"emoji": "📈",
"requires": { "env": ["FINNHUB_API_KEY"] },
"primaryEnv": "FINNHUB_API_KEY",
},
}

Finnhub API

通过 Finnhub API 访问实时和历史股票市场数据、公司新闻、财务报表和市场指标。

快速开始

从 finnhub.io 获取您的 API 密钥（提供免费套餐）。

在 OpenClaw 中配置：

{
  skills: {
    entries: {
      finnhub: {
        enabled: true,
        apiKey: "your-finnhub-api-key",
        env: {
          FINNHUB_API_KEY: "your-finnhub-api-key",
        },
      },
    },
  },
}

或添加到 ~/.openclaw/.env 文件中：

FINNHUB_API_KEY=your-api-key-here

API 端点

基础 URL：https://finnhub.io/api/v1

所有请求都需要 ?token=${FINNHUB_API_KEY} 参数。

股票报价（实时）

获取当前股价：

curl "https://finnhub.io/api/v1/quote?symbol=AAPL&token=${FINNHUB_API_KEY}"

返回字段：c（当前价格）、h（最高价）、l（最低价）、o（开盘价）、pc（前收盘价）、t（时间戳）

公司新闻

获取最新公司新闻：

# 获取指定股票代码的新闻
curl "https://finnhub.io/api/v1/company-news?symbol=AAPL&from=2025-01-01&to=2025-02-01&token=${FINNHUB_API_KEY}"

# 获取一般市场新闻
curl "https://finnhub.io/api/v1/news?category=general&token=${FINNHUB_API_KEY}"

公司简介

获取公司信息：

curl "https://finnhub.io/api/v1/stock/profile2?symbol=AAPL&token=${FINNHUB_API_KEY}"

财务报表

获取公司财务数据：

# 利润表
curl "https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&token=${FINNHUB_API_KEY}"

# 资产负债表
curl "https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&statement=bs&token=${FINNHUB_API_KEY}"

# 现金流量表
curl "https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&statement=cf&token=${FINNHUB_API_KEY}"

# 在 SEC 文件中搜索（10-K、10-Q 等）
# 注意：此端点可能需要付费套餐或路径不同
curl "https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=revenue&token=${FINNHUB_API_KEY}"

市场数据

获取市场指标：

# 股票 K 线数据（OHLCV）
curl "https://finnhub.io/api/v1/stock/candle?symbol=AAPL&resolution=D&from=1609459200&to=1640995200&token=${FINNHUB_API_KEY}"

# 股票代码搜索
curl "https://finnhub.io/api/v1/search?q=apple&token=${FINNHUB_API_KEY}"

# 市场状态
curl "https://finnhub.io/api/v1/stock/market-status?exchange=US&token=${FINNHUB_API_KEY}"

交易信号

获取技术指标和信号：

# 技术指标（可能需要付费套餐）
curl "https://finnhub.io/api/v1/indicator?symbol=AAPL&indicator=rsi&resolution=D&token=${FINNHUB_API_KEY}"

# 支撑/阻力位（可能需要付费套餐）
curl "https://finnhub.io/api/v1/scan/support-resistance?symbol=AAPL&resolution=D&token=${FINNHUB_API_KEY}"

# 形态识别（可能需要付费套餐）
curl "https://finnhub.io/api/v1/scan/pattern?symbol=AAPL&resolution=D&token=${FINNHUB_API_KEY}"

注意： 部分技术指标端点可能需要付费订阅。免费套餐包含基础市场数据和报价。

财报与日历

获取财报数据：

# 财报日历
curl "https://finnhub.io/api/v1/calendar/earnings?from=2025-02-01&to=2025-02-28&token=${FINNHUB_API_KEY}"

# 公司财报
curl "https://finnhub.io/api/v1/stock/earnings?symbol=AAPL&token=${FINNHUB_API_KEY}"

常见用例

寻找交易机会

1. 搜索股票：GET /search?q=keyword
2. 获取当前报价：GET /quote?symbol=SYMBOL
3. 查看近期新闻：GET /company-news?symbol=SYMBOL&from=DATE&to=DATE
4. 分析技术指标：GET /indicator?symbol=SYMBOL&indicator=rsi
5. 审阅财务数据：GET /stock/financials-reported?symbol=SYMBOL
6. 搜索 SEC 文件：GET /stock/search-in-filing?symbol=SYMBOL&query=KEYWORD

监控股票表现

1. 获取实时报价：GET /quote?symbol=SYMBOL
2. 获取历史 K 线：GET /stock/candle?symbol=SYMBOL&resolution=D
3. 查看公司简介：GET /stock/profile2?symbol=SYMBOL
4. 审阅财报：GET /stock/earnings?symbol=SYMBOL

研究公司新闻

1. 公司特定新闻：GET /company-news?symbol=SYMBOL
2. 一般市场新闻：GET /news?category=general
3. 行业新闻：GET /news?category=technology

搜索 SEC 文件

在公司 SEC 文件（10-K、10-Q、8-K 等）中搜索：

# 在文件中搜索特定术语
# 注意：此端点可能需要付费套餐或路径不同
curl "https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=revenue&token=${FINNHUB_API_KEY}"

# 搜索风险因素
curl "https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=risk&token=${FINNHUB_API_KEY}"

# 搜索特定财务指标
curl "https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=EBITDA&token=${FINNHUB_API_KEY}"

此端点用于在 SEC 文件（10-K、10-Q、8-K 等）中搜索特定关键词或短语，有助于在官方公司文件中查找特定主题、风险或财务指标的提及。

速率限制

免费套餐：
- 60 次 API 调用/分钟
- 实时数据：有限制
- 历史数据：可用

付费套餐提供更高的限制和额外功能。

注意事项

• 始终在查询参数中包含 token=${FINNHUB_API_KEY}
• 使用正确的日期格式：日期范围使用 YYYY-MM-DD
• 时间戳为 Unix 纪元秒数
• 股票代码格式：如需要请使用交易所前缀（例如，美股使用 US:AAPL）
• 对于模拟交易，可将 Finnhub 数据与 Alpaca API 结合使用以执行交易