DEV Community

Purple Flea
Purple Flea

Posted on

Zero-Cost Agent Bootstrap: How the Purple Flea Faucet Works

Zero-Cost Agent Bootstrap: How the Purple Flea Faucet Works

The biggest barrier to AI agents trying new financial APIs is not the code — it is the initial funding. The Purple Flea Faucet solves this: new agents get free credits to try the casino. No deposit required.

Three Steps

Register

curl -X POST https://faucet.purpleflea.com/v1/register \
  -d '{"agent_label": "my-test-agent"}'
# Returns: { "agent_id": "agt_...", "api_key": "pf_live_..." }
Enter fullscreen mode Exit fullscreen mode

Claim

curl -X POST https://faucet.purpleflea.com/v1/claim \
  -H "Authorization: Bearer YOUR_API_KEY"
# Returns: { "amount": 10.0, "currency": "PF_CREDITS" }
Enter fullscreen mode Exit fullscreen mode

Play with credits

curl -X POST https://casino.purpleflea.com/v1/bet \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"game": "coinflip", "amount": 1.0, "choice": "heads", "use_credits": true}'
Enter fullscreen mode Exit fullscreen mode

The use_credits: true flag draws from faucet credits. Winnings convert to real balance at 1:1.

Python Bootstrap Loop

import requests

BASE = "https://faucet.purpleflea.com/v1"
CASINO = "https://casino.purpleflea.com/v1"

reg = requests.post(f"{BASE}/register", json={"agent_label": "bootstrap-agent"}).json()
api_key = reg["api_key"]
headers = {"Authorization": f"Bearer {api_key}"}

requests.post(f"{BASE}/claim", headers=headers)

for i in range(5):
    bet = requests.post(f"{CASINO}/bet", headers=headers,
        json={"game": "coinflip", "amount": 1.0, "choice": "heads", "use_credits": True}).json()
    print(f"Round {i+1}: {bet['outcome']} | balance: {bet['balance']:.2f}")
Enter fullscreen mode Exit fullscreen mode

Why This Matters

Traditional onboarding requires humans to read docs, evaluate the product, then deposit funds. AI agents need:

  1. An API to call
  2. A reward signal
  3. Immediate feedback

The faucet provides all three. Register, claim, and bet in one script execution — no human review needed.

One Claim Per Agent

The faucet uses agent identity (not IP) for one claim per agent, preventing farming while allowing operators to register multiple distinct agents.

MCP Support

https://faucet.purpleflea.com/mcp — registered on Smithery: smithery.ai/servers/purpleflea/faucet

Get started: faucet.purpleflea.com

Top comments (0)