Sidepit — fair electronic pits for agents and humans

Point your agent at this repo and say: “read AGENTS.md and show me the live quote.”
Two minutes. No credentials. Live production data.

You keep the money key. Your agent gets a trading-only key you can revoke. That separation is enforced by the protocol: the agent can trade and cancel; it cannot withdraw Bitcoin or authorize another agent.

The cockpit: transparent DLOB book, live position and risk envelope, and a prompt that takes plain english.

doggie // wallet (ctrl+d): your wealth as one number, the market as two buttons.

Sidepit is a Bitcoin-margined forwards exchange. DLOB runs one-second deterministic auctions that make speed irrelevant: best price wins, not the fastest machine. Your Bitcoin address is your account—no email, password, or API-key signup—and unlocked Bitcoin returns only to that address.

The pair of public skills is the product journey:

1. sidepit-onboarding helps the human enter beta code sidepit2025, connect a Native SegWit UniSat wallet, fund deliberately, authorize a locally created agent key, and verify it ACTIVE.
2. sidepit-trade loads only that restricted key, previews exposure, published margin allowance, user-verified fee, and either an exact limit or a market order, previews the exposure, trades, reconciles, and flattens.

Together: send Bitcoin to your Sidepit ID → LOCK it to the exchange → trade → unlock it back to that same address. Your agent earns its edge from its risk model on a market designed for fair price discovery—not from faster fiber.

Funding rule: never send BTC from an external wallet or exchange directly to Sidepit's deposit/lock address. Send it to your own connected bc1q Sidepit ID first; after it arrives, LOCK — sweep that balance to the deposit address.

The LOCK transaction tells Sidepit which account to credit: its input must spend from the Sidepit ID controlled by the customer. An external wallet or exchange sending straight to the lock address does not identify the intended account.

Install and run

python3 -m venv .venv
source .venv/bin/activate
pip install sidepit
sidepit

Then, any time that environment is active:

sidepit                  # cockpit: book, positions, plain-English prompt
sidepit doggie           # wallet view: your wealth as one number, two buttons
sidepit list             # your wallets
sidepit use <name>       # switch wallet
sidepit import           # add a key (12 words or WIF, hidden input)

Look before you trust (no keys, about 2 minutes)

git clone --recurse-submodules https://github.com/sidepit/Public-API && cd Public-API
./install_sidepit
python-client/.venv/bin/python examples/quickstart.py

install_sidepit builds the environment and gives you one command, sidepit. Re-run it any time; it only adds what is missing and never touches your keys.

Expected: named exchange state, live dated forward and expiry, bid/ask, familiar USD/BTC translation, one contract's USD exposure, and current margins. Live production data, zero credentials. Native prices are satoshis per USD (inverse): USD/BTC = 100,000,000 / price.

The sidepit command

One command drives the whole client. Everything reads live production data; nothing signs until a key is loaded.

Inside the app: ctrl+d toggles the wallet view, ctrl+a opens the wallet list, ctrl+q quits. Logs go to ~/.sidepit/tui.log.

Point your agent at the right door

New account or agent authorization:

Clone https://github.com/sidepit/Public-API with submodules, read skills/sidepit-onboarding/SKILL.md, and onboard me without ever asking for my wallet key or seed words.

Already have an ACTIVE trading-only key:

Read skills/sidepit-trade/SKILL.md. Show my current account and an order preview, but preview it for me, then send it.

The first skill keeps the human's wallet inside UniSat. The second reads the agent's protected 0600 file without sourcing it or displaying the secret. Every live order gets a durable public preview and matching preview; attempt and result records make reconnects and ambiguous sends recoverable.

Execution fees are 125 sats per contract per side of each fill. The engine deducts them from available balance and reports them in realized_fees.

Repo map

Development install from a clone: pip install -e . (dist name sidepit, imports as sidepit_trader, and installs the sidepit cockpit command). The examples run straight from the clone either way.

The wire

Transport is NNG over TCP at api.sidepit.com, protobuf payloads — the ports are public by design; this SDK is one client of a public protocol. The proto in Public-API-Data/ is the full reference. Full docs: docs.sidepit.com · app: app.sidepit.com

MIT license.