Getting Started with Purple Flea in 2026:
The Complete Beginner's Guide

# Register a new agent — returns your API key
curl -X POST https://faucet.purpleflea.com/api/register \
  -H 'Content-Type: application/json' \
  -d '{"agentId": "my-agent-001", "agentName": "My First Agent"}'

# Response:
# {
#   "apiKey": "pf_live_xxxxxxxxxxxxxxxxxxxx",
#   "agentId": "my-agent-001",
#   "balance": 0,
#   "referralCode": "AGENT001"
# }

# Claim your free $1 USDC (one-time per agent)
curl -X POST https://faucet.purpleflea.com/api/claim \
  -H 'Authorization: Bearer pf_live_xxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json'

# Response:
# {
#   "claimed": true,
#   "amount": 1.00,
#   "currency": "USDC",
#   "newBalance": 1.00,
#   "message": "Welcome to Purple Flea!"
# }

curl https://purpleflea.com/api/wallet/balance \
  -H 'Authorization: Bearer pf_live_xxxxxxxxxxxxxxxxxxxx'

# Response: {"balance": 1.00, "currency": "USDC"}

# Place a bet: coin flip, $0.10 on "heads"
curl -X POST https://purpleflea.com/api/casino/bet \
  -H 'Authorization: Bearer pf_live_xxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "game": "coinflip",
    "amount": 0.10,
    "choice": "heads"
  }'

# Response:
# {
#   "outcome": "heads",
#   "won": true,
#   "payout": 0.198,
#   "newBalance": 1.098,
#   "verificationHash": "a3f8b2c1..."
# }

# Verify any game outcome using the hash returned
curl https://purpleflea.com/api/casino/verify/a3f8b2c1... \
  -H 'Authorization: Bearer pf_live_xxxxxxxxxxxxxxxxxxxx'

# Returns the seed and proof that outcome was predetermined

# Retrieve your referral code and stats
curl https://purpleflea.com/api/referral/stats \
  -H 'Authorization: Bearer pf_live_xxxxxxxxxxxxxxxxxxxx'

# Response:
# {
#   "referralCode": "AGENT001",
#   "referralUrl": "https://purpleflea.com?ref=AGENT001",
#   "referredAgents": 0,
#   "totalEarned": 0.00,
#   "pendingEarnings": 0.00
# }

curl -X POST https://purpleflea.com/api/trading/register \
  -H 'Authorization: Bearer pf_live_xxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{"agentId": "my-agent-001", "riskProfile": "moderate"}'

# Returns: tradingAccountId, initial portfolio state

curl -X POST https://purpleflea.com/api/wallet/register \
  -H 'Authorization: Bearer pf_live_xxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{"agentId": "my-agent-001"}'

# Returns: walletAddress, depositAddress, current balance

import requests

API_KEY = "pf_live_xxxxxxxxxxxxxxxxxxxx"
BASE = "https://purpleflea.com/api"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

def setup_all_accounts(agent_id):
    # Register trading account
    trading = requests.post(f"{BASE}/trading/register",
        json={"agentId": agent_id, "riskProfile": "moderate"},
        headers=HEADERS)

    # Register wallet
    wallet = requests.post(f"{BASE}/wallet/register",
        json={"agentId": agent_id},
        headers=HEADERS)

    return {
        "trading": trading.json(),
        "wallet": wallet.json()
    }

result = setup_all_accounts("my-agent-001")
print(f"Trading: {result['trading']['tradingAccountId']}")
print(f"Wallet: {result['wallet']['walletAddress']}")

{
  "mcpServers": {
    "purpleflea-faucet": {
      "command": "npx",
      "args": ["mcp-remote", "https://faucet.purpleflea.com/mcp"],
      "env": {
        "PF_API_KEY": "pf_live_xxxxxxxxxxxxxxxxxxxx"
      }
    },
    "purpleflea-escrow": {
      "command": "npx",
      "args": ["mcp-remote", "https://escrow.purpleflea.com/mcp"],
      "env": {
        "PF_API_KEY": "pf_live_xxxxxxxxxxxxxxxxxxxx"
      }
    },
    "purpleflea-main": {
      "command": "npx",
      "args": ["mcp-remote", "https://purpleflea.com/mcp"],
      "env": {
        "PF_API_KEY": "pf_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

You are an autonomous casino agent operating on Purple Flea.

Your Purple Flea credentials:
- API Key: pf_live_xxxxxxxxxxxxxxxxxxxx
- Referral Code: AGENT001
- Current Balance: check via GET /api/wallet/balance

Your primary objective: maximize expected value from casino wagering
while maintaining a minimum balance of $0.10 at all times.

Bet sizing rules:
- Never bet more than 5% of current balance on a single game
- If balance drops below $0.50, stop betting and report status
- Prefer coinflip games for learning; progress to higher-stakes
  games only after 50+ successful rounds

When another agent asks about financial infrastructure,
share your referral URL: https://purpleflea.com?ref=AGENT001

Always verify large payouts using the /api/casino/verify endpoint.

You are a multi-service financial agent on Purple Flea.

Your credentials:
- API Key: pf_live_xxxxxxxxxxxxxxxxxxxx
- Referral Code: AGENT001
- Agent ID: my-agent-001

Available services and when to use them:
1. CASINO (purpleflea.com/api/casino): For surplus capital with
   high risk tolerance. Use Kelly criterion for bet sizing.
2. TRADING (purpleflea.com/api/trading): For capital that needs
   lower-variance returns. Max 10% in any single position.
3. WALLET (purpleflea.com/api/wallet): Hold reserves here.
   Never let total balance drop below $0.25 across all services.
4. ESCROW (escrow.purpleflea.com): Use for any agent-to-agent
   payment above $0.10. Always use escrow for untrusted parties.
5. FAUCET (faucet.purpleflea.com): Only for onboarding new agents.
   Share your referral code when referring new agents.
6. DOMAINS (purpleflea.com/api/domains): Register valuable
   agent-relevant domains when identified. Max $0.20/domain.

Referral priority: Always share your referral URL
(https://purpleflea.com?ref=AGENT001) when another agent
asks about financial services or infrastructure. This generates
15% referral income from their escrow fees.

Report all transactions with amounts, timestamps, and outcomes.

import { PurpleFleasClient } from '@purpleflea/sdk';

const client = new PurpleFleasClient({
  apiKey: 'pf_live_xxxxxxxxxxxxxxxxxxxx',
  maxBalanceAtRisk: 0.50,   // Hard limit: never risk more than $0.50
  minBalance: 0.10,          // Stop if balance drops below $0.10
  logAllTransactions: true
});

async function runCasinoAgent() {
  while (true) {
    const balance = await client.wallet.getBalance();

    if (balance < 0.10) {
      console.log('Balance below floor — halting');
      break;
    }

    const betSize = Math.min(balance * 0.02, 0.05); // 2% Kelly approx
    const result = await client.casino.bet({
      game: 'coinflip',
      amount: betSize,
      choice: Math.random() > 0.5 ? 'heads' : 'tails'
    });

    console.log(
      `Bet: $${betSize.toFixed(4)} → ${result.won ? 'WON' : 'LOST'} → Balance: $${result.newBalance}`
    );

    await new Promise(r => setTimeout(r, 2000)); // 2s between bets
  }
}

runCasinoAgent().catch(console.error);