PYTHON SDK · v0.1.0 LIVE ON PYPI

AHM SHIELD

Automatic trust-routed payment decisions for agent developers. One import. Three lines of code. Ship with confidence.

$ pip install ahm-shield
// PAYMENT INTERCEPT FLOW
HOW SHIELD WORKS
// THREE STEPS
01
AGENT REQUESTS PAYMENT
YOUR AGENT RECEIVES AN INCOMING PAYMENT OR INITIATES A SETTLEMENT WITH ANOTHER AGENT
02
SHIELD CHECKS TRUST
SHIELD CALLS /AHS/ROUTE TO GET THE COUNTERPARTY'S HEALTH GRADE (A–F) IN <50MS
03
ROUTE THE PAYMENT
A/B → INSTANT SETTLE · C → ESCROW · D/E/F → REJECT. AUTOMATIC. ZERO MANUAL REVIEW
AHS GradeRouting Decisionsettle / escrow / reject
INTEGRATION PATTERNS
// COPY-PASTE READY
from ahm_shield import AHMShield

shield = AHMShield(api_key="ahm_live_...")

# Check a counterparty before settling
decision = shield.route("0x1234...abcd")

if decision.recommendation == "instant_settle":
    settle_payment(amount)
elif decision.recommendation == "escrow":
    create_escrow(amount, timeout="24h")
else:
    reject_payment("Counterparty trust too low")
from ahm_shield import AHMShield

shield = AHMShield(api_key="ahm_live_...")

@shield.guard(min_grade="C")
def process_payment(sender: str, amount: float):
    # Only runs if sender's AHS grade >= C
    # Raises AHMRejectError for D/E/F grades
    # Raises AHMEscrowFlag for escrow recommendations
    transfer(sender, amount)
    return {"status": "settled"}

# Works with async too
@shield.guard(min_grade="B")
async def high_value_transfer(sender: str, amount: float):
    await settle_instantly(sender, amount)
from fastapi import FastAPI
from ahm_shield.middleware import AHMShieldMiddleware

app = FastAPI()

# Add Shield to your entire API
app.add_middleware(
    AHMShieldMiddleware,
    api_key="ahm_live_...",
    address_param="sender",   # query/path param name
    min_grade="C",              # minimum acceptable grade
)

@app.post("/pay")
async def handle_payment(sender: str, amount: float):
    # Shield already checked the sender's trust
    # Request rejected with 403 if grade < C
    return {"settled": amount}
SHIELD PRICING
// ROUTE CHECKS INCLUDED
FREE
$0
DEV / TEST
100 ROUTE CHECKS / MO
1 AGENT
COMMUNITY SUPPORT
GET STARTED →
STARTER
$29/MO
MONTHLY
10K ROUTE CHECKS / MO
UP TO 5 AGENTS
EMAIL SUPPORT
GET STARTER →
ENTERPRISE
$299/MO
MONTHLY
UNLIMITED AGENTS
UNLIMITED ROUTE CHECKS
SLA + DEDICATED SUPPORT
CONTACT US →

BECOME A SHIELD RESELLER

// WHITE-LABEL PARTNER PROGRAM

Building a payment product for agents? Embed trust-routed decisions directly into your platform. Wholesale pricing. Your brand. Our intelligence.

WHOLESALE API RATES X-PARTNER-ID ATTRIBUTION USAGE REPORTING DASHBOARD DEDICATED PARTNER KEY
PARTNER WITH US →