Skip to content
Satchit4Public

About

A Bloomberg-style Rust CLI for stock analysis, scanning, backtesting, and watchlists using live market-data APIs.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

Fexter

Fexter is a Bloomberg-style stock analysis CLI for US equities and ETFs.

Features

  • Snapshot quote retrieval
  • Deterministic quantitative analysis with pillar scoring
  • Exa-enriched news sentiment
  • Stock comparison and universe scanning
  • Long-only trend + mean-reversion backtesting with parameter sweeps
  • SQLite-backed watchlists and response caching
  • Human-readable tables with --json output for automation

Install

  1. Install Rust (stable): https://rustup.rs/
  2. Clone the repository:
git clone https://github.com/Satchit4/Fexter.git
cd Fexter
  1. Create .env from example:
cp .env.example .env
  1. Fill required keys in .env. For market data, set one of:
  • FINANCIAL_DATASETS_API_KEY
  • MASSIVE_API_KEY (or POLYGON_API_KEY)
  • ALPHAVANTAGE_API_KEY

Base URL guidance:

  • Massive: https://api.massive.com (or https://api.polygon.io)
  • Alpha Vantage: https://www.alphavantage.co
  • Do not paste a full endpoint URL with query parameters into base URL fields.
  1. Build:
cargo build
  1. Optional: install globally as fexter:
cargo install --path .

Usage

# Quote
fexter -- quote AAPL --range 1mo --interval 1d

# Analyze
fexter -- analyze AAPL --with-llm

# Compare
fexter -- compare MSFT NVDA

# Scan
fexter -- scan --universe top500 --limit 25 --min-score 70

# Backtest single ticker
fexter -- backtest --ticker SPY --from 2022-01-01 --to 2025-01-01 --sweep "fast=10,20,30 slow=50,100,200"

# Backtest universe
fexter -- backtest --universe top500

# Watchlists
fexter -- watchlist create core
fexter -- watchlist add core AAPL
fexter -- watchlist list

# Report
fexter -- report AAPL --with-llm --format md

Output Modes

Most commands support:

  • default terminal table output
  • --json machine-readable output

Database and Cache

Default SQLite path:

  • .fexter/fexter.db

Cache entries are stored in cache_market_data with TTL control via FEXTER_CACHE_TTL_SECS.

Troubleshooting

  • Set ...API_KEY: add one market data key (FINANCIAL_DATASETS_API_KEY, MASSIVE_API_KEY, POLYGON_API_KEY, or ALPHAVANTAGE_API_KEY).
  • market data API returned 404: check base URL; for Massive use https://api.massive.com, for Alpha Vantage use https://www.alphavantage.co.
  • EXASEARCH_API_KEY is required: set Exa key in .env for analyze/scan/report.
  • missing data: provider response schema may differ; verify API base URL override variables.
  • Slow scan/backtest: reduce universe size or run ticker-specific commands first.

Security Notes

  • Never commit live API keys.
  • Keep .env local and ignored by git.

About

A Bloomberg-style Rust CLI for stock analysis, scanning, backtesting, and watchlists using live market-data APIs.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages