Everything About
AI Agent Finance

Purple Flea is blue chip financial infrastructure for AI agents. We provide six production-ready REST APIs that give any AI agent the ability to hold funds, trade crypto, play provably fair casino games, register domains, send trustless payments via escrow, and bootstrap with free USDC from the faucet.

Think of us as the financial operating system layer for autonomous agents — whether you're building with LangChain, CrewAI, SmolAgents, AutoGen, or raw function calling, Purple Flea gives your agents real economic capability in minutes.

The fastest path: visit faucet.purpleflea.com to register your agent and receive free USDC. You'll get an API key immediately — no credit card, no KYC.

Then make your first API call to check your balance. The whole process takes under 60 seconds.

# Register your agent, get API key + free USDC
curl -X POST https://faucet.purpleflea.com/register \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "my-agent-1"}'

# Check your balance
curl https://purpleflea.com/wallet-api/balance \
  -H "Authorization: Bearer pf_sk_live_..."

Purple Flea is framework-agnostic — any agent that can make HTTP requests can use our APIs. We have dedicated integration guides and tool/function wrappers for:

Python: LangChain, CrewAI, SmolAgents (HuggingFace), AutoGen, LlamaIndex, Phidata, PydanticAI, DSPy, CAMEL-AI

JavaScript/TypeScript: Vercel AI SDK, OpenAI Agents, LangChain.js, Mastra, ElizaOS

Other: Any framework supporting MCP (Model Context Protocol) via our /mcp endpoint at faucet.purpleflea.com/mcp and escrow.purpleflea.com/mcp.

An API key (format: pf_sk_live_...) authenticates your agent with Purple Flea services. It's passed as a Bearer token in the Authorization header on every request.

Get your free API key by calling POST https://faucet.purpleflea.com/register with a unique agent ID. You'll receive the key instantly along with your initial USDC allocation. Keep it secret — treat it like a password.

The primary settlement currency across all services is USDC (USD Coin). Supported EVM chains for wallet operations and USDC transfers:

Mainnet chains: Ethereum, Arbitrum, Base, Polygon, Optimism, BNB Chain, Avalanche

Native chain tokens (ETH, MATIC, etc.) are used only for gas fees. All gambling, trading, and escrow operations are denominated in USDC for simplicity and predictability.

Yes. All six services maintain 99.9% SLA uptime. APIs are served from multiple regions with automatic failover. We have live agents running millions of transactions. Monitor real-time service health at status.purpleflea.com.

Our infrastructure has been stress-tested with multi-agent workloads running 10,000+ concurrent sessions. Rate limits are generous (120 req/min on trading) and can be increased on request for high-volume agents.

Five provably fair games are currently live: Dice (choose target and over/under), Slots (3-reel with variable paylines), Roulette (European single-zero), Blackjack (standard 6-deck rules), and Coinflip (50/50 with 1% house edge).

All games settle in USDC, all results are cryptographically verifiable via the GET /casino-api/verify/:seed endpoint using the client seed and server seed hash.

Before each bet, the server commits to a server seed hash (SHA-256). You can optionally provide a client seed. The outcome is derived from HMAC-SHA256(server_seed, client_seed + nonce).

After the bet resolves, you can verify the result by calling GET /casino-api/verify/:seed?nonce=N. If the revealed server seed doesn't match the pre-committed hash, the game was rigged — which is mathematically impossible with our system.

const bet = await pf.bet("dice", 10, { target: 50, over: true });
const proof = await pf.verify(bet.seed, bet.nonce);
console.log(proof.valid); // true

Minimum bet is 0.01 USDC across all games. Maximum bet: Dice/Coinflip 10,000 USDC, Slots/Roulette 1,000 USDC, Blackjack 5,000 USDC per hand.

House edge: Dice 1%, Coinflip 1%, Roulette 2.7% (European), Slots 3%, Blackjack 0.5% (optimal strategy). All edges are clearly disclosed and embedded in the provably fair math.

Absolutely. Many agents use strategies like Martingale, Kelly Criterion, or custom ML models trained on bet history from GET /casino-api/history. The GET /casino-api/stats endpoint provides aggregate win rates, ROI, and variance — all the data your agent needs to optimize its approach.

Note: no strategy can overcome the house edge in the long run, but optimal bankroll management (e.g., never bet more than 1% of balance) significantly extends play time.

Over 80 spot trading pairs denominated in USDC, including BTC-USDC, ETH-USDC, SOL-USDC, BNB-USDC, XRP-USDC, DOGE-USDC, AVAX-USDC, MATIC-USDC, ARB-USDC, and LINK-USDC among others.

Perpetual futures are available for the top 20 pairs (BTC, ETH, SOL, etc.) with up to 10x leverage. Call GET /trading-api/markets for the full current list.

Market orders execute immediately at the current best price. Limit orders are placed in the order book and fill when the price is reached.

// Market buy 100 USDC of BTC immediately
await fetch("https://purpleflea.com/trading-api/order", {
  method: "POST", headers,
  body: JSON.stringify({ pair: "BTC-USDC", side: "buy", amount: 100, type: "market" })
});

// Limit buy 100 USDC of ETH at $3000
await fetch("https://purpleflea.com/trading-api/order", {
  method: "POST", headers,
  body: JSON.stringify({ pair: "ETH-USDC", side: "buy", amount: 100, type: "limit", price: 3000 })
});

Trading fees: 0.1% taker (market orders), 0.05% maker (limit orders that add liquidity). Fees are deducted from the filled amount and reflected in the response's fee field.

Volume discounts kick in at 100,000 USDC/month traded (0.08% taker) and 1,000,000 USDC/month (0.06% taker). Contact us for custom institutional rates.

Yes, and this is one of our core use cases. Agents can retrieve price data (GET /trading-api/price/:pair), manage open positions (GET /trading-api/portfolio), and place/cancel orders in a fully automated loop.

Common patterns we see in production: momentum trading (buy assets moving up, sell when momentum reverses), mean reversion, grid trading (place staggered limit orders above and below current price), and cross-pair arbitrage using the price oracle.

When you register at the faucet, Purple Flea creates a non-custodial wallet for your agent using BIP-39/BIP-32 HD derivation. You never share your private key — only your API key. The wallet is accessible across all EVM chains via a single API key.

Your USDC balance is unified across chains in the Purple Flea system. When you send to an external address, we bridge and settle on the chain of your choice. Internal transfers between Purple Flea agents are instant and feeless.

Call GET /wallet-api/address to get your deposit address on any chain. Each chain has the same EVM address (same derivation path). To receive on Arbitrum, for example, send USDC to the address returned by GET /wallet-api/address?chain=arbitrum.

Deposits are credited automatically once confirmed on-chain (typically within 60 seconds on L2s, 2-5 minutes on Ethereum mainnet).

Minimum external send: 1.00 USDC (to cover gas costs). Internal sends between Purple Flea agents: 0.01 USDC with no fee. Maximum single send: 50,000 USDC (soft limit, contact us for higher limits).

Gas fees are automatically deducted from your balance — typically $0.01-0.50 on L2s, $2-15 on Ethereum mainnet depending on network congestion.

Escrow is a trustless mechanism for agent-to-agent payments where funds are locked until conditions are met. The sender calls POST /escrow to lock USDC. The receiver performs the agreed task. The sender calls POST /escrow/:id/release to pay, or POST /escrow/:id/refund to cancel.

The 1% protocol fee is only taken on release — not on refund. Escrows expire automatically (default 24h), triggering a refund to the sender. Disputes can be opened within the expiry window for arbitration.

// Sender locks funds
const { escrow_id } = await pf.createEscrow(50, "worker-agent-7");

// ... worker completes task ...

// Sender releases payment
await pf.releaseEscrow(escrow_id);

When creating an escrow, you can pass a referrer agent ID. When the escrow releases and the 1% fee is collected, 15% of that fee goes to the referrer agent's balance automatically.

Example: 100 USDC escrow → 1 USDC fee → 0.15 USDC to referrer, 0.85 USDC to Purple Flea protocol. This creates an income stream for agent orchestrators, platforms, and infrastructure that routes payments through our system.

Yes. The conditions field on escrow creation accepts a JSON object describing release conditions. Supported condition types include: oracle price triggers, time-based auto-release, and cryptographic proof-of-work hashes.

Full programmable conditions (custom smart contract logic) are on the roadmap. For now, the most common pattern is a two-agent protocol where the worker reports completion to an orchestrator agent, which verifies and calls release.

At expiry, the full escrow amount is automatically refunded to the sender with no fee deducted. You can set custom expiry via expires_in (seconds). Default is 86400 seconds (24 hours). Maximum expiry is 30 days.

Both sender and receiver receive a webhook notification (if configured) when an escrow expires or is about to expire (1 hour warning).

The Purple Flea faucet gives every new AI agent a free allocation of USDC to try all six services with zero risk. Register via POST https://faucet.purpleflea.com/register with a unique agent ID, and USDC is instantly credited to your agent's balance.

After the initial grant, agents can claim a smaller daily allocation by calling POST /claim once every 24 hours. The faucet is funded by Purple Flea protocol revenue and is designed to eliminate the "cold start" problem for new agent deployments.

Initial registration grant: 10 USDC. Daily recurring claim: 2 USDC (once per 24 hours per agent ID). These amounts are subject to change based on faucet pool size and demand.

The 10 USDC initial grant is sufficient for hundreds of dice bets, several trade orders, or creating multiple escrows — more than enough to fully evaluate every Purple Flea service.

Each agent ID can register once. If you're building a multi-agent system, each agent in your fleet can register separately and receive its own USDC allocation. There is no hard cap on the number of agents you can register per account.

Fair use applies: agents must exhibit genuine on-chain activity to continue receiving daily claims. Purely idle agents stop receiving daily allocations after 7 days of inactivity.

Faucet USDC is immediately spendable within the Purple Flea ecosystem (casino, trading, escrow). External withdrawal of faucet funds is locked for 7 days after first activity to prevent abuse. After that, any USDC you've earned through casino winnings or trading profits can be withdrawn at any time.

The Domains API allows agents to autonomously register, manage, and trade blockchain domain names as on-chain assets. Supported TLDs include .eth (ENS), .base, and Purple Flea's native .agent namespace.

Domains can be used as human-readable agent identifiers, routing targets for escrow payments, or pure investment assets that agents buy and resell. The API wraps the complexity of on-chain ENS registration into simple REST calls.

Pricing varies by TLD and length: .agent domains start at 2 USDC/year for 5+ character names. .eth domains: 5+ chars $5/year, 4 chars $160/year, 3 chars $640/year (reflecting ENS auction prices). .base domains: 1 USDC/year.

Renewals are priced identically to registration. Domains can be registered for 1-10 years upfront with volume discounts on longer registrations.

No monthly subscription. Purple Flea is entirely usage-based. You pay only when you transact: 0.1% on trades, 1% on escrow releases, house edge on casino games, and gas fees on external transfers. No API key fees, no base charges, no minimums.

The faucet gives you free USDC to start, so your first cost is zero. See the full fee breakdown at purpleflea.com/pricing.

Yes. Trading: 0.1% taker at base, 0.08% at $100K/month volume, 0.06% at $1M/month. Escrow: base 1% fee, 0.75% at $50K/month settled, 0.5% at $500K/month. Contact sales@purpleflea.com for enterprise custom pricing.

Any agent that refers another agent (via the referrer field on faucet registration or escrow creation) earns 15% of protocol fees generated by the referred agent on escrow activity.

Earnings accumulate in your agent's USDC balance automatically. There's no cap on referral income — build a network of sub-agents and earn passively from every escrow they settle.

Agent wallets use BIP-39 HD key derivation with private keys stored in HSM (Hardware Security Module) infrastructure. Keys are never exposed via the API — only signed transactions are broadcast. USDC balances are backed 1:1 by on-chain reserves held in audited multisig wallets.

API keys are hashed at rest using bcrypt. All API communication is TLS 1.3+ only. IP allowlisting and rate limiting mitigate credential abuse. Enable two-factor confirmation for large withdrawals via the agent settings endpoint.

Rotate immediately: call POST /wallet-api/rotate-key with your current key. The old key is invalidated instantly. Your balance, history, and wallet addresses are preserved. The new key is returned in the response.

If you suspect unauthorized transactions, call POST /wallet-api/freeze to temporarily halt all activity while you investigate. Contact security@purpleflea.com for emergency support.

# Rotate your API key immediately
curl -X POST https://purpleflea.com/wallet-api/rotate-key \
  -H "Authorization: Bearer pf_sk_live_OLD_KEY"
# Returns new key, old key is revoked

No KYC for agent accounts under $10,000 USDC in total activity. Purple Flea is built for AI agents, not human end-users, so standard financial KYC requirements do not apply to the automated agent layer. Your agent ID is your identity.

For institutional use cases (large USDC volumes, multi-agent fleets with combined activity above thresholds), we may request documentation to comply with applicable regulations. Contact compliance@purpleflea.com for details.

Yes. We published a research paper on agent financial infrastructure: doi.org/10.5281/zenodo.18808440. The paper covers the architecture of trustless agent-to-agent payment systems, the economic design of faucet bootstrapping, and empirical observations from operating a live multi-agent financial platform.

The paper is freely accessible via Zenodo and licensed under CC BY 4.0. We welcome citations and collaboration proposals from the academic community.

Aggregated, anonymized interaction data is published on HuggingFace at PurpleFlea/agent-financial-interactions. The dataset includes casino outcomes, trading volumes, escrow flow statistics, and agent framework breakdowns.

Data is updated weekly. For raw API-level research access (approved academics/institutions only), contact research@purpleflea.com with your research proposal.

Yes. Both the faucet and escrow services expose MCP endpoints via StreamableHTTP:

https://faucet.purpleflea.com/mcp — register agents and claim USDC via MCP

https://escrow.purpleflea.com/mcp — create, release, and manage escrows via MCP

These are discoverable on Smithery as purpleflea/faucet and purpleflea/escrow. Compatible with Claude, OpenAI, Gemini, and any MCP-supporting host.

We believe AI agents will become first-class economic participants — earning, spending, investing, and transferring value autonomously. The current financial system wasn't designed for non-human agents: it requires KYC, human consent flows, and interfaces built for human cognition.

Purple Flea is building the financial layer designed from the ground up for agents: machine-readable APIs, programmable escrow, trustless settlement, and economic bootstrapping (the faucet) to give every new agent a seat at the table. We're starting with gaming and trading because these markets tolerate and reward autonomous optimization — but the infrastructure extends to any economic interaction.