ClawTrust
2.7k Downloads
Overview
Command-line wrapper around the Finnhub API’s free tier to fetch U.S. stock market data (quotes, company info, news, fundamentals, calendars, insiders, etc.) for use inside Python/CLI workflows.
Key Advantages
1.Covers the most practically useful free Finnhub endpoints (10 focused commands) rather than exposing the full, more complex API surface.
2.Clear, simple CLI interface with concrete usage examples for each command, including optional raw JSON output for programmatic consumption.
3.Explicit separation of free-tier vs paid-only features (no K-lines, price targets, or sentiment), which helps set realistic expectations and reduce error/debug time.
4.Uses environment variables for API key management (FINNHUB_API_KEY), avoiding hard-coded secrets in scripts or repositories.
5.Suitable for both ad-hoc querying (manual CLI use) and scripted/automated workflows (e.g., piping JSON into other tools).
Use Cases
- Fetching real-time U.S. stock quotes for tickers like AAPL or NVDA inside automated trading dashboards or monitoring scripts.
- Retrieving company profiles and basic fundamentals for investment research, screening, or enrichment of financial datasets.
- Pulling recent company news headlines and articles (with date range and limit) to contextualize price movements or events.
- Checking analyst recommendation trends for a ticker to summarize market analyst stance over time.
- Inspecting recent insider trading activity (last 90 days or custom window) to see whether insiders are buying or selling a stock. Retrieving upcoming earnings calendar entries (b)
Evaluation Scores
8.1
/ 10
Reliability
7.6
Functionality
7.8
Usability
8.3
Safety
8.5
Performance
8.2
Compatibility
8.0
Based on 1 evaluation · Latest: 3/19/2026
Download Trend
Loading...
Evaluation History (1)
8.1/103/19/2026▼
OS: win32-x64LLM: google/gemini-3-flash-preview
**Quick judgment**
A solid, focused CLI wrapper around Finnhub’s free-tier U.S. equity data. It’s well-scoped (10 core commands), uses standard Python tooling, and is appropriate when you need live-ish market data, basic fundamentals, news, and calendars, but not detailed charting or advanced analytics.
**What it does well**
- Provides real-time quotes, company profiles, recent news, analyst recommendations, insider transactions, earnings calendars, fundamentals, market status, peer lists, and symbol search.
- Clean CLI interface with examples for each command and a `--json` option for raw API responses, which is convenient for agents/workflows that need structured data.
- Sensible security posture: requires `FINNHUB_API_KEY` via environment variable, no keys hard-coded.
- Explicitly documents free-tier limits and unavailable (paid) features, reducing confusion and unexpected errors.
**Key limitations / risks**
- Depends entirely on Finnhub’s external API: outages, schema changes, or rate limiting (60 req/min free tier, HTTP 429) will directly affect tool reliability.
- Financial data can be delayed, incomplete, or revised; using it to drive real-money trading decisions carries market and data-quality risk that this tool does not mitigate.
- Does **not** support K-line/candlestick data, analyst price targets, or news sentiment; if a workflow implicitly assumes those, results will be incomplete.
- Requires manual API key setup; misconfiguration leads to authentication errors (HTTP 403 for plan issues).
**Recommended scenarios**
Use this skill when an agent or user needs:
- Quick snapshots of U.S. stock prices and basic company info.
- Recent company news and analyst recommendation trends for context.
- Insider trading logs and upcoming earnings dates for a ticker or broad coverage.
- Lightweight fundamentals and peer comparisons to enrich financial analyses or reports.
Avoid relying on it for:
- Intraday chart analysis, K-line data, or quantitative backtesting.
- Analyst price targets or automated sentiment-driven strategies (not provided in free tier).
- Any use case where guaranteed data timeliness, completeness, or uptime is critical without additional validation or redundancy.
Comments (0)
No comments yet. Be the first!