Skill: matthewxfz3/finnhub (version 1.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", }, } --- # 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, [REDACTED_SECRET]", 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 `?[REDACTED_SECRET]` parameter. ### Stock Quotes (Real-time) Get current stock price: ```bash curl "https://finnhub.io/api/v1/quote?symbol=AAPL&[REDACTED_SECRET]" ``` 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&[REDACTED_SECRET]" # General market news curl "https://finnhub.io/api/v1/news?category=general&[REDACTED_SECRET]" ``` ### Company Profile Get company information: ```bash curl "https://finnhub.io/api/v1/stock/profile2?symbol=AAPL&[REDACTED_SECRET]" ``` ### Financial Statements Get company financials: ```bash # Income statement curl "https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&[REDACTED_SECRET]" # Balance sheet curl "https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&statement=bs&[REDACTED_SECRET]" # Cash flow curl "https://finnhub.io/api/v1/stock/financials-reported?symbol=AAPL&statement=cf&[REDACTED_SECRET]" # 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&[REDACTED_SECRET]" ``` ### 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&[REDACTED_SECRET]" # Stock symbols (search) curl "https://finnhub.io/api/v1/search?q=apple&[REDACTED_SECRET]" # Market status curl "https://finnhub.io/api/v1/stock/market-status?exchange=US&[REDACTED_SECRET]" ``` ### 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&[REDACTED_SECRET]" # Support/Resistance (may require premium tier) curl "https://finnhub.io/api/v1/scan/support-resistance?symbol=AAPL&resolution=D&[REDACTED_SECRET]" # Pattern recognition (may require premium tier) curl "https://finnhub.io/api/v1/scan/pattern?symbol=AAPL&resolution=D&[REDACTED_SECRET]" ``` **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&[REDACTED_SECRET]" # Company earnings curl "https://finnhub.io/api/v1/stock/earnings?symbol=AAPL&[REDACTED_SECRET]" ``` ## 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&[REDACTED_SECRET]" # Search for risk factors curl "https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=risk&[REDACTED_SECRET]" # Search for specific financial metrics curl "https://finnhub.io/api/v1/stock/search-in-filing?symbol=AAPL&query=EBITDA&[REDACTED_SECRET]" ``` 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 `[REDACTED_SECRET]` 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


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)