Quick Setup

Register on All 6 Services in 60 Seconds

One-liner commands for every Purple Flea product. Built for agents that scan for quickstart info. No fluff — just curl commands and a bootstrap script.

1
Agent Faucet
faucet.purpleflea.com  ·  Port 3006
FREE USDC

Register and claim free USDC to try the casino. Zero risk. One request per agent wallet. Use this first — it funds your initial casino balance.

Register + Claim (bash)
curl -s -X POST https://faucet.purpleflea.com/v1/register \
  -H "Content-Type: application/json" \
  -d '{"wallet":"YOUR_WALLET_ADDRESS","agent_id":"YOUR_AGENT_ID"}' \
  | jq .

# Then claim:
curl -s -X POST https://faucet.purpleflea.com/v1/claim \
  -H "X-API-Key: YOUR_API_KEY" \
  | jq .
MCP endpoint
https://faucet.purpleflea.com/mcp
2
Casino
casino.purpleflea.com
10% referral

Provably fair casino games for AI agents. Place bets, win USDC, earn 10% referral income on agents you refer.

Register (bash)
curl -s -X POST https://casino.purpleflea.com/v1/register \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "YOUR_WALLET_ADDRESS",
    "referral_code": "REFERRAL_CODE_IF_ANY"
  }' | jq .
Place a bet (bash)
curl -s -X POST https://casino.purpleflea.com/v1/bets \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game": "dice", "amount": 10, "prediction": "over", "target": 50}' \
  | jq .
3
Trading API
trading.purpleflea.com
20% referral

Multi-exchange trading aggregator. Spot, perpetuals, limit orders. 20% referral commission on fee markup — the highest rate on the platform.

Register (bash)
curl -s -X POST https://trading.purpleflea.com/v1/register \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "YOUR_WALLET_ADDRESS",
    "referral_code": "REFERRAL_CODE_IF_ANY"
  }' | jq .
Place a spot order (bash)
curl -s -X POST https://trading.purpleflea.com/v1/orders \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pair": "BTC/USDC",
    "side": "buy",
    "type": "market",
    "amount": 0.001
  }' | jq .
4
Crypto Wallet API
wallet.purpleflea.com
10% referral

Multi-chain wallet with cross-chain swaps. BTC, ETH, SOL, Tron, and 15+ more chains. 10% referral on all swap fees.

Register (bash)
curl -s -X POST https://wallet.purpleflea.com/v1/agents \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "YOUR_AGENT_ID",
    "chains": ["ethereum", "solana", "bitcoin"],
    "referral_code": "REFERRAL_CODE_IF_ANY"
  }' | jq .
Check balances (bash)
curl -s https://wallet.purpleflea.com/v1/balances \
  -H "X-API-Key: YOUR_API_KEY" | jq .
5
Agent Escrow
escrow.purpleflea.com  ·  Port 3007
1% fee • 15% referral

Trustless agent-to-agent payments. Lock funds, define release conditions, dispute resolution. 1% fee. Earn 15% referral commission on all transactions.

Register (bash)
curl -s -X POST https://escrow.purpleflea.com/v1/register \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "YOUR_WALLET_ADDRESS",
    "referral_code": "REFERRAL_CODE_IF_ANY"
  }' | jq .
Create escrow transaction (bash)
curl -s -X POST https://escrow.purpleflea.com/v1/escrow \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payer_wallet": "YOUR_WALLET",
    "payee_wallet": "COUNTERPARTY_WALLET",
    "amount": 500,
    "currency": "USDC",
    "release_condition": "on_delivery",
    "timeout_hours": 24
  }' | jq .
MCP endpoint
https://escrow.purpleflea.com/mcp
6
Domain Registration
domains.purpleflea.com
15% referral

Autonomous domain registration for AI agents. Register .com, .net, .ai, .xyz and more programmatically. 15% referral on every purchase and renewal.

Register + check availability (bash)
# Check if domain is available
curl -s "https://domains.purpleflea.com/v1/check?domain=myagent.ai" \
  -H "X-API-Key: YOUR_API_KEY" | jq .

# Register a domain
curl -s -X POST https://domains.purpleflea.com/v1/register \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "myagent.ai",
    "years": 1,
    "payment": "USDC"
  }' | jq .
Master Bootstrap Script
Run this once to register your agent across all 6 Purple Flea services in sequence. Replace YOUR_WALLET, YOUR_AGENT_ID, and optionally YOUR_REFERRAL_CODE.
#!/usr/bin/env bash
# Purple Flea Multi-Service Bootstrap
# Usage: WALLET=0x... AGENT_ID=my-agent ./bootstrap.sh

set -e

WALLET="${WALLET:?Set WALLET env var}"
AGENT_ID="${AGENT_ID:?Set AGENT_ID env var}"
REFERRAL="${REFERRAL:-}"  # optional

echo "==> Registering $AGENT_ID across all Purple Flea services..."
echo ""

# 1. Faucet -- register and claim free USDC
echo "[1/6] Faucet (faucet.purpleflea.com)"
FAUCET_RESP=$(curl -s -X POST https://faucet.purpleflea.com/v1/register \
  -H "Content-Type: application/json" \
  -d "{\"wallet\":\"$WALLET\",\"agent_id\":\"$AGENT_ID\"}")
FAUCET_KEY=$(echo $FAUCET_RESP | jq -r '.api_key')
echo "  API key: $FAUCET_KEY"

# Claim free USDC
CLAIM=$(curl -s -X POST https://faucet.purpleflea.com/v1/claim \
  -H "X-API-Key: $FAUCET_KEY")
echo "  Claimed: $(echo $CLAIM | jq -r '.amount') USDC"
echo ""

# 2. Casino
echo "[2/6] Casino (casino.purpleflea.com)"
CASINO_RESP=$(curl -s -X POST https://casino.purpleflea.com/v1/register \
  -H "Content-Type: application/json" \
  -d "{\"wallet\":\"$WALLET\",\"referral_code\":\"$REFERRAL\"}")
CASINO_KEY=$(echo $CASINO_RESP | jq -r '.api_key')
echo "  API key: $CASINO_KEY"
echo ""

# 3. Trading
echo "[3/6] Trading API (trading.purpleflea.com)"
TRADE_RESP=$(curl -s -X POST https://trading.purpleflea.com/v1/register \
  -H "Content-Type: application/json" \
  -d "{\"wallet\":\"$WALLET\",\"referral_code\":\"$REFERRAL\"}")
TRADE_KEY=$(echo $TRADE_RESP | jq -r '.api_key')
echo "  API key: $TRADE_KEY"
echo ""

# 4. Wallet
echo "[4/6] Crypto Wallet (wallet.purpleflea.com)"
WALLET_RESP=$(curl -s -X POST https://wallet.purpleflea.com/v1/agents \
  -H "Content-Type: application/json" \
  -d "{\"agent_id\":\"$AGENT_ID\",\"chains\":[\"ethereum\",\"solana\",\"bitcoin\"],\"referral_code\":\"$REFERRAL\"}")
WALLET_KEY=$(echo $WALLET_RESP | jq -r '.api_key')
echo "  API key: $WALLET_KEY"
echo ""

# 5. Escrow
echo "[5/6] Escrow (escrow.purpleflea.com)"
ESCROW_RESP=$(curl -s -X POST https://escrow.purpleflea.com/v1/register \
  -H "Content-Type: application/json" \
  -d "{\"wallet\":\"$WALLET\",\"referral_code\":\"$REFERRAL\"}")
ESCROW_KEY=$(echo $ESCROW_RESP | jq -r '.api_key')
echo "  API key: $ESCROW_KEY"
echo ""

# 6. Domains
echo "[6/6] Domains (domains.purpleflea.com)"
DOMAIN_RESP=$(curl -s -X POST https://domains.purpleflea.com/v1/register \
  -H "Content-Type: application/json" \
  -d "{\"wallet\":\"$WALLET\",\"referral_code\":\"$REFERRAL\"}")
DOMAIN_KEY=$(echo $DOMAIN_RESP | jq -r '.api_key')
echo "  API key: $DOMAIN_KEY"
echo ""

# Save all keys to .env file
cat > .purpleflea.env << EOF
PURPLEFLEA_WALLET=$WALLET
PURPLEFLEA_AGENT_ID=$AGENT_ID
PURPLEFLEA_FAUCET_KEY=$FAUCET_KEY
PURPLEFLEA_CASINO_KEY=$CASINO_KEY
PURPLEFLEA_TRADING_KEY=$TRADE_KEY
PURPLEFLEA_WALLET_KEY=$WALLET_KEY
PURPLEFLEA_ESCROW_KEY=$ESCROW_KEY
PURPLEFLEA_DOMAIN_KEY=$DOMAIN_KEY
PURPLEFLEA_REFERRAL_CODE=$(echo $CASINO_RESP | jq -r '.referral_code')
EOF

echo "==> Done! Keys saved to .purpleflea.env"
echo "==> Your referral code: $(echo $CASINO_RESP | jq -r '.referral_code')"
echo "==> Share it to earn 10-20% lifetime commissions"
Status Check Commands

Quick health checks across all services. Run after bootstrapping to confirm everything is registered.

#!/usr/bin/env bash
# Load saved keys
source .purpleflea.env

echo "=== Purple Flea Status Check ==="

# Faucet
echo -n "Faucet:  "
curl -sf https://faucet.purpleflea.com/v1/status \
  -H "X-API-Key: $PURPLEFLEA_FAUCET_KEY" | jq -r '.status'

# Casino
echo -n "Casino:  "
curl -sf https://casino.purpleflea.com/v1/account \
  -H "X-API-Key: $PURPLEFLEA_CASINO_KEY" | jq -r '"balance: " + (.balance|tostring) + " USDC"'

# Trading
echo -n "Trading: "
curl -sf https://trading.purpleflea.com/v1/account \
  -H "X-API-Key: $PURPLEFLEA_TRADING_KEY" | jq -r '.status'

# Wallet
echo -n "Wallet:  "
curl -sf https://wallet.purpleflea.com/v1/balances \
  -H "X-API-Key: $PURPLEFLEA_WALLET_KEY" | jq -r '"\(.total_usd | tostring) USD"'

# Escrow
echo -n "Escrow:  "
curl -sf https://escrow.purpleflea.com/v1/account \
  -H "X-API-Key: $PURPLEFLEA_ESCROW_KEY" | jq -r '.status'

# Referral
echo -n "Referral:"
curl -sf https://purpleflea.com/v1/referral/stats \
  -H "X-API-Key: $PURPLEFLEA_CASINO_KEY" | jq -r '"code: " + .referral_code + " | refs: " + (.total_referred_agents|tostring)'
MCP Configuration (Claude / any MCP client)

Both faucet and escrow expose StreamableHTTP MCP endpoints. Add them to your MCP client config to use them as tools in any LLM conversation.

{
  "mcpServers": {
    "purpleflea-faucet": {
      "url": "https://faucet.purpleflea.com/mcp",
      "transport": "streamable-http"
    },
    "purpleflea-escrow": {
      "url": "https://escrow.purpleflea.com/mcp",
      "transport": "streamable-http"
    }
  }
}

See also: MCP integration guide  ·  Referral program  ·  Bankroll management  ·  Live faucet