mixrpay 0.6.0

MixrPay Agent SDK - Enable AI agents to make x402 payments with session keys

MixrPay Agent SDK for Python

Enable AI agents to make autonomous payments.

Installation

pip install mixrpay

Setup

export MIXRPAY_SESSION_KEY=sk_live_...

Session keys are created by wallet owners at mixrpay.com/wallet/sessions.

Basic Usage

from mixrpay import AgentWallet

wallet = AgentWallet(session_key="sk_live_...")

# Call a paid API
response = await wallet.call_merchant_api(
    url="https://api.merchant.com/generate",
    merchant_public_key="pk_live_...",
    price_usd=0.05,
    json={"prompt": "Hello world"}
)

data = response.json()

Session Management

# Sessions are handled automatically, but you can manage them:
session = await wallet.get_or_create_session(
    merchant_public_key="pk_live_...",
    spending_limit_usd=25,
    duration_days=7,
)

# List sessions
sessions = await wallet.list_sessions()

# Revoke when done
await wallet.revoke_session(session.id)

Error Handling

from mixrpay import (
    AgentWallet,
    InsufficientBalanceError,
    SessionLimitExceededError,
)

try:
    response = await wallet.call_merchant_api(...)
except InsufficientBalanceError as e:
    print(f"Low balance. Top up: {e.top_up_url}")
except SessionLimitExceededError:
    print("Session limit exceeded")

Spending Controls

wallet = AgentWallet(
    session_key="sk_live_...",
    max_payment_usd=1.0,  # Client-side safety limit
    on_payment=lambda p: print(f"Paid ${p.amount_usd}"),
)

# Check balance
balance = await wallet.get_balance()
stats = wallet.get_spending_stats()

Context Manager

async with AsyncAgentWallet(session_key="sk_live_...") as wallet:
    response = await wallet.call_merchant_api(...)

LangChain Integration

from langchain.tools import BaseTool
from mixrpay import AgentWallet

class PaidSearchTool(BaseTool):
    name = "paid_search"
    description = "Premium search ($0.05/query)"
    
    def __init__(self, session_key: str):
        super().__init__()
        self.wallet = AgentWallet(session_key=session_key)
    
    async def _arun(self, query: str) -> str:
            response = await self.wallet.call_merchant_api(
                url="https://api.search.com/query",
                merchant_public_key="pk_live_...",
                price_usd=0.05,
                json={"query": query}
            )
            return response.json()["results"]

Documentation

Full documentation at mixrpay.com/docs

License

MIT