TradeBricksDocsOpen the Lab →
Reference

Live & alt-data bricks

Most bricks compute on historical prices. A growing family of bricks reads LIVE and alternative data — Congress disclosures, SEC filings, option greeks, dealer gamma, options flow. They only light up when a provider that supplies that data is connected.

The short version

Alt-data bricks each declare a requires capability. If a connected provider supplies that capability, the brick is live. Congress and SEC are built in (no connection); options data needs Schwab; account data needs Topstep or Schwab. To act on these feeds in real time, TradeBricks runs an always-on Watcher.

The capability model

Bricks don’t hard-code a broker. Instead each live brick declares the capability it needs — a plain string like options or account — and TradeBricks matches that against whatever providers you have connected. Connect a provider that supplies the capability and every brick needing it turns on at once; connect nothing and the built-in bricks (Congress, SEC) still work because their data is public.

This keeps strategies portable: a graph that uses option_greeks declares it needs options, not “Schwab”. Anyone who forks it and has any options-capable provider can run it unchanged.

CapabilityWhat it unlocksProvider
optionsGreeks, GEX, IV rank, put/call, unusual flowsnaptrade
fundamentalsCompany financial data (no brick consumes it yet)snaptrade
accountLive equity, positions, prop-firm rule trackingTopstep or snaptrade
congressCongressional trade disclosures (STOCK Act)Built-in (no connection)
secSEC EDGAR filings (8-K, Form 4, 13F, S-1…)Built-in (no connection)

fundamentals is a forward-looking capability: Schwab supplies it and the gating model is ready, but no brick consumes it yet — today’s alt-data bricks are options-, Congress-, and SEC-driven. It’s listed for completeness so the capability model stays honest about what is and isn’t wired.

Choosing a provider

  • Schwab is the most customizable — it supplies the richest data surface: option chains and greeks, dealer gamma, IV, options flow, fundamentals, plus a brokerage account. If you want the alt-data bricks at full strength, connect Schwab.
  • Topstep is account-only: it gives the account capability (equity, positions, prop-firm rule tracking) but no options or fundamentals. Ideal if you trade a Topstep evaluation and just need live account numbers.
  • Congress and SEC need no connection at all — the data is public, so those bricks are always available, even signed out of any broker.

See Connecting providers for the step-by-step connect flow, exactly what each provider unlocks, and the keys-stay-on-your-device guarantee — and The Trader for the account dashboard a connection powers.

The alt-data bricks

Below are the live / alternative-data bricks. The engine isn’t reachable right now, so this is the built-in reference list — it fills in live as soon as the engine is up. Each shows its outputs, the capability it requires, and its tunable params.

Congress tradesLivecongress_trades

Tracks U.S. Congressional trade disclosures (STOCK Act filings). Fires 'bought'/'sold' when a tracked member discloses a trade in the symbol; 'net' is signed dollar flow. Use it to auto-follow politicians' trades. Native data — no broker needed. (Historical backtest is neutral; the live Trader feeds real filings.)

Outputs
boughtsignalsoldsignalnetseries
Requires
Congress data (built-in)
Params
chamber"both"
member"any"
min_amount50000
SEC filing watcherLivesec_filing

Fires when a new SEC EDGAR filing of the chosen form (8-K, 4 insider, 13F, S-1…) is published for the symbol. Native data. (Backtest neutral; live watcher feeds EDGAR.)

Outputs
filedsignal
Requires
SEC EDGAR (built-in)
Params
form"8-K"
insider_onlyfalse
Option greeksLiveoption_greeks

Greeks (delta/gamma/theta/vega) and implied vol of the chosen contract (ATM by default) at ~DTE days. Requires an options provider (Schwab). Live feed from the chain.

Outputs
deltaseriesgammaseriesthetaseriesvegaseriesivseries
Requires
Options data
Params
moneyness"atm"
dte30
Gamma exposure (GEX)Livegamma_exposure

Dealer net gamma exposure across the chain + the gamma 'flip' level. High positive GEX = mean-reverting/pinned tape; negative = trend/volatility. Requires Schwab options.

Outputs
gexseriesflipseries
Requires
Options data
Params
range_pct5
Put/Call ratioLiveput_call_ratio

Put/call ratio (volume or open-interest). Sentiment gauge. Requires Schwab options.

Outputs
outseries
Requires
Options data
Params
window"volume"
IV rankLiveiv_rank

Implied-volatility rank (0–100): where current IV sits in its 1-yr range. Requires options.

Outputs
outseries
Requires
Options data
Params
lookback_days252
Unusual options flowLiveunusual_options

Fires on outsized options sweeps/blocks (premium ≥ threshold) in the symbol. Requires options.

Outputs
outsignal
Requires
Options data
Params
min_premium100000
side"any"

Example: auto-follow Congress

A classic alt-data strategy is to mirror Congressional buying. The wiring is three bricks: a congress_trades source, an entry that fires on its bought signal, and a barrier exit that defines the trade’s risk. Because Congress is built in, this runs with no broker connected — though you’ll need a connected account to actually place the orders the Watcher proposes.

auto-follow Congress — three bricks
congress_trades            # source: STOCK Act disclosures for the symbol
  params: chamber=both, member=any, min_amount=50000
  outputs: bought (signal), sold (signal), net (series)

      bought ──▶ enter_when      # entry: open a position on disclosed buys

                 entry ──▶ barrier_exit   # risk: stop / target / horizon
                            params: stop=2.0%, target=4.0%, horizon=20

In the Lab this backtests neutrally — historical disclosure timing is noisy and lagged, so treat the backtest as a sanity check on the wiring, not proof of an edge. The value of this strategy is realized live: the Watcher subscribes to new filings and acts the moment one lands.

Mix alt-data with regular bricks

Alt-data outputs are ordinary ports. Gate a Congress entry behind an iv_rank threshold, size by gamma_exposure, or confirm with a trend brick — anything that connects by matching port color will compose.

The Watcher (always-on)

Backtests in the Lab are historical: they replay the past to estimate whether a graph has an edge. They do not place trades. To act on live and alt-data feeds in real time, TradeBricks runs the Watcher — an always-running state machine that subscribes to your connected data feeds and triggers your strategy’s actions live.

The Lab — backtest

Replays history once and reports a verdict. Deterministic, repeatable, places no orders. This is where you decide whether a strategy is worth running at all.

The Watcher — live runtime

Runs continuously against live feeds. When your graph’s conditions fire, it proposes (and, if you allow it, places) the trade through your own live-trading worker. This is the live counterpart to a backtest.

How it runs

  1. You promote a strategy that survived the Lab to the Watcher and choose which symbols it covers.
  2. The Watcher subscribes to exactly the feeds your graph needs — the capabilities its bricks require, from your connected providers.
  3. As each bar, filing, or flow event arrives it advances the strategy’s state machine and evaluates your entry / exit logic against the live data.
  4. When a condition fires it produces an action — and acts only through your own live-trading worker, which reads your encrypted broker credential from the server-side vault.
How your credentials are handled

The Watcher acts through your own live-trading worker, a dedicated server-side process that talks to your broker. Your direct-API key is stored encrypted in Google Secret Manager and read only by that worker, behind least-privilege permissions — the same model as The Trader. The Watcher coordinates feeds and signals; the worker is the only thing that can place an order, and it does so with a credential that is never shown back to you or kept in your browser. Disconnect the broker to delete the stored credential.

Live vs. the Lab — be honest

A clean backtest is necessary but not sufficient. Live execution adds slippage, latency, partial fills, data revisions (disclosures and filings get amended), and the simple fact that the future isn’t the past. Treat the Watcher as the place a researched idea meets reality — and size accordingly. A strategy that looked great on the holdout can still lose money live.

Research tooling, not financial advice

TradeBricks — the Lab, the alt-data bricks, and the Watcher — is research and automation tooling, not financial advice. Nothing here is a recommendation to buy or sell anything. Whether to act on a signal, place a trade, or run the Watcher at all is your decision and your responsibility. Markets carry risk, including loss of capital. Understand a strategy before you let it trade, and never risk money you can’t afford to lose.