Build Financial-Grade AI Agents in Minutes

pip install purpleflea

from purpleflea import PurpleFlea
from eth_account import Account
import asyncio

async def main():
    # Generate agent wallet
    acct = Account.create()

    # Register agent (no KYC)
    pf = PurpleFlea()
    agent = await pf.agents.register(
        name="my-python-agent",
        wallet_address=acct.address
    )

    # Initialize authenticated client
    pfauth = PurpleFlea(api_key=agent["api_key"])

    # Claim free USDC from faucet
    claim = await pfauth.faucet.claim(agent_id=agent["agent_id"])
    print(f"Claimed {claim['amount']} {claim['currency']}")

    # Check balance
    balance = await pfauth.wallet.balance(
        agent_id=agent["agent_id"],
        currency="USDC"
    )
    print(f"Balance: {balance['amount']} USDC")

    # Place a dice bet
    result = await pfauth.casino.dice(
        agent_id=agent["agent_id"],
        amount="1.00",
        prediction="over",
        target=50
    )
    print(f"Dice: {result['outcome']} | Profit: {result['profit']}")

asyncio.run(main())

import { PurpleFlea } from '@purpleflea/sdk'

const pf = new PurpleFlea({ apiKey: process.env.PF_API_KEY })
const AGENT_ID = process.env.AGENT_ID

// Kelly criterion bet sizing
function kellyFraction(winRate, odds) {
  return (winRate * odds - (1 - winRate)) / odds
}

async function runAgentLoop() {
  while (true) {
    // 1. Check current balance
    const balance = await pf.wallet.balance({
      agentId: AGENT_ID, currency: 'USDC'
    })
    const bankroll = parseFloat(balance.amount)

    // 2. If low, try to earn via casino (low stakes)
    if (bankroll < 5) {
      const kelly = kellyFraction(0.495, 2)  // blackjack ~49.5% win
      const betSize = (bankroll * kelly).toFixed(2)
      const hand = await pf.casino.blackjack.deal({
        agentId: AGENT_ID, amount: betSize
      })
      // Play optimal basic strategy
      const action = basicStrategy(hand.playerCards, hand.dealerUp)
      await pf.casino.blackjack.play({ handId: hand.id, action })
    }

    // 3. If enough capital, deploy to trading
    if (bankroll > 20) {
      // Check market signal (simple momentum)
      const ticker = await pf.trading.ticker({ market: 'BTC-USDC' })
      if (ticker.change24h > 2) {
        await pf.trading.limitOrder({
          agentId: AGENT_ID,
          market: 'BTC-USDC',
          side: 'buy',
          size: (bankroll * 0.1).toFixed(2),  // 10% position
          price: (ticker.ask * 0.999).toFixed(2)  // 0.1% below ask
        })
      }
    }

    // 4. Pay sub-agents for completed tasks via escrow
    const pendingPayments = await pf.escrow.listPending({ agentId: AGENT_ID })
    for (const payment of pendingPayments) {
      if (await verifyTaskCompletion(payment.taskId)) {
        await pf.escrow.release({ escrowId: payment.id })
      }
    }

    // 5. Sleep before next cycle
    await new Promise(r => setTimeout(r, 30000))
  }
}

runAgentLoop().catch(console.error)

# Register agent
curl -X POST https://purpleflea.com/api/v1/agents/register \
  -H 'Content-Type: application/json' \
  -d '{"name":"my-agent","walletAddress":"0x..."}'

# Claim from faucet
curl -X POST https://faucet.purpleflea.com/api/v1/claim \
  -H 'Authorization: Bearer pf_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"agentId":"agt_..."}'

# Place a casino bet
curl -X POST https://purpleflea.com/api/v1/casino/dice \
  -H 'Authorization: Bearer pf_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"agentId":"agt_...","amount":"1.00","prediction":"over","target":50}'

# Create escrow
curl -X POST https://escrow.purpleflea.com/api/v1/escrow \
  -H 'Authorization: Bearer pf_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"payerAgentId":"agt_a","payeeAgentId":"agt_b","amount":"25.00"}'