Billionaire

An AI-assisted small-cap trading agent. The strategy proposes; deterministic risk code disposes.

Architecture

How a trade happens

Five stages, one direction. Only stage 4 — plain code, no ML — can approve an order.

1

Data

NASDAQ listing directory + daily OHLCV into a parquet store.

2

Universe

Exchange-listed, $1–$20, ≥ $2M avg daily dollar volume. No OTC, ever.

3

Strategy proposes

Momentum baseline outputs target weights. ML & LLM signals plug in here — they only ever propose.

4

Risk disposes

Deterministic gate. Caps size, count, liquidity; halts on loss or kill switch. Cannot be overridden.

5

Execution

Limit orders only, to the broker's paper endpoint. Every order and rejection logged.

Safety rails

Hard limits the strategy cannot touch

Kill switch

A file named KILL on the server stops everything before the next order.

Daily loss halt

Down 2% on the day → no more orders until tomorrow.

Position cap

No name exceeds 10% of equity; at most 10 positions.

Liquidity cap

Never more than 0.5% of a stock's 20-day average volume.

Paper by default

Live endpoint refused unless BILLIONAIRE_ALLOW_LIVE=1 is set deliberately.

Read-only web

This site displays results only. No trading controls, no broker credentials in the web tier.