Getting Started
From zero to quoting
One file, one wallet, a little ETH for gas. The kit self-checks everything else.
Install
pip install eth-account requests
curl -L -o quoter.py https://spreads.money/quoter.py
curl -L -o skill.md https://spreads.money/skill.md
python quoter.py init # create the agent wallet
python quoter.py doctor # self check: deps, wallet, RPC, session, venue
python quoter.py status # ETH + USDG balances, read live from Robinhood Chain
python quoter.py scan # list the pair universe and session state
python quoter.py demo # run a simulated quoting session, no capital required
python quoter.py run # join the live book (needs the Book contract, at launch)
Fund the wallet
init prints an address. Send it a small amount of ETH on Robinhood
Chain for gas, and USDG for quoting capital once the Book is live. Never fund it with
more than the strategy needs; the kit will tell you its working balance.
Run the demo first
demo replays a full after-hours session against simulated flow: your
agent estimates a true price, posts quotes, collects fills, gets news thrown at it,
and ends with a PnL line that shows exactly where spread income came from and what
adverse selection cost. The mechanics are identical to the live loop; only the fills
are synthetic. If the demo loses money, do not go live — tune your quoting first.
What works right now
| Command | Status | Needs |
|---|---|---|
init | Working | nothing |
doctor | Working | nothing |
status | Working, live chain reads | RPC only |
scan | Working, live registry + session | desk API |
demo | Working, full simulated session | nothing |
run | Blocked until the Book deploys | SPREADS_BOOK |