From zero to policy-enforced agent card in 10 minutes.

// Update a card's daily limit via the Admin API
// (or use the Policy Editor in /admin)

await fetch('/api/admin/policy', {
  method:  'PATCH',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    card_token:          'card_mock_abc123',
    daily_limit_dollars: 100,            // $100.00/day cap
  }),
})

// Response
// { "ok": true, "updated": { "card_token": "card_mock_abc123", "daily_limit": 10000 } }

{
  "card_token":      "card_mock_9f2a1b3cde4f5a6b",
  "agent_name":      "research-agent-v1",
  "daily_limit_usd": 10,
  "status":          "ACTIVE",
  "safety_switch":   true,
  "provider":        "mock",
  "created_at":      "2026-03-07T13:00:00.000Z"
}

// Node.js / TypeScript — native fetch (Node 18+)

const BACKEND = 'https://botwallet-backend-production.up.railway.app'

const res = await fetch(`${BACKEND}/api/cards/create`, {
  method:  'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    agent_name:          'research-agent-v1',
    daily_limit_dollars: 10,             // Start low — scale after audit review
  }),
})

const card = await res.json()
// {
//   card_token:      "card_mock_9f2a1b3c...",
//   agent_name:      "research-agent-v1",
//   daily_limit_usd: 10,
//   status:          "ACTIVE",
//   safety_switch:   true,   ← policy engine is live
//   provider:        "mock",
//   created_at:      "2026-03-07T13:00:00.000Z"
// }

console.log(`Card issued: ${card.card_token}`)
console.log(`Safety switch: ${card.safety_switch}`) // true

// Store this token in your agent's secure environment.
// Every charge against it is evaluated by BotWallet in real time.
process.env.AGENT_CARD_TOKEN = card.card_token

# Python — requests library
# pip install requests

import requests

BACKEND = "https://botwallet-backend-production.up.railway.app"

response = requests.post(
    f"{BACKEND}/api/cards/create",
    json={
        "agent_name":          "research-agent-v1",
        "daily_limit_dollars": 10,       # Start low — scale after audit review
    },
)

card = response.json()
# {
#   "card_token":      "card_mock_9f2a1b3c...",
#   "agent_name":      "research-agent-v1",
#   "daily_limit_usd": 10,
#   "status":          "ACTIVE",
#   "safety_switch":   True,   <- policy engine is live
#   "provider":        "mock",
#   "created_at":      "2026-03-07T13:00:00.000Z"
# }

print(f"Card issued: {card['card_token']}")
print(f"Safety switch: {card['safety_switch']}")   # True

# Every charge against this card_token is evaluated by BotWallet
# in real time — no agent-side limit checking required.
card_token = card["card_token"]

# Wiring BotWallet into a Claude tool-use agent
# pip install anthropic requests

import anthropic
import requests

client  = anthropic.Anthropic()
BACKEND = "https://botwallet-backend-production.up.railway.app"

# 1. Provision a card for this agent session
card = requests.post(f"{BACKEND}/api/cards/create", json={
    "agent_name":          "claude-researcher",
    "daily_limit_dollars": 25,
}).json()
CARD_TOKEN = card["card_token"]

# 2. Define spend-related tools
tools = [
    {
        "name": "purchase_api_credits",
        "description": (
            "Purchase credits from an AI API provider. "
            "BotWallet enforces the $25/day policy automatically."
        ),
        "input_schema": {
            "type": "object",
            "properties": {
                "provider":    { "type": "string", "description": "e.g. OpenAI, Anthropic" },
                "amount_usd":  { "type": "number", "description": "Amount in USD" },
            },
            "required": ["provider", "amount_usd"],
        },
    }
]

# 3. Run the agent — BotWallet intercepts every spend at the network level
response = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=1024,
    tools=tools,
    messages=[{
        "role":    "user",
        "content": "Purchase $20 of OpenAI API credits for the pipeline.",
    }],
)
# If the agent tries to spend more than $25 today, BotWallet
# declines at the Lithic network layer — before any charge posts.