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 anal
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Access 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/.envFINNHUB_API_KEY=your-api-key-here
Base URL:
https://finnhub.io/api/v1All requests require
?token=${FINNHUB_API_KEY}Get current stock price:
curl "https://finnhub.io/api/v1/quote?symbol=AAPL&token=${FINNHUB_API_KEY}"
Returns:
chlopctGet 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
Cash flow
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)
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
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}YYYY-MM-DDUS:AAPLNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.