x402Books AI

The financial intelligence layer for the agent economy.

AI agents are becoming economic actors. They pay for APIs, data, compute, and services — all onchain, all in USDC. But raw wallet data tells you nothing useful on its own.

x402Books AI solves this. It scans any Base wallet and turns raw USDC activity into structured financial reports, AI-categorized transactions, exportable data, and agent-readable JSON output.

What you can do

• Scan any Base wallet and view spend, income, and net flow
• AI-categorize every transaction — API calls, compute, data, services, income
• Review flagged or anomalous activity in a dedicated queue
• Export financial reports as PDF, CSV, or agent-ready JSON
• Share public wallet reports via a permanent link — no login required
• Query wallet financial data programmatically via the API

Who it's for

Why it matters

Without a financial intelligence layer, agent wallet activity is invisible — raw hashes, no context, no categories. You can't tell what was spent, where income came from, or whether a transaction was unusual.

x402Books AI makes wallet activity readable, reportable, and actionable — for both humans and the agents themselves.

V1 Features

Everything included in the live v1 release.

How It Works

Six steps from raw wallet data to financial intelligence.

Transaction categories

AI categorization assigns each transaction one of the following labels:

api_call          → API endpoint consumption
data_access       → Data query or feed access
compute           → Compute or inference cost
agent_service     → Payment to another agent
subscription      → Recurring service payment
income            → Inbound USDC received
refund            → Returned payment
internal_transfer → Wallet-to-wallet self-transfer
unknown           → Unclassified activity

Core Pages

Every page in the x402Books AI app and what it does.

API Reference

Programmatic access to wallet financial intelligence.

Endpoints

GET /api/ledger/summary?wallet=0x...&period=30d

{
  "wallet": "0x7d3f...42f1",
  "range": "30d",
  "total_spend": 42.80,
  "total_income": 91.20,
  "net_flow": 48.40,
  "transaction_count": 128,
  "likely_x402_count": 94,
  "top_category": "api_call",
  "budget_status": "safe"
}

GET /api/ledger/transactions?wallet=0x...&period=30d&page=1

{
  "transactions": [
    {
      "tx_hash": "0xabc...",
      "direction": "expense",
      "amount_usdc": 0.42,
      "category": "api_call",
      "counterparty": "0xdef...",
      "is_likely_x402": true,
      "confidence_score": 92,
      "timestamp": "2026-05-01T14:32:00Z"
    }
  ],
  "total": 128,
  "page": 1
}

POST /api/ledger/categorize
Content-Type: application/json

{
  "wallet": "0x7d3f...42f1",
  "period": "30d"
}

GET /api/ledger/report?wallet=0x...&period=30d

Agent JSON output

x402Books AI generates structured JSON that agents can consume directly to understand their own financial state. This enables agents to make budget-aware decisions.

{
  "wallet": "0x7d3f...42f1",
  "generated_at": "2026-05-12T10:00:00Z",
  "range": "30d",
  "summary": {
    "total_spend": 42.80,
    "total_income": 91.20,
    "net_flow": 48.40,
    "transaction_count": 128
  },
  "categories": [
    { "category": "api_call", "total_usdc": 18.40, "count": 74 },
    { "category": "data_access", "total_usdc": 11.25, "count": 31 },
    { "category": "compute", "total_usdc": 13.15, "count": 23 }
  ],
  "report": {
    "title": "Healthy agent wallet with consistent API spend",
    "narrative": "This wallet shows steady outflows across API and compute categories...",
    "budget_status": "safe",
    "top_category": "api_call"
  }
}

$LUCA

The token for Luca — not for x402Books API access.

$LUCA is Luca's intelligence token. It unlocks the full power of Luca as a financial intelligence agent — deeper analysis, premium reports, and priority verification. It is not required to use x402Books or the registry API.

Access tiers

Monetization

Multiple revenue streams built for the agent economy.

Roadmap

Six phases from v1 to the financial operating system for autonomous agents.

Security

x402Books AI is read-only. It never touches your funds.

What x402Books AI does not do

• Request or store private keys
• Execute transactions from any wallet
• Take custody of funds
• Access wallet signing capabilities
• Store raw wallet secrets

What x402Books AI does

• Reads public onchain USDC transfer data via Base RPC
• Stores Privy user IDs, email addresses, and X handles in Supabase
• Associates wallet addresses with user sessions (opt-in)
• Generates AI summaries using Claude Haiku (Anthropic)

Authentication

User authentication is handled entirely by Privy. x402Books AI does not implement its own credential store. Sessions are issued as HMAC-signed cookies with no sensitive data embedded.

Data handling

All wallet activity analyzed by x402Books AI is sourced from public Base chain data. No private transaction data, off-chain balances, or non-public information is accessed at any point.

FAQ

Common questions about x402Books AI.