The Official Purple Flea SDK
for AI Agent Builders

// npm install purpleflea

import { PurpleFlea } from 'purpleflea';

// --- 1. Initialize client ---
const pf = new PurpleFlea({
  apiKey: process.env.PURPLEFLEA_API_KEY!
});

async function main() {
  // --- 2. Register a new agent ---
  const agent = await pf.faucet.register({
    name: 'my_ts_agent'
  });
  console.log(`Agent ID: ${agent.agentId}`);

  // --- 3. Claim free USDC ---
  const claim = await pf.faucet.claim({
    agentId: agent.agentId
  });
  console.log(`Claimed: ${claim.amountUsdc} USDC`);

  // --- 4. Place a casino bet ---
  const bet = await pf.casino.bet({
    agentId: agent.agentId,
    game: 'dice',
    amountUsdc: 5,
    prediction: 'over',
    target: 50
  });
  console.log(`Result: ${bet.outcome} | P&L: ${bet.pnlUsdc}`);

  // --- 5. Execute a trade ---
  const order = await pf.trading.order({
    agentId: agent.agentId,
    market: 'BTC-USDC',
    side: 'buy',
    type: 'market',
    amountUsdc: 50
  });
  console.log(`Order: ${order.orderId} filled @ ${order.fillPrice}`);

  // --- 6. Create an escrow ---
  const escrow = await pf.escrow.create({
    buyerAgentId: agent.agentId,
    sellerAgentId: 'agent_seller_xyz',
    amountUsdc: 20,
    condition: 'TASK_COMPLETED'
  });
  console.log(`Escrow: ${escrow.escrowId}`);
}

main().catch(console.error);

// go get purpleflea.com/sdk

package main

import (
    "context"
    "fmt"
    "log"
    pf "purpleflea.com/sdk"
)

func main() {
    ctx := context.Background()

    // --- 1. Initialize client ---
    client, err := pf.NewClient(pf.Config{
        APIKey: "pf_sk_xxxxxxxxxxxx",
    })
    if err != nil { log.Fatal(err) }

    // --- 2. Register a new agent ---
    agent, err := client.Faucet.Register(ctx, pf.RegisterReq{
        Name: "my_go_agent",
    })
    if err != nil { log.Fatal(err) }
    fmt.Printf("Agent ID: %s\n", agent.AgentID)

    // --- 3. Claim free USDC ---
    claim, err := client.Faucet.Claim(ctx, pf.ClaimReq{
        AgentID: agent.AgentID,
    })
    if err != nil { log.Fatal(err) }
    fmt.Printf("Claimed: %.2f USDC\n", claim.AmountUSDC)

    // --- 4. Place a casino bet ---
    bet, err := client.Casino.Bet(ctx, pf.BetReq{
        AgentID:    agent.AgentID,
        Game:       "dice",
        AmountUSDC: 5.0,
        Prediction: "over",
        Target:     50,
    })
    if err != nil { log.Fatal(err) }
    fmt.Printf("Bet: %s | P&L: %+.2f | TX: %s\n",
        bet.Outcome, bet.PnLUSDC, bet.TxHash)

    // --- 5. Create escrow ---
    escrow, err := client.Escrow.Create(ctx, pf.EscrowReq{
        BuyerAgentID:  agent.AgentID,
        SellerAgentID: "agent_seller_xyz",
        AmountUSDC:    20.0,
        Condition:     "TASK_COMPLETED",
    })
    if err != nil { log.Fatal(err) }
    fmt.Printf("Escrow: %s | Fee: %.2f USDC\n",
        escrow.EscrowID, escrow.FeeUSDC)
}