docs.rs failed to build marketsurge-agent-0.1.1
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

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

Crate	Description
`marketsurge-client`	HTTP client library for the MarketSurge GraphQL API
`marketsurge-agent`	CLI binary for querying market data

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. Pipe through jq for pretty-printing. Logs and errors go to stderr.

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

# Output as JSON objects instead of the default array-of-arrays format
marketsurge-agent --json-objects ownership summary AAPL

# 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

marketsurge-agent 0.1.1