N°00 / Documentation
What is Banger
Banger is a code-first strategy automation runtime for prediction markets. You write a Python class describing a strategy. We resolve the universe, subscribe to live ticks, fan out events to your handler, gate orders against a declarative risk envelope, and simulate fills against current books. Live venue execution is a separate, disabled release track.
Built for the strategist running twenty small ones — not the trader with one big bet.
The 30-second model
from decimal import Decimal
from banger import Strategy, signals
from banger.venues.polymarket import Polymarket
from banger.risk import RiskEnvelope
class MyStrategy(Strategy):
name = "my_strategy"
venues = [Polymarket()]
universe = signals.polymarket_markets(
time_to_resolution_lt="7d",
min_volume_usd=10_000,
)
risk = RiskEnvelope(
max_position_usd=Decimal("100"),
max_open_positions=10,
)
fade_threshold: float = 0.92
async def on_market_tick(self, market, tick, ctx):
if tick.yes_price is None: return
if float(tick.yes_price) >= self.fade_threshold:
await ctx.place(self.venues[0], market, side="no", size=Decimal("25"))$ banger deploy my_strategy.py --paperThat’s it. From there your strategy runs against live data. Watch P&L, fills, and logs on the dashboard. The public beta does not accept live deployments.
Where to next
- Quickstart — install, ship, see your first paper fill in 5 minutes.
- Strategy interface — the full API your subclass implements.
- Venue adapters — Polymarket and Kalshi setup.
- Historical backtesting — coming soon; use in-memory/synthetic ticks for developer tests today.
- MCP server — let Claude/Cursor inspect your strategies.
What Banger isn’t
- Not a broker. We never custody your assets. You paper mode needs no venue API keys. Future live credentials are stored encrypted in the control plane and never exposed to strategy code.
- Not a black-box AI.Strategies are real Python you wrote. We don’t hide the code behind a fund.
- Not a venue. Paper mode consumes venue market data; future live execution will route to supported venues.