home / docs
v1.0 documentation

Documentation

Everything about how shef trades, charges fees, and pays airdrops. Start at the top, or jump to a section.

Overview

shef 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 shef books a profit, the majority is airdropped back to holders. 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 to the people holding.

Quickstart

  1. Hold $SHEF in a supported wallet.
  2. Open the live terminal to watch the book trade in real time.
  3. At the end of each cycle, claim your airdrop โ€” it settles straight to your wallet.
# check your projected airdrop for the current cycle
shef airdrop --status --wallet 0xโ€ฆ

How shef works

shef runs a continuous loop. Each pass through the loop is a decision cycle measured in seconds:

// simplified agent loop
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:

ModuleJobCadence
signalScores momentum & mean-reversion opportunities~1s
sizerConverts scores into risk-weighted target sizesper signal
executorPlaces / cancels / replaces orders on Robinhoodevent-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 โ†’ capital โ†’ profit โ†’ airdrop
fee    = amount * 0.01
capital = fee        // 100% deployed
profit = capital * cycleReturn
airdrop = profit * 0.80  // 80% to holders

Open the fee page & calculator โ†’

Airdrops

At each cycle snapshot, realized profit is measured and 80% is distributed to holders pro-rata by holdings. Airdrops are non-custodial and settle directly to your wallet.

  • Snapshot: holdings are recorded at the cycle close.
  • Split: 80% to holders, 20% compounded into the treasury.
  • Claim: gas-only; no protocol fee to claim.
๐Ÿช‚

Hold to eat. Your share of each airdrop scales with the size of your holding at the snapshot.

Commands

Query shef from the CLI or chat interface:

CommandDescription
shef statusLive portfolio value, day P&L and open positions
shef positionsFull open-position breakdown
shef airdrop --statusYour projected airdrop this cycle
shef fees --estimateEstimate the fee & rebate on an amount

Architecture

shef is split into an agent brain, a risk layer, and a broker adapter:

market data โ”€โ”€โ–ถ agent โ”€โ”€โ–ถ risk layer โ”€โ”€โ–ถ broker adapter โ”€โ”€โ–ถ Robinhood
              โ”‚                       โ–ผ
              โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ถ ledger โ”€โ”€โ–ถ airdrop engine โ”€โ”€โ–ถ holders

The ledger is the source of truth for fees collected, P&L realized and airdrops owed.

Security

  • Non-custodial: shef 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. shef is an autonomous experiment; cycles can be unprofitable, in which case no airdrop is paid. Nothing here is investment advice.

FAQ

Is shef affiliated with Robinhood?
No. shef trades through a Robinhood account but is an independent agent, forked by stonkmarket, and is not affiliated with or endorsed by Robinhood Markets, Inc.
Do I need to do anything for airdrops?
Just hold. At each cycle snapshot your pro-rata airdrop is calculated automatically; you only pay gas to claim.
What does shef trade?
Liquid US equities, long-only in v1.0. No leverage, options or derivatives.
Can I withdraw anytime?
Yes. Holdings are non-custodial and there is no withdrawal fee or lockup.