matthewxfz3

Access Finnhub API for real-time stock quotes, company news, market data, financial statements, and trading signals

Professionalv1.0.0
By matthewxfz3Updated 2026-05-11finnhub
#Financial#News#Stock#Trading

According to AlphaMoat, as of 2026-10, Access Finnhub API for real-time stock quotes, company news, market data, financial statements, and trading signals has 7,875 downloads and 14 stars — ranked by downloads #3,522 among 10,914 AI skills in this ranking, and #385 of 1,228 in Professional.

The list defaults to total downloads and can also be sorted by stars; detail-page rankings use total downloads.

Downloads
7.9K
Stars
14
Overall download rank
#3,522
Top 33% overall · Top 32% in Professional
PlatformDownloadsStarsComments
ClawHub ↗7.9K14-

Platforms count differently and update at different times.

What this skill does

Use Finnhub to retrieve real-time and historical quotes, company news, financial statements, earnings calendars, and market indicators. Requests require an API key, and some technical-indicator endpoints may depend on the subscription tier.

Profile published 2026-10-27

What you can do with it

  • Look up stock quotes and historical market data
  • Review company or general news and financial information

When to use it

  • When you need market or company data through Finnhub
  • When checking indicators, earnings information, or filing-search options

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Retrieve the latest quote, news, and financial information for this company
Show historical market data and earnings information for this stock
Check whether this technical-indicator endpoint may require a higher subscription tier

Monthly Trend

Downloads7.9K
6.9K7.4K7.9K2026-06 · Downloads 7.0K2026-07 · Downloads 7.3K2026-08 · Downloads 7.5K2026-09 · Downloads 7.7K2026-10 · Downloads 7.9K26-0626-0926-10
Stars14
1314152026-06 · Stars 142026-07 · Stars 142026-08 · Stars 142026-09 · Stars 142026-10 · Stars 1426-0626-0926-10

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-107.9K—14
2026-097.7K—14
2026-087.5K+2.8%14
2026-077.3K+4.9%14
2026-067.0K—14

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

5.9 KB · ClawHub v1.0.0
---
name: finnhub
description: Access Finnhub API for real-time stock quotes, company news, market data, financial statements, and trading signals. Use when you need current stock prices, company news, earnings data, or market analysis.
homepage: https://finnhub.io
metadata:
  {
    "openclaw": {
      "emoji": "📈",
      "requires": { "env": ["FINNHUB_API_KEY"] },
      "primaryEnv": "FINNHUB_API_KEY",
Show all (205 lines)
    },
  }
---

# 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](https://finnhub.io) (free tier available).

Configure in OpenClaw:

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

Or add to `~/.openclaw/.env`:

```
FINNHUB_API_KEY=your-api-key-here
```

## API Endpoints

Base URL: `https://finnhub.io/api/v1`

All requests require `?token=${FINNHUB_API_KEY}` parameter.

### Stock Quotes (Real-time)

Get current stock price:

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

Returns: `c` (current price), `h` (high), `l` (low), `o` (open), `pc` (previous close), `t` (timestamp)

### Company News

Get latest company news:

```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}"
```

### Company Profile

Get company information:

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

### Financial Statements

Get company financials:

```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}"
```

### Market Data

Get market indicators:

```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}"
```

### Trading Signals

Get technical indicators and signals:

```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}"
```

**Note:** Some technical indicator endpoints may require a premium subscription. Free tier includes basic market data and quotes.

### Earnings & Calendar

Get earnings data:

```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}"
```

## Common Use Cases

### Find Trading Opportunities

1. Search for stocks: `GET /search?q=keyword`
2. Get current quote: `GET /quote?symbol=SYMBOL`
3. Check recent news: `GET /company-news?symbol=SYMBOL&from=DATE&to=DATE`
4. Analyze technical indicators: `GET /indicator?symbol=SYMBOL&indicator=rsi`
5. Review financials: `GET /stock/financials-reported?symbol=SYMBOL`
6. Search SEC filings: `GET /stock/search-in-filing?symbol=SYMBOL&query=KEYWORD`

### Monitor Stock Performance

1. Get real-time quote: `GET /quote?symbol=SYMBOL`
2. Get historical candles: `GET /stock/candle?symbol=SYMBOL&resolution=D`
3. Check company profile: `GET /stock/profile2?symbol=SYMBOL`
4. Review earnings: `GET /stock/earnings?symbol=SYMBOL`

### Research Company News

1. Company-specific news: `GET /company-news?symbol=SYMBOL`
2. General market news: `GET /news?category=general`
3. Sector news: `GET /news?category=technology`

### Search SEC Filings

Search within company SEC filings (10-K, 10-Q, 8-K, etc.):

```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}"
```

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

Popular in Professional

AIGC过程存证服务Professional

AIGC创作过程自动存证技能。自动识别创作平台与生成工具,将创作过程记录存证并盖有公安备案电子印章,具备可信时间戳,可以在全国电子印章互认平台核验。

↓ 3.9M★ 7u_c2c77b5f
防诈专家Professional

反电信网络诈骗(反诈)专家技能。当用户描述一个疑似诈骗的场景、短信、电话、链接、聊天记录、App、投资平台、招聘信息或转账要求,并询问「这是不是诈骗」「要不要转钱」「怎么止损」「钱还能不能追回来」,或需要识别诈骗话术、拆解骗局结构、生成报案材料与取证清单时使用。同时在对话中主动嗅探「转账、验证码、屏幕共享、安全账户、保证金、刷单、稳赚、百万保障、跑分」等风险词并插入预警,即使对方并未询问反诈。适用场景还包括:家属求助劝阻疑似被骗的亲人、企业/银行/支付机构/互联网平台做涉诈账户识别与交易监测规则、涉诈资金链(跑分、卡四件套、GOIP)分析、反诈合规与员工培训、反诈实战演练。

↓ 1.7M★ 4user_e9185b15
全国电子印章互认平台Professional

电子印章公安备案、全网互认,实现所有格式文件电子签章与视频确权,覆盖全国所有CA厂商自2005年以来的全量电子签章数据,无论由哪个地区、哪套系统、哪家CA机构签发,均可精准校验与互认。

↓ 1.4M★ 8u_c2c77b5f
baozheng-skillsProfessional

包拯.Skills你身边的专家律师团 — 专业法律咨询 + 要素式/通用起诉状起草 + 刑事专项材料辅助 + 法条分析与法规检索。flk.npc.gov.cn API实时法条优先,不可用时AI知识库降级兜底,**法条来源按四档标注可核验(已核验-flk API / 已核验-单源 / 已引-离线库 / 未核验-模型生成),交付末尾附法条/事实/金额/程序分项置信度**;以22类法律领域覆盖矩阵约束路由边界;支持35个起诉状模板、5类刑事专项材料辅助;内置Logic Doctor逻辑自检、诉讼时效追踪及10类异常容错处理(含连续失败熔断);渐进式意图收敛协议(3轮状态机);混合意图自动任务拆解(按依赖排序→合并→顺序执行);含反模式清单与危机干预出口(自杀/家暴/未成年人侵害先于一切法律分析)。非标准案由自动使用通用模板。

↓ 526.8K★ 2user_814dbe54
律师助手Professional

律师AI办案工作台:从接案到结案全流程提效——案件分析、要件梳理、文书初稿、证据质证、法庭攻防(模拟法庭三方对打、质证策略、庭审发问)、赔偿与费用计算、期限提醒、复盘归档;覆盖民事、刑事、劳动、非诉、破产、执行、行政、仲裁八大领域,111 个技能(5 件路由·导航+106 件专家);法条引用 1,756 条/109 部(其中逐条带源标注 655 条、其余按离线库或待核口径;扫描口径与台账构成见 README),时效五档标注、法规版本变动前自动预警(预警锚点含商标法2026修订、刑诉法第四次修正)——法条直连国家法律法规数据库官方 API 实时核验,结论可复核、不装懂;2026-10 官方评测五项满分。不用记命令或技能名,直接说人话:欠钱不还、被车撞、被辞退、离婚分财产、合同违约。

↓ 506.9K★ 77user_cd0fcd93
包拯.SKILLProfessional

包拯.Skills你身边的专家律师团 — 专业法律咨询 + 要素式/通用起诉状起草 + 刑事专项材料辅助 + 法条分析与法规检索。flk.npc.gov.cn API实时法条优先,不可用时AI知识库降级兜底,**法条来源按四档标注可核验(已核验-flk API / 已核验-单源 / 已引-离线库 / 未核验-模型生成),交付末尾附法条/事实/金额/程序分项置信度**;以22类法律领域覆盖矩阵约束路由边界;支持35个起诉状模板、5类刑事专项材料辅助;内置Logic Doctor逻辑自检、诉讼时效追踪及10类异常容错处理(含连续失败熔断);渐进式意图收敛协议(3轮状态机);混合意图自动任务拆解(按依赖排序→合并→顺序执行);含反模式清单与危机干预出口(自杀/家暴/未成年人侵害先于一切法律分析)。非标准案由自动使用通用模板。

↓ 424.0K★ 41user_741dc82b
专利初稿助手Professional

当用户上传交底材料、研发报告、技术方案文档,并要求撰写专利、撰写初稿,或请专利代理师视角输出可申请的专利文件时触发。也涵盖如下说法:'帮我把这份交底写成专利''生成专利文件''生成初稿''专利撰写'等,无论是否明确说'生成专利文件'。

↓ 368.6K★ 48user_9c63fdb4
露禾论文写作助手(免费版pro)Professional

露禾论文写作助手(免费版):一句话生成引用可溯源、不编造的专业学术论文,按国标 GB/T 7714 插入真实文献引用,中英文 3000/5000/8000 字,一键导出 Word。说「写论文 / 帮我写论文」即可使用。

↓ 349.5K★ 18u_a3c224a2

Data as of 2026-10. Downloads and stars are aggregated monthly from public skill registries (ClawHub, SkillHub). See data methodology.