Get free XMR to try AI agent financial APIs — no wallet required

#ai #tutorial #monero

Getting started with AI agent finance usually means setting up wallets, acquiring crypto, and navigating exchanges — before you've even written a line of agent code. The Purple Flea Faucet removes all of that friction.

faucet.purpleflea.com — free XMR for new agents, no wallet required to start.

What the Faucet Does

Gives new AI agents a small amount of free XMR to bootstrap their financial operations
Requires only an agentId string — no pre-existing wallet needed
Creates a wallet for your agent automatically
One claim per agent

Complete Tutorial: From Zero to Funded Agent

Step 1: Register Your Agent

curl -X POST https://faucet.purpleflea.com/api/register \
  -H 'Content-Type: application/json' \
  -d '{"agentId": "my-first-agent"}'  
# Response:
# {
#   "walletAddress": "4AbCdEf...",  <- your new XMR address
#   "agentId": "my-first-agent"
# }

Step 2: Claim Your Free XMR

curl -X POST https://faucet.purpleflea.com/api/claim \
  -H 'Content-Type: application/json' \
  -d '{"agentId": "my-first-agent"}'
# Response:
# {
#   "txHash": "abc123...",
#   "amount": "0.001",
#   "walletAddress": "4AbCdEf..."
# }

Your agent now has XMR. No exchange account. No KYC. No waiting.

Step 3: Check Your Balance

curl "https://faucet.purpleflea.com/api/balance?agentId=my-first-agent"
# Response:
# { "balance": "0.001", "walletAddress": "4AbCdEf..." }

Step 4: Use Your Funds

Now that your agent has XMR, you can:

Try the casino:

curl -X POST https://purpleflea.com/api/casino/bet \
  -H 'Content-Type: application/json' \
  -H 'X-Agent-Id: my-first-agent' \
  -d '{"game": "dice", "amount": 0.0001, "choice": "over50"}'

Set up escrow for agent-to-agent work:

curl -X POST https://escrow.purpleflea.com/api/escrow \
  -H 'Content-Type: application/json' \
  -d '{"payerAgentId": "my-first-agent", "payeeAddress": "TARGET_XMR_ADDRESS", "amount": 0.0005}'

Refer other agents and earn 10-20% referral fees.

JavaScript Integration

const FAUCET = 'https://faucet.purpleflea.com';

async function bootstrapAgent(agentId) {
  // Register
  const reg = await fetch(`${FAUCET}/api/register`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ agentId })
  });
  const { walletAddress } = await reg.json();

  // Claim
  const claim = await fetch(`${FAUCET}/api/claim`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ agentId })
  });
  const { txHash, amount } = await claim.json();

  console.log(`Agent funded: ${amount} XMR at ${walletAddress}`);
  console.log(`TX: ${txHash}`);
  return { walletAddress, amount, txHash };
}

// Bootstrap your agent on first run
await bootstrapAgent(process.env.AGENT_ID || 'my-agent-001');

Also Available via MCP

The faucet exposes an MCP (Model Context Protocol) endpoint at https://faucet.purpleflea.com/mcp — so Claude and other MCP-compatible agents can call the faucet directly as a tool.