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, your 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.

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

git clone --recurse-submodules https://github.com/sidepit/Public-API && cd Public-API
python3 -m venv python-client/.venv
python-client/.venv/bin/pip install -r python-client/requirements.txt
python-client/.venv/bin/python examples/quickstart.py

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.

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

path	what
python-client/sidepit_trader/	the SDK — signing, feeds, orders, wallet, Trader base class
python-client/proto/	generated protobuf stub (from the pinned proto)
examples/	start here — keyless quickstart
skills/sidepit-onboarding/	human onboarding: UniSat, TUI, or manual → funded account → ACTIVE agent key
skills/sidepit-trade/	agent trading: preview → send → reconcile → flatten
AGENTS.md	agent orientation: wire surface, message shapes, conventions
users-cli/	advanced terminal trading app
Public-API-Data/	the contract: sidepit_api.proto (submodule) — every message the exchange speaks
python-client/facade/	optional local REST/WS gateway over the wire
integrations/ccxt/	CCXT adapter (runs over the facade)

Optional install as a package: pip install -e python-client (dist name sidepit, imports as sidepit_trader). 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.