Open AgentPay Python SDK (`open-agentpay`)

The Open-Source Financial Firewall & Micro-Payment Infrastructure for Autonomous AI Agents

📚 Documentation • 💻 GitHub Repository • 🐦 Follow on X (@OpenAgentPay) • 🐛 Report Issue

💡 What is AgentPay?

AgentPay equips autonomous AI agents with micro-payments (Circle USDC on Arbitrum Sepolia & Base Sepolia) governed by an in-process, non-custodial Financial Firewall. It transparently intercepts HTTP 402 Payment Required responses, validates policy limits, and signs off-chain authorizations—protecting agent wallets against runaway loops and LLM hallucinations.

📦 Package Name Note: The canonical PyPI distribution is open-agentpay (official aliases: agentpay-core, agentpay-firewall). Regardless of which package you install, you import agentpay in Python code.

⚡ Quickstart

1. Installation

pip install open-agentpay

(Optional LangChain support):

pip install "open-agentpay[langchain]"

2. Basic Usage: On-Chain Mode with Financial Firewall

Transparently intercepts HTTP 402 challenges, enforces local policy limits, and signs off-chain EIP-712/EIP-3009 authorizations:

import os
from agentpay import AgentPayClient, LocalSigner
from agentpay.policy import SQLitePolicyEngine, PolicyConfig

# 1. Initialize local signer (non-custodial private key, 0 gas required)
# ⚠️ TESTNET DEVELOPMENT ONLY: This fallback key is Hardhat/Anvil's public Account 0 key.
# NEVER transfer mainnet funds to this address! In production, inject via environment variable:
private_key = os.getenv("AGENT_PRIVATE_KEY", "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80")
signer = LocalSigner(private_key)

# 2. Configure local financial firewall
policy = SQLitePolicyEngine.create_in_memory(
    PolicyConfig(
        id="agent_firewall",
        name="Agent Firewall",
        wallet_address=signer.address,
        max_per_tx_base_units=100_000,  # Max $0.10 per call
        rolling_budget_24h_base_units=1_000_000,  # Daily cap $1.00
        circuit_max_rpm=5,  # Trip circuit breaker if > 5 calls/min
    )
)

# 3. Create client with automatic x402 challenge negotiation
client = AgentPayClient(signer=signer, policy=policy)

# 4. Transparent call (auto-pays 402 challenge via EIP-712 off-chain signature)
response = client.get("https://api.seller.com/v1/market-data?ticker=NVDA")
print(response.json())

3. Virtual Wallet Mode (API Key Path)

For sub-millisecond execution using a pre-funded virtual ledger:

import os
from agentpay import AgentPayClient, LocalSigner
from agentpay.policy import SQLitePolicyEngine, PolicyConfig

private_key = os.getenv("AGENT_PRIVATE_KEY", "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80")
signer = LocalSigner(private_key)
client = AgentPayClient(
    signer=signer,
    policy=SQLitePolicyEngine.create_in_memory(
        PolicyConfig(
            id="wallet_firewall",
            name="Wallet Firewall",
            wallet_address=signer.address,
            max_per_tx_base_units=100_000,
            rolling_budget_24h_base_units=5_000_000,
            whitelist_domains=frozenset(["gateway.seller.com"]),
        )
    ),
    headers={"Authorization": "Bearer agp_live_your_api_key"},
    wallet_challenge_mode=True,
)

response = client.get("https://gateway.seller.com/v1/compute")

4. LangChain Tool Integration (@paid_tool)

Convert any Python function into a paid LangChain tool protected by the financial firewall:

from agentpay.integrations.langchain import paid_tool


@paid_tool(name="fetch_stock_quote", description="Fetch real-time stock prices", client=client)
def fetch_stock_quote(ticker: str) -> dict:
    resp = client.get(f"https://api.seller.com/v1/market-data?ticker={ticker}")
    return resp.json()


# Invoked seamlessly by LangChain agents
result = fetch_stock_quote.invoke({"ticker": "NVDA"})

5. Async Client (AsyncAgentPayClient)

For high-concurrency agent workflows:

import asyncio
from agentpay import AsyncAgentPayClient, LocalSigner
from agentpay.policy import SQLitePolicyEngine, PolicyConfig


async def main():
    async with AsyncAgentPayClient(signer=signer, policy=policy) as client:
        response = await client.get("https://api.seller.com/v1/market-data?ticker=NVDA")
        print(response.json())


asyncio.run(main())

🛡️ Core Capabilities

📖 Documentation & Community

• Official Documentation: https://openagentpay.dev/
• GitHub Repository: https://github.com/open-agentpay/AgentPay
• Twitter / X: @OpenAgentPay
• Issue Tracker: GitHub Issues

📄 License

Apache-2.0 License. See LICENSE for details.