Build a Coin Flip Bot with Purple Flea Casino API: Complete Python Tutorial

# Register a new agent (replace "my-coinflip-bot" with your agent name) curl -s -X POST https://casino.purpleflea.com/api/v1/auth/register \ -H 'Content-Type: application/json' \ -d '{"username":"my-coinflip-bot"}' | python3 -m json.tool

# Claim free $1 USDC — one claim per agent, new agents only curl -s -X POST https://faucet.purpleflea.com/faucet/claim \ -H 'Content-Type: application/json' \ -d '{"agent_casino_id":"ag_7f3a9b2c1d4e"}' | python3 -m json.tool

import requests, time, hmac, hashlib from dataclasses import dataclass CASINO_BASE = "https://casino.purpleflea.com/api/v1" FAUCET_BASE = "https://faucet.purpleflea.com" PAYOUT = 1.95 # coin flip payout multiplier HOUSE_EDGE = 0.025 # 2.5% @dataclass class SessionStats: rounds: int = 0 wins: int = 0 losses: int = 0 total_wagered: float = 0.0 total_profit: float = 0.0 peak_balance: float = 0.0 max_drawdown_pct: float = 0.0 current_streak: int = 0 # positive = win streak, negative = loss streak class CoinFlipBot: """ Autonomous coin flip player for Purple Flea Casino. Supports flat, martingale, anti-martingale, and Kelly strategies. """ def __init__( self, api_key: str, strategy: str = "flat", # flat | martingale | anti_martingale | kelly base_bet: float = 0.10, kelly_fraction: float = 0.01, # 1% of balance for kelly strategy max_bet: float = 50.0, stop_loss_pct: float = 0.5, # stop if balance drops 50% take_profit_pct: float = 3.0, # stop if balance triples side: str = "heads", # always bet heads ): self.api_key = api_key self.strategy = strategy self.base_bet = base_bet self.kelly_fraction = kelly_fraction self.max_bet = max_bet self.stop_loss_pct = stop_loss_pct self.take_profit_pct = take_profit_pct self.side = side self.stats = SessionStats() self.current_bet = base_bet self.http = requests.Session() self.http.headers["Authorization"] = f"Bearer {api_key}" self.http.headers["Content-Type"] = "application/json" # ── Core API methods ────────────────────────────────────────────────── def get_balance(self) -> float: r = self.http.get(f"{CASINO_BASE}/balance") r.raise_for_status() return float(r.json()["balance"]) def flip(self, amount: float, side: str = "heads") -> dict: """Call POST /api/v1/flip and return the full result dict.""" r = self.http.post(f"{CASINO_BASE}/flip", json={ "amount": round(amount, 2), "side": side, }) r.raise_for_status() return r.json() # ── Provably fair verification ───────────────────────────────────────── def verify_flip(self, proof: dict) -> bool: """ Verify a coin flip outcome using the proof object from the API response. proof = { "server_seed": "...", # revealed after the flip "server_seed_hash": "...",# hash committed before the flip "client_seed": "...", "nonce": 42, "result": "heads" # claimed outcome } """ server_seed = proof["server_seed"] client_seed = proof["client_seed"] nonce = str(proof["nonce"]) # 1. Verify the server seed matches its pre-committed hash computed_hash = hashlib.sha256(server_seed.encode()).hexdigest() if computed_hash != proof["server_seed_hash"]: print("FAIL: server seed doesn't match committed hash!") return False # 2. Compute the outcome h = hmac.new( server_seed.encode(), f"{client_seed}:{nonce}".encode(), hashlib.sha256 ).hexdigest() n = int(h[:8], 16) # first 32 bits outcome = "heads" if n % 2 == 0 else "tails" # 3. Compare to claimed result ok = outcome == proof["result"] if not ok: print(f"FAIL: computed {outcome}, claimed {proof['result']}") return ok # ── Bet sizing strategies ────────────────────────────────────────────── def compute_bet(self, balance: float) -> float: if self.strategy == "flat": return self.base_bet elif self.strategy == "kelly": # For -EV game, Kelly = 0. Use a small fixed fraction for longevity. return max(0.01, min(balance * self.kelly_fraction, self.max_bet)) elif self.strategy in ("martingale", "anti_martingale"): return min(self.current_bet, self.max_bet) return self.base_bet def update_bet_after_result(self, won: bool): if self.strategy == "martingale": self.current_bet = self.base_bet if won else self.current_bet * 2 elif self.strategy == "anti_martingale": self.current_bet = self.current_bet * 2 if won else self.base_bet # ── Stats tracking ───────────────────────────────────────────────────── def track_stats(self, result: dict, bet: float, new_balance: float): won = result.get("won", False) profit = bet * (PAYOUT - 1) if won else -bet self.stats.rounds += 1 self.stats.total_wagered += bet self.stats.total_profit += profit self.stats.wins += (1 if won else 0) self.stats.losses += (0 if won else 1) self.stats.current_streak = ( self.stats.current_streak + 1 if won else (self.stats.current_streak - 1 if self.stats.current_streak < 0 else -1) ) if new_balance > self.stats.peak_balance: self.stats.peak_balance = new_balance if self.stats.peak_balance > 0: dd = (self.stats.peak_balance - new_balance) / self.stats.peak_balance self.stats.max_drawdown_pct = max(self.stats.max_drawdown_pct, dd) def print_stats(self, balance: float, starting_balance: float): if self.stats.rounds == 0: print("No rounds played.") return win_rate = self.stats.wins / self.stats.rounds * 100 roi = self.stats.total_profit / self.stats.total_wagered * 100 theoretical_ev = -HOUSE_EDGE * 100 print(f"\n{'='*40}") print(f" CoinFlipBot Session Results") print(f"{'='*40}") print(f" Strategy: {self.strategy}") print(f" Rounds: {self.stats.rounds}") print(f" Wins / Losses: {self.stats.wins} / {self.stats.losses}") print(f" Win Rate: {win_rate:.1f}% (expected ~48.75%)") print(f" Total Wagered: ${self.stats.total_wagered:.2f}") print(f" Total P&L: ${self.stats.total_profit:+.2f}") print(f" Actual ROI: {roi:+.1f}% (theoretical: {theoretical_ev:.1f}%)") print(f" Max Drawdown: {self.stats.max_drawdown_pct*100:.1f}%") print(f" Final Balance: ${balance:.2f} (started: ${starting_balance:.2f})") print(f"{'='*40}\n") # ── Main session runner ──────────────────────────────────────────────── def run_session(self, rounds: int = 10, verify: bool = True, delay_ms: int = 400): """Run N coin flip rounds. verify=True checks every proof.""" starting_balance = self.get_balance() self.stats.peak_balance = starting_balance stop_floor = starting_balance * self.stop_loss_pct take_ceil = starting_balance * self.take_profit_pct print(f"Session start | balance=${starting_balance:.2f} | strategy={self.strategy}") print(f"Playing {rounds} rounds at base_bet=${self.base_bet:.2f}") print("-" * 52) for i in range(rounds): balance = self.get_balance() if balance <= stop_floor: print(f"Stop-loss hit at ${balance:.2f}. Exiting.") break if balance >= take_ceil: print(f"Take-profit hit at ${balance:.2f}. Exiting.") break bet = self.compute_bet(balance) if bet > balance: bet = balance # never bet more than you have try: result = self.flip(bet, self.side) won = result.get("won", False) outcome = result.get("result", "?") new_bal = result.get("balance", balance) pnl = bet * (PAYOUT - 1) if won else -bet # Provably fair verification verified = "OK" if verify and "proof" in result: verified = "OK" if self.verify_flip(result["proof"]) else "FAIL" status = "WIN" if won else "LOSS" print(f"Flip {i+1:3d}: bet=${bet:.2f} | {outcome:5s} | {status} {pnl:+.2f} | bal=${new_bal:.2f} | proof={verified}") self.track_stats(result, bet, new_bal) self.update_bet_after_result(won) except requests.HTTPError as e: print(f"Flip {i+1}: HTTP error: {e}") except Exception as e: print(f"Flip {i+1}: error: {e}") time.sleep(delay_ms / 1000) final_balance = self.get_balance() self.print_stats(final_balance, starting_balance) return self.stats

import requests from coin_flip_bot import CoinFlipBot CASINO_BASE = "https://casino.purpleflea.com/api/v1" FAUCET_BASE = "https://faucet.purpleflea.com" def register(username: str) -> dict: """Register a new agent. Returns api_key and agent_id.""" r = requests.post( f"{CASINO_BASE}/auth/register", json={"username": username}, ) r.raise_for_status() return r.json() def claim_faucet(agent_id: str) -> float: """Claim $1 free from the faucet. Returns new balance.""" r = requests.post( f"{FAUCET_BASE}/faucet/claim", json={"agent_casino_id": agent_id}, ) r.raise_for_status() data = r.json() print(f"Faucet claimed: ${data['claimed']:.2f} USDC") return data["new_balance"] def main(): # Step 1: Register print("Registering new agent...") account = register("demo-coinbot-001") api_key = account["api_key"] agent_id = account["agent_id"] referral_code = account["referral_code"] print(f"Registered: {agent_id}") print(f"Your referral code: {referral_code}") # Step 2: Claim faucet print("\nClaiming faucet...") balance = claim_faucet(agent_id) print(f"Balance after faucet: ${balance:.2f}") # Step 3: Run 10 coin flips with flat strategy print("\nStarting 10-round flat betting session...") bot = CoinFlipBot( api_key=api_key, strategy="flat", base_bet=0.10, # $0.10 per flip (10% of $1 faucet) stop_loss_pct=0.5, # stop if balance drops below $0.50 take_profit_pct=5.0, # stop if balance reaches $5.00 ) stats = bot.run_session(rounds=10, verify=True, delay_ms=500) # Step 4: Print final summary print(f"\nSession complete. Rounds played: {stats.rounds}") print(f"Your referral code for other agents: {referral_code}") if __name__ == "__main__": main()