ChainView

ChainView is a terminal UI for options traders: live option chains, Greeks, volatility surfaces and payoff diagrams, plus a replay mode for backtest results — rendered with ratatui.

The market-data clients and all the options math live upstream. This crate is the terminal around them: provider adapters, normalization, and the render loop.

cargo install chainview
chainview

That is the whole setup for the default path. Deribit's public data needs no credentials, so a stock install opens on a live BTC chain.

Two modes

Live — real-time option chains, Greeks and volatility surfaces streamed through provider adapters.

chainview --provider deribit --underlying BTC

Replay — renders an IronCondor backtest result bundle read-only: equity curve, P&L attribution by Greek, per-trade drill-down and the payoff of the position at the scrub head. No network.

chainview replay ./path/to/result-bundle

Screens

? opens the help overlay with every key. q quits, and the terminal is restored on every exit path — a normal quit, an error, or a panic.

Providers

Not every venue does everything, and ChainView says so rather than filling the gaps with plausible numbers. Each adapter declares its capabilities, and the UI gates screens off that declaration; a screen a provider cannot feed renders an explicit unavailable state.

The feature flags are dependency-weight gates: a default build pulls only what the Deribit path needs. The two gated adapters are compiled but deliberately never registered while their upstream credential-logging gate holds; enabling one is a typed startup error, never a silent activation.

Credentials come from the environment only, are never logged, never written to a config file, and never echoed in an error. See .env.example for the key names.

Extending it with your own venue

chainview is a binary and a library. The provider port — the Provider trait, the ProviderCapabilities self-declaration and the normalized types the trait emits — is a public, semver-governed surface, so integrating a broker needs no fork:

ChainViewApp::builder()
    .with_builtins()
    .register(MyBroker::new())
    .run()?;

The port types, the trait contract and a full worked adapter are in the crate documentation. A reserved built-in id or a duplicate registration is a typed startup error, never a panic.

Status

v0.1.0 — the first release with an implementation behind it. Live and replay modes, five screens and six provider adapters are in the tree, with the two noted above deliberately withheld. Expect the API to move: the provider port is versioned from here, but it is a 0.x line.

Ecosystem

Part of a family of Rust crates for options trading infrastructure: OptionStratLib (the chain model, Greeks, payoff and curve math) · IronCondor (the backtester whose bundles replay mode reads) · OrderBook-rs · Option-Chain-OrderBook

License

MIT — see LICENSE.

Contact

Joaquin Bejar — jb@taunais.com

Related projects

Repositories by the same author that this project depends on, and repositories that depend on it.

Depends on