finnhubAccess 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.
Install via ClawdBot CLI:
clawdbot install matthewxfz3/finnhubAccess real-time and historical stock market data, company news, financial statements, and market indicators via the Finnhub API.
Get your API key from finnhub.io (free tier available).
Configure in OpenClaw:
{
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-hereBase URL: https://finnhub.io/api/v1
All requests require ?token=${FINNHUB_API_KEY} parameter.
Get current stock price:
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)
Get latest company news:
# 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}"Get company information:
curl "https://finnhub.io/api/v1/stock/profile2?symbol=AAPL&token=${FINNHUB_API_KEY}"Get company financials:
# 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}"Get market indicators:
# 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}"Get technical indicators and signals:
# 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.
Get earnings data:
# 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}"GET /search?q=keywordGET /quote?symbol=SYMBOLGET /company-news?symbol=SYMBOL&from=DATE&to=DATEGET /indicator?symbol=SYMBOL&indicator=rsiGET /stock/financials-reported?symbol=SYMBOLGET /stock/search-in-filing?symbol=SYMBOL&query=KEYWORDGET /quote?symbol=SYMBOLGET /stock/candle?symbol=SYMBOL&resolution=DGET /stock/profile2?symbol=SYMBOLGET /stock/earnings?symbol=SYMBOLGET /company-news?symbol=SYMBOLGET /news?category=generalGET /news?category=technologySearch within company SEC filings (10-K, 10-Q, 8-K, etc.):
# 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.
Free tier:
Paid tiers offer higher limits and additional features.
token=${FINNHUB_API_KEY} in query parametersYYYY-MM-DD for date rangesUS:AAPL for US stocks)Generated Mar 1, 2026
Develop a dashboard for individual investors to track real-time stock prices, news, and market indicators. This tool would pull current quotes, company news, and technical signals to help users make informed trading decisions quickly.
Create a platform for financial analysts to access company profiles, financial statements, and SEC filings. It would enable deep dives into earnings data, balance sheets, and keyword searches in official documents for due diligence.
Build a system that uses technical indicators and market data to generate automated trading signals. This could integrate with brokerage APIs for paper trading or live execution, helping traders identify opportunities based on patterns and support/resistance levels.
Develop a news aggregator that pulls real-time company and general market news from Finnhub. This would serve media outlets or content creators needing up-to-date financial news for reporting or analysis.
Design an interactive tool for students to learn about stock markets by accessing historical data, financial statements, and earnings calendars. It would simulate real-world scenarios without requiring live trading.
Offer tiered subscription plans providing enhanced API access with higher rate limits, premium endpoints like technical indicators, and priority support. This targets developers and businesses needing reliable, scalable data.
Sell customizable dashboards to financial institutions or advisors, integrating Finnhub data for client-facing tools. This includes features like real-time quotes, news feeds, and performance analytics.
Provide curated data feeds and analytics reports to research firms, leveraging Finnhub's financial statements and market data. This model focuses on delivering insights rather than raw data access.
💬 Integration Tip
Ensure the FINNHUB_API_KEY is securely stored in environment variables and use the base URL with token parameters for all requests to avoid authentication errors.
Analyze stocks and cryptocurrencies using Yahoo Finance data. Supports portfolio management, watchlists with alerts, dividend analysis, 8-dimension stock scoring, viral trend detection (Hot Scanner), and rumor/early signal detection. Use for stock analysis, portfolio tracking, earnings reactions, crypto monitoring, trending stocks, or finding rumors before they hit mainstream.
Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Uses yfinance library - no API key required.
Yahoo Finance (yfinance) powered stock analysis skill: quotes, fundamentals, ASCII trends, high-resolution charts (RSI/MACD/BB/VWAP/ATR), plus optional web a...
Become an autonomous prediction market trader on Polymarket with AI-powered analysis and a performance-backed token on Base. Trade real markets, build a track record, and let the buyback flywheel run.
Get cryptocurrency token price and generate candlestick charts via CoinGecko API or Hyperliquid API. Use when user asks for token price, crypto price, price chart, or cryptocurrency market data.
Trade and monitor Hyperliquid perpetual futures. Check balances, view positions with P&L, place/cancel orders, execute market trades. Use when the user asks about Hyperliquid trading, portfolio status, crypto positions, or wants to execute trades on Hyperliquid.