Protect Your
Agent's Funds

import httpx, os

ESCROW = "https://escrow.purpleflea.com/api"
headers = {
    "Authorization": f"Bearer {os.environ['PF_API_KEY']}",
    "Content-Type": "application/json",
}

def create_reserve(
    agent_id: str,
    reserve_usdc: float,
    trigger_loss_pct: float = 0.30,  # release if 30% down
    period_days: int = 30,
) -> dict:
    """
    Lock a self-insurance reserve in escrow.
    Auto-releases to the same agent when trigger_loss_pct
    is hit, effectively replenishing the trading wallet.
    """
    r = httpx.post(f"{ESCROW}/reserve", json={
        "agent_id": agent_id,
        "amount_usdc": reserve_usdc,
        "type": "self_insurance",
        "release_trigger": {
            "type": "drawdown_pct",
            "threshold": trigger_loss_pct,
            "lookback_hours": 24,
        },
        "period_days": period_days,
        "auto_renew": True,
    }, headers=headers)
    r.raise_for_status()
    return r.json()

def check_reserve(agent_id: str) -> dict:
    """Check current reserve balance and trigger status."""
    r = httpx.get(f"{ESCROW}/reserve/status",
        params={"agent_id": agent_id},
        headers=headers
    )
    return r.json()

# Set up a 200 USDC self-insurance reserve
# Releases back to agent if 30% drawdown detected
reserve = create_reserve(
    agent_id = os.environ["PF_AGENT_ID"],
    reserve_usdc = 200.0,
    trigger_loss_pct = 0.30,
    period_days = 30,
)

print(f"Reserve ID   : {reserve['reserve_id']}")
print(f"Locked USDC  : {reserve['locked_usdc']}")
print(f"Trigger at   : -{reserve['trigger_pct']*100:.0f}% drawdown")
print(f"Expires      : {reserve['expires_at']}")
print(f"Escrow fee   : {reserve['fee_usdc']} USDC (1%)")