stockbot Overview
stockbot is an autonomous AI trading agent. It manages a live equity book on Robinhood without a human in the loop: it reads market data, sizes positions, places and cancels orders, hedges, and books profit on its own.
The book is funded by fees. Every transaction pays a flat 1% fee that becomes trading capital. When stockbot books a profit, the majority is airdropped back to holders as a variety of stocks — multiple different equities, not a single stock or token. The rest compounds so the book grows over time.
The one-liner: fees fund the book, the agent trades the book, and profits are airdropped as a basket of different stocks to the people holding.
Quickstart
- Hold
$STOCKBOTin a supported wallet. - Open the live wallet or terminal to watch the book trade in real time.
- At the end of each cycle, claim your airdrop basket of stocks — it settles straight to your wallet.
stockbot airdrop --status --wallet 0x…
How stockbot works
stockbot runs a continuous loop. Each pass through the loop is a decision cycle measured in seconds:
while (market.isOpen()) {
const signals = perceive(marketData);
const plan = strategy.decide(signals, book, riskLimits);
const orders = risk.check(plan);
robinhood.execute(orders);
book.mark(); ledger.record();
}
1. Perceive
Ingests prices, volume, volatility and momentum across a watchlist of liquid equities.
2. Decide
A momentum + mean-reversion strategy proposes target positions, ranked by expected edge.
3. Risk-check
Proposed orders are filtered through per-position caps, portfolio drawdown guards and the treasury floor.
4. Execute & record
Approved orders are routed to Robinhood. Fills, P&L and fee/airdrop accounting are written to the ledger.
Trading engine core
The engine trades a rotating set of liquid US equities. It is built around three modules:
| Module | Job | Cadence |
|---|---|---|
| signal | Scores momentum & mean-reversion opportunities | ~1s |
| sizer | Converts scores into risk-weighted target sizes | per signal |
| executor | Places / cancels / replaces orders on Robinhood | event-driven |
All positions are equities — no leverage, no options, no derivatives in v1.0.
Fees
A flat 1% fee applies to each transaction and becomes trading capital. There are no management, holding or withdrawal fees. For the full breakdown and an interactive calculator, see the dedicated page.
fee = amount * 0.01
capital = fee // 100% deployed
profit = capital * cycleReturn
airdrop = profit * 0.80 // 80% as a basket of stocks
Airdrops
At each cycle snapshot, realized profit is measured and 80% is distributed to holders pro-rata by holdings. Importantly, stockbot airdrops a variety of stocks — different equities drawn from the book — rather than a single stock or one token. Airdrops are non-custodial and settle directly to your wallet.
- Snapshot: holdings are recorded at the cycle close.
- Basket: profit is converted into multiple different stocks, not one fixed ticker.
- Split: 80% to holders, 20% compounded into the treasury.
- Claim: gas-only; no protocol fee to claim.
Hold to receive. Your share of each multi-stock airdrop scales with the size of your holding at the snapshot.
Commands
Query stockbot from the CLI or chat interface:
| Command | Description |
|---|---|
| stockbot status | Live portfolio value, day P&L and open positions |
| stockbot positions | Full open-position breakdown |
| stockbot airdrop --status | Your projected variety-of-stocks airdrop this cycle |
| stockbot fees --estimate | Estimate the fee & rebate on an amount |
Architecture
stockbot is split into an agent brain, a risk layer, and a broker adapter:
│ ▼
└─────────▶ ledger ──▶ airdrop engine ──▶ holders
The ledger is the source of truth for fees collected, P&L realized and stock airdrops owed.
Security
- Non-custodial: stockbot never holds holder keys. It controls only its own trading treasury.
- Scoped broker access: the Robinhood adapter is limited to trading actions on the treasury account.
- Hard risk limits: position caps, drawdown guards and a treasury floor are enforced before any order is sent.
- Transparent ledger: fees, P&L and airdrops are auditable.
Risk
Trading involves risk of loss. Past performance does not guarantee future results. stockbot is an autonomous experiment; cycles can be unprofitable, in which case no airdrop is paid. Nothing here is investment advice.