financial-datasets

name	financial-datasets
description	Query FinancialDatasets for price/fundamental data to support trade decisions.
metadata	{"openclaw":{"emoji":"📈","requires":{"env":["FINANCIAL_DATASETS_API_KEY"],"bins":["python3"]}}}

FinancialDatasets

CLI: ${OPENCLAW_HOME:-$HOME/.openclaw}/tools/financialdatasets/fd_cli.py

Commands

Price Data

# Historical prices (returns most recent N)
fd_cli.py prices --ticker NVDA --interval day --limit 20

# Real-time snapshot
fd_cli.py snapshot --ticker AAPL

Fundamentals

# Income statement
fd_cli.py income --ticker NVDA --period quarterly --limit 4

# Balance sheet
fd_cli.py balance --ticker AAPL --period annual --limit 4

# Cash flow
fd_cli.py cashflow --ticker MSFT --period ttm --limit 4

Alternative Data

# Company news
fd_cli.py news --ticker TSLA --limit 10

# Insider trades (CEO/CFO buys/sells)
fd_cli.py insider --ticker NVDA --limit 20

# Institutional ownership (13F filings)
fd_cli.py institutional --investor BERKSHIRE_HATHAWAY_INC --limit 50
fd_cli.py institutional --ticker AAPL --limit 20

Use Cases

1. Discovery: Check snapshot for quick price/volume context
2. Fundamentals: Pull income/balance for valuation work
3. Sentiment: Check insider trades for conviction signals
4. Smart Money: Track institutional flows via 13F data
5. Catalysts: News endpoint for recent headlines

API Notes

• Trailing slash required on endpoints (already handled in CLI)
• Prices return oldest-first, CLI slices to return most recent
• 13F data has 45-day lag from quarter end
• News sourced from Motley Fool, Reuters, Investing.com