AgentPay Documentation

curl -X POST https://leofundmybot.dev/v1/spend \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ap_live_your_api_key" \
  -d '{
    "amount": 1.00,
    "description": "Test payment"
  }'

X-API-Key: ap_live_your_api_key

curl -X POST https://leofundmybot.dev/v1/spend \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ap_live_your_api_key" \
  -d '{
    "amount": 5.00,
    "description": "OpenAI GPT-4 API call",
    "idempotency_key": "req_abc123",
    "skip_approval": false
  }'

{
  "id": "txn_8x7k2mNpQ",
  "status": "completed",
  "amount": 5.00,
  "description": "OpenAI GPT-4 API call",
  "idempotency_key": "req_abc123",
  "balance_remaining": 245.00,
  "created_at": "2026-02-23T07:00:00Z"
}

{
  "available": 245.00,
  "pending": 10.00,
  "currency": "USD"
}

{
  "transactions": [
    {
      "id": "txn_8x7k2mNpQ",
      "amount": 5.00,
      "description": "OpenAI GPT-4 API call",
      "status": "completed",
      "created_at": "2026-02-23T07:00:00Z"
    }
  ],
  "total": 42,
  "limit": 20,
  "offset": 0
}

{
  "address": "0x1234...abcd",
  "chain": "base",
  "balance_usdc": 150.00,
  "created_at": "2026-01-15T12:00:00Z"
}

{
  "id": "send_xk29m...",
  "status": "pending",
  "tx_hash": "0xabc123...",
  "amount": 50.00,
  "to_address": "0x5678...efgh",
  "chain": "base"
}

{
  "card_id": "card_m8x2...",
  "last4": "4242",
  "brand": "visa",
  "exp_month": 12,
  "exp_year": 2027,
  "status": "active",
  "spending_limit": 500.00
}

{
  "id": "wh_3k9x...",
  "url": "https://your-server.com/webhooks/agentpay",
  "events": ["transaction.completed", "approval.required"],
  "secret": "whsec_...",
  "created_at": "2026-02-23T07:00:00Z"
}

{
  "id": "apr_x8m2...",
  "transaction_id": "txn_8x7k2mNpQ",
  "status": "approved",
  "amount": 50.00,
  "description": "Monthly server bill",
  "approved_by": "owner",
  "approved_at": "2026-02-23T07:05:00Z",
  "created_at": "2026-02-23T07:00:00Z"
}

import hmac
import hashlib

def verify_webhook(payload: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(),
        payload,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

import time
import agentpay

client = agentpay.Client(api_key="ap_live_...")

# Create a spend that may need approval
txn = client.spend(amount=100.00, description="Cloud server monthly")

if txn.status == "pending_approval":
    print(f"Waiting for approval: {txn.id}")
    while True:
        approval = client.get_approval(txn.approval_id)
        if approval.status == "approved":
            print("Approved! Transaction will complete.")
            break
        elif approval.status == "rejected":
            print("Rejected by owner.")
            break
        time.sleep(5)  # Poll every 5 seconds
else:
    print(f"Auto-approved: {txn.id}")

{
  "error": "insufficient_funds",
  "message": "Your agent's balance ($5.00) is less than the requested amount ($10.00)."
}

pip install agentpay

from agentpay import AgentPayClient

client = AgentPayClient(api_key="ap_live_your_api_key")

# Or async:
from agentpay import AgentPayAsyncClient
client = AgentPayAsyncClient(api_key="ap_live_your_api_key")

result = client.spend(
    amount=5.00,
    description="OpenAI GPT-4 API call",
    idempotency_key="req_abc123"
)

print(f"Transaction: {result.transaction_id}")
print(f"Remaining: ${result.remaining_balance}")

balance = client.get_balance()
print(f"Available: ${balance.balance_usd}")
print(f"Daily spent: ${balance.daily_spent_usd}")

txns = client.get_transactions(limit=10)
for t in txns:
    print(f"{t.created_at}: ${t.amount} — {t.description}")

import httpx

# On-chain send via REST API
response = httpx.post(
    "https://leofundmybot.dev/v1/wallet/send-usdc",
    headers={"X-API-Key": "ap_your_api_key"},
    json={"to_address": "0x5678...efgh", "amount": 50.0, "chain": "base"}
)
result = response.json()
print(f"TX Hash: {result['tx_hash']}")

webhook = client.register_webhook(
    url="https://your-server.com/webhooks/agentpay",
    events=["spend", "refund", "transfer"]
)
print(f"Signing secret: {webhook.secret}")

# Verify incoming webhooks with HMAC-SHA256
import hmac, hashlib
def verify_webhook(payload: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

npm install agentpay

import { AgentPayClient } from 'agentpay';

const client = new AgentPayClient({ apiKey: 'ap_live_your_api_key' });

// Spend
const tx = await client.spend(5.00, 'GPT-4 API call');
console.log(`Remaining: $${tx.remaining_balance}`);

// Check balance
const balance = await client.getBalance();
console.log(`Available: $${balance.balance_usd}`);

// Send USDC
const send = await client.sendUsdc('0x5678...', 50.0, 'base');
console.log(`TX: ${send.tx_hash}`);