marketsurge-rs

Unofficial Rust client library and CLI for querying market data from MarketSurge.

Disclaimer: This project is not affiliated with, endorsed by, or sponsored by Investor's Business Daily (IBD), MarketSurge, or Dow Jones & Company. MarketSurge is a trademark of Dow Jones & Company. Use of this software is at your own risk.

Workspace crates

marketsurge-agent depends on marketsurge-client. The client crate has no dependency on the agent.

Installation

Pre-built binaries

Download a binary from the latest release. Builds are available for Linux, macOS, and Windows.

cargo-binstall

cargo binstall marketsurge-agent

Build from source

cargo install --path agent

Requires Rust 1.95.0 or later.

Usage

The CLI reads browser cookies from Firefox automatically for authentication. Log in to MarketSurge in your browser first, then run commands.

Output goes to stdout as compact JSON with all fields included by default. Use --fields with a comma-delimited list to keep only selected top-level JSON fields. Pipe through jq for pretty-printing. Logs and errors go to stderr.

# Fund ownership summary for a stock
marketsurge-agent ownership summary AAPL

# Limit output to selected top-level fields
marketsurge-agent --fields symbol,num_funds_held ownership summary AAPL

# Find saved watchlists or screens by ID or name, including punctuation-insensitive matches like IBD 50
marketsurge-agent watchlist list --query ibd
marketsurge-agent screen list --query ibd

# Generate shell completions
marketsurge-agent completions zsh > _marketsurge-agent

Development

# Full check (fmt + clippy + test + docs)
make check

# Individual targets
make fmt        # cargo +nightly fmt
make clippy     # cargo clippy -- -D clippy::all
make test       # cargo test --workspace
make doc        # cargo doc with -D warnings

# Coverage (90% line minimum enforced)
make coverage

# Live integration tests (requires browser cookies)
make integration

License

Apache-2.0