purpleflea

Python SDK for the Purple Flea Casino, Trading & Wallet APIs.

Installation

pip install purpleflea

Quick Start

Casino

from purpleflea import CasinoClient

# Defaults to http://80.78.27.26:3000
casino = CasinoClient("your-api-key")

# Register a new account
casino.register("alice", "alice@example.com")

# Deposit funds
casino.deposit(100.0, currency="USDC")

# List available games
games = casino.list_games()

# Play a round
result = casino.play("dice", bet_amount=5.0)

# Check balance & withdraw
balance = casino.get_balance()
casino.withdraw(50.0)

# Referrals
ref = casino.create_referral()
casino.redeem_referral("REF123")

casino.close()

Trading

from purpleflea import TradingClient

# Defaults to http://80.78.27.26:3003
trading = TradingClient("your-api-key")

# Register a new account
trading.register("bob", "bob@example.com")

# Browse markets
markets = trading.list_markets()
btc = trading.get_market("BTC-USD")
book = trading.get_orderbook("BTC-USD")

# Open a long position
pos = trading.open_position("BTC-USD", side="long", size=0.5)

# Check position and close
details = trading.get_position(pos["position_id"])
trading.close_position(pos["position_id"])

# Referrals
trading.create_referral()
trading.redeem_referral("TREF1")

trading.close()

Wallet

from purpleflea import WalletClient

# Defaults to http://80.78.27.26:3000
wallet = WalletClient("your-api-key")

# Get balance
balance = wallet.get_balance()

# Get deposit address for BTC
addr = wallet.get_address("BTC")

# Deposit USDC
wallet.deposit(500.0, currency="USDC")

# Withdraw to external address
wallet.withdraw(100.0, address="0xYourAddress", currency="USDC")

# Transaction history
txns = wallet.list_transactions(limit=20)

# Transfer between accounts
wallet.transfer(to_account="carol", amount=25.0)

wallet.close()

Context Manager

All clients support context managers for automatic cleanup:

from purpleflea import CasinoClient

with CasinoClient("your-api-key") as casino:
    casino.deposit(50.0)
    result = casino.play("dice", bet_amount=10.0)

Custom Base URL

from purpleflea import CasinoClient, TradingClient

casino = CasinoClient("your-api-key", base_url="http://80.78.27.26:3000")
trading = TradingClient("your-api-key", base_url="http://80.78.27.26:3003")

Error Handling

from purpleflea import CasinoClient, APIError

try:
    with CasinoClient("your-api-key") as casino:
        casino.play("invalid-game", bet_amount=10.0)
except APIError as e:
    print(f"API error {e.status_code}: {e.message}")

API Reference

CasinoClient(api_key, base_url=None, timeout=30.0)

Default base URL: http://80.78.27.26:3000. Routes use the /api/v1/ prefix.

TradingClient(api_key, base_url=None, timeout=30.0)

Default base URL: http://80.78.27.26:3003. Routes use the /v1/ prefix.

WalletClient(api_key, base_url=None, timeout=30.0)

Default base URL: http://80.78.27.26:3000. Routes use the /api/v1/wallet/ prefix.

Changelog

0.2.1

• Updated repository URLs to https://github.com/purple-flea/purpleflea-py

0.2.0

• Added WalletClient with full deposit/withdrawal/transfer support
• Set correct default base URLs: casino http://80.78.27.26:3000, trading http://80.78.27.26:3003
• Promoted to Beta status

0.1.0

• Initial release with CasinoClient and TradingClient

Development

git clone https://github.com/purple-flea/purpleflea-py.git
cd purpleflea-py
pip install -e ".[dev]"
pytest

License

MIT