介绍
# Finnhub API
通过 Finnhub API 访问实时和历史股市数据、公司新闻、财务报表和市场指标。
## 快速开始
从 [finnhub.io](https://finnhub.io) 获取您的 API 密钥（提供免费层级）。
在 OpenClaw 中配置：
```json5 { 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}` 参数。
### 股票报价（实时）
获取当前股价：
```bash curl "https://finnhub.io/api/v1/quote?symbol=AAPL&token=${FINNHUB_API_KEY}" ```
返回：`c`（当前价）、`h`（最高价）、`l`（最低价）、`o`（开盘价）、`pc`（前收盘价）、`t`（时间戳）
### 公司新闻
获取最新公司新闻：
```bash # News for a symbol curl "https://finnhub.io/api/v1/company-news?symbol=AAPL&from=2025-01-01&to=2025-02-01&token=${FINNHUB_API_KEY}"
# General market news curl "https://finnhub.io/api/v1/news?category=general&token=${FINNHUB_API_KEY}" ```
### 公司概况
获取公司信息：
```bash curl "https://finnhub.io/api/v1/stock/profile2?symbol=AAPL&token=${FINNHUB_API_KEY}" ```
### 财务报表
获取公司财务数据：
```bash # Income statement curl "https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&token=${FINNHUB_API_KEY}"
# Balance sheet curl "https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&statement=bs&token=${FINNHUB_API_KEY}"
# Cash flow curl "https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&statement=cf&token=${FINNHUB_API_KEY}"
# Search in SEC filings (10-K, 10-Q, etc.) # Note: This endpoint may require premium tier or have a different path curl "https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=revenue&token=${FINNHUB_API_KEY}" ```
### 市场数据
获取市场指标：
```bash # Stock candles (OHLCV) curl "https://finnhub.io/api/v1/stock/candle?symbol=AAPL&resolution=D&from=1609459200&to=1640995200&token=${FINNHUB_API_KEY}"
# Stock symbols (search) curl "https://finnhub.io/api/v1/search?q=apple&token=${FINNHUB_API_KEY}"
# Market status curl "https://finnhub.io/api/v1/stock/market-status?exchange=US&token=${FINNHUB_API_KEY}" ```
### 交易信号
获取技术指标和信号：
```bash # Technical indicators (may require premium tier) curl "https://finnhub.io/api/v1/indicator?symbol=AAPL&indicator=rsi&resolution=D&token=${FINNHUB_API_KEY}"
# Support/Resistance (may require premium tier) curl "https://finnhub.io/api/v1/scan/support-resistance?symbol=AAPL&resolution=D&token=${FINNHUB_API_KEY}"
# Pattern recognition (may require premium tier) curl "https://finnhub.io/api/v1/scan/pattern?symbol=AAPL&resolution=D&token=${FINNHUB_API_KEY}" ```
**注意：** 某些技术指标端点可能需要高级订阅。免费层级包含基础市场数据和报价。
### 财报与日历
获取财报数据：
```bash # Earnings calendar curl "https://finnhub.io/api/v1/calendar/earnings?from=2025-02-01&to=2025-02-28&token=${FINNHUB_API_KEY}"
# Company earnings 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 等）中搜索：
```bash # Search for specific terms in filings # Note: This endpoint may require premium tier or have a different path curl "https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=revenue&token=${FINNHUB_API_KEY}"
# Search for risk factors curl "https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=risk&token=${FINNHUB_API_KEY}"
# Search for specific financial metrics 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 结合使用以执行交易