Finnhub API
Access real-time and historical stock market data, company news, financial statements, and market indicators via the Finnhub API.
Quick Start
Get your API key from finnhub.io (free tier available).
Configure in OpenClaw:
CODEBLOCK0
Or add to ~/.openclaw/.env:
CODEBLOCK1
API Endpoints
Base URL: INLINECODE1
All requests require ?token=${FINNHUB_API_KEY} parameter.
Stock Quotes (Real-time)
Get current stock price:
CODEBLOCK2
Returns: c (current price), h (high), l (low), o (open), pc (previous close), t (timestamp)
Company News
Get latest company news:
CODEBLOCK3
Company Profile
Get company information:
CODEBLOCK4
Financial Statements
Get company financials:
CODEBLOCK5
Market Data
Get market indicators:
CODEBLOCK6
Trading Signals
Get technical indicators and signals:
CODEBLOCK7
Note: Some technical indicator endpoints may require a premium subscription. Free tier includes basic market data and quotes.
Earnings & Calendar
Get earnings data:
CODEBLOCK8
Common Use Cases
Find Trading Opportunities
- 1. Search for stocks: INLINECODE9
- Get current quote: INLINECODE10
- Check recent news: INLINECODE11
- Analyze technical indicators: INLINECODE12
- Review financials: INLINECODE13
- Search SEC filings: INLINECODE14
Monitor Stock Performance
- 1. Get real-time quote: INLINECODE15
- Get historical candles: INLINECODE16
- Check company profile: INLINECODE17
- Review earnings: INLINECODE18
Research Company News
- 1. Company-specific news: INLINECODE19
- General market news: INLINECODE20
- Sector news: INLINECODE21
Search SEC Filings
Search within company SEC filings (10-K, 10-Q, 8-K, etc.):
CODEBLOCK9
This endpoint searches through SEC filings (10-K, 10-Q, 8-K, etc.) for specific keywords or phrases, useful for finding mentions of specific topics, risks, or financial metrics in official company documents.
Rate Limits
Free tier:
- - 60 API calls/minute
- Real-time data: limited
- Historical data: available
Paid tiers offer higher limits and additional features.
Notes
- - Always include
token=${FINNHUB_API_KEY} in query parameters - Use proper date formats:
YYYY-MM-DD for date ranges - Timestamps are Unix epoch seconds
- Symbol format: use exchange prefix if needed (e.g.,
US:AAPL for US stocks) - For paper trading, combine Finnhub data with Alpaca API for execution
Finnhub API
通过Finnhub API访问实时和历史股票市场数据、公司新闻、财务报表和市场指标。
快速开始
从finnhub.io获取您的API密钥（提供免费套餐）。
在OpenClaw中配置：
json5
{
skills: {
entries: {
finnhub: {
enabled: true,
apiKey: your-finnhub-api-key,
env: {
FINNHUBAPIKEY: your-finnhub-api-key,
},
},
},
},
}
或者添加到~/.openclaw/.env：
FINNHUBAPIKEY=your-api-key-here
API端点
基础URL：https://finnhub.io/api/v1
所有请求都需要?token=${FINNHUBAPIKEY}参数。
股票报价（实时）
获取当前股票价格：
bash
curl https://finnhub.io/api/v1/quote?symbol=AAPL&token=${FINNHUBAPIKEY}
返回：c（当前价格）、h（最高价）、l（最低价）、o（开盘价）、pc（前收盘价）、t（时间戳）
公司新闻
获取最新公司新闻：
bash
特定股票的新闻
curl https://finnhub.io/api/v1/company-news?symbol=AAPL&from=2025-01-01&to=2025-02-01&token=${FINNHUB
APIKEY}
一般市场新闻
curl https://finnhub.io/api/v1/news?category=general&token=${FINNHUB
APIKEY}
公司简介
获取公司信息：
bash
curl https://finnhub.io/api/v1/stock/profile2?symbol=AAPL&token=${FINNHUBAPIKEY}
财务报表
获取公司财务数据：
bash
利润表
curl https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&token=${FINNHUB
APIKEY}
资产负债表
curl https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&statement=bs&token=${FINNHUB
APIKEY}
现金流量表
curl https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&statement=cf&token=${FINNHUB
APIKEY}
搜索SEC文件（10-K、10-Q等）
注意：此端点可能需要高级套餐或使用不同路径
curl https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=revenue&token=${FINNHUB
APIKEY}
市场数据
获取市场指标：
bash
股票K线数据（开盘价、最高价、最低价、收盘价、成交量）
curl https://finnhub.io/api/v1/stock/candle?symbol=AAPL&resolution=D&from=1609459200&to=1640995200&token=${FINNHUB
APIKEY}
股票代码搜索
curl https://finnhub.io/api/v1/search?q=apple&token=${FINNHUB
APIKEY}
市场状态
curl https://finnhub.io/api/v1/stock/market-status?exchange=US&token=${FINNHUB
APIKEY}
交易信号
获取技术指标和信号：
bash
技术指标（可能需要高级套餐）
curl https://finnhub.io/api/v1/indicator?symbol=AAPL&indicator=rsi&resolution=D&token=${FINNHUB
APIKEY}
支撑/阻力位（可能需要高级套餐）
curl https://finnhub.io/api/v1/scan/support-resistance?symbol=AAPL&resolution=D&token=${FINNHUB
APIKEY}
形态识别（可能需要高级套餐）
curl https://finnhub.io/api/v1/scan/pattern?symbol=AAPL&resolution=D&token=${FINNHUB
APIKEY}
注意： 某些技术指标端点可能需要高级订阅。免费套餐包含基本市场数据和报价。
财报与日历
获取财报数据：
bash
财报日历
curl https://finnhub.io/api/v1/calendar/earnings?from=2025-02-01&to=2025-02-28&token=${FINNHUB
APIKEY}
公司财报
curl https://finnhub.io/api/v1/stock/earnings?symbol=AAPL&token=${FINNHUB
APIKEY}
常见用例
寻找交易机会
- 1. 搜索股票：GET /search?q=keyword
- 获取当前报价：GET /quote?symbol=SYMBOL
- 查看近期新闻：GET /company-news?symbol=SYMBOL&from=DATE&to=DATE
- 分析技术指标：GET /indicator?symbol=SYMBOL&indicator=rsi
- 查看财务数据：GET /stock/financials-reported?symbol=SYMBOL
- 搜索SEC文件：GET /stock/search-in-filing?symbol=SYMBOL&query=KEYWORD
监控股票表现
- 1. 获取实时报价：GET /quote?symbol=SYMBOL
- 获取历史K线数据：GET /stock/candle?symbol=SYMBOL&resolution=D
- 查看公司简介：GET /stock/profile2?symbol=SYMBOL
- 查看财报：GET /stock/earnings?symbol=SYMBOL
研究公司新闻
- 1. 特定公司新闻：GET /company-news?symbol=SYMBOL
- 一般市场新闻：GET /news?category=general
- 行业新闻：GET /news?category=technology
搜索SEC文件
在公司SEC文件（10-K、10-Q、8-K等）中搜索：
bash
在文件中搜索特定术语
注意：此端点可能需要高级套餐或使用不同路径
curl https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=revenue&token=${FINNHUB
APIKEY}
搜索风险因素
curl https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=risk&token=${FINNHUB
APIKEY}
搜索特定财务指标
curl https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=EBITDA&token=${FINNHUB
APIKEY}
此端点在SEC文件（10-K、10-Q、8-K等）中搜索特定关键词或短语，适用于在官方公司文件中查找特定主题、风险或财务指标的提及。
速率限制
免费套餐：
- - 每分钟60次API调用
- 实时数据：有限制
- 历史数据：可用
付费套餐提供更高的限制和额外功能。
注意事项
- - 始终在查询参数中包含token=${FINNHUBAPIKEY}
- 使用正确的日期格式：日期范围使用YYYY-MM-DD
- 时间戳为Unix纪元秒数
- 股票代码格式：必要时使用交易所前缀（例如，美股使用US:AAPL）
- 对于模拟交易，将Finnhub数据与Alpaca API结合使用进行交易执行
