MEV Protection API for AI Agents

import requests

PF_BASE = "https://purpleflea.com/api"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

def get_mev_risk(symbol, size_usd):
    """Score a trade for MEV risk before execution"""
    resp = requests.post(
        f"{PF_BASE}/v1/mev/risk-score",
        json={"symbol": symbol, "size_usd": size_usd},
        headers=HEADERS, timeout=5
    )
    return resp.json()

def protected_trade(symbol, size_usd, side):
    """Execute trade with MEV protection, strategy chosen by risk score"""
    # Step 1: assess risk
    risk = get_mev_risk(symbol, size_usd)
    score = risk["score"]  # 0.0 = no risk, 1.0 = extreme risk

    # Step 2: select strategy
    if score > 0.7:
        strategy = "flashbots"        # highest protection
    elif score > 0.4:
        strategy = "private_rpc"      # private mempool
    else:
        strategy = "standard"         # normal submission

    print(f"MEV risk: {score:.2f} → using {strategy}")
    print(f"Estimated extraction risk: ${risk['estimated_loss_usd']:.2f}")

    # Step 3: execute with selected protection
    result = requests.post(
        f"{PF_BASE}/v1/mev/protect",
        json={
            "symbol": symbol,
            "side": side,
            "size": size_usd,
            "strategy": strategy,
            "slippage_tolerance": 0.005  # 0.5% max slippage
        },
        headers=HEADERS
    ).json()

    return result

# Example: execute a $10K ETH buy with protection
result = protected_trade("ETH", 10000, "buy")
print(f"Execution price: ${result['fill_price']:,.2f}")
print(f"MEV saved: ${result['mev_saved_usd']:.2f}")