Documentation
Introduction

Zetta

Financial Identity Infrastructure for Autonomous Agents.

AI agents are becoming economic actors. They operate wallets, settle payments, and generate revenue — all onchain. But raw wallet data tells you nothing about who the agent is, whether it can be trusted, or what it's actually doing.

Zetta solves this. We give every autonomous agent a verifiable financial identity — indexed in a public registry, scored for transparency, verified through a manifest standard, and interpreted by Luca.

In one line: Zetta is the open standard for agent financial identity.

What Zetta does

  • Indexes — 125+ autonomous agents across 5 ecosystems in a public registry
  • Verifies — agents declare wallets via manifest, Zetta validates ownership
  • Scores — Transparency Score (0–100) based on wallets, status, activity, evidence
  • Classifies — settlement patterns: treasury, revenue, operational spend, inference
  • Interprets — Luca writes financial verdicts and monitors agent finances
  • Distributes — SVG badges, public profiles, embeddable cards, API data

Who it's for

Agent Developers

Give your agent a verifiable financial identity. Declare wallets, get verified, embed a trust badge.

Protocol Teams

Index your ecosystem's agents. Surface financial transparency across your community.

Builders & Auditors

Query live agent financial data via API. Verify wallet ownership. Assess trust signals.

Prediction Markets

Use /api/stats as a live resolution oracle for adoption-based prediction markets.

The architecture

Three layers. Each one depends on the one below it.

Stack
Zetta  =  infrastructure  (index, verify, classify, display)
Luca       =  intelligence    (interpret, score, verdict, monitor)
$LUCA      =  ecosystem asset (API tier, priority verification)
Introduction

What We Built

The full infrastructure stack — live today.

All features below are live. 125+ agents indexed.
datasetAgent Registry
  • 125+ autonomous agents indexed
  • 5 ecosystems: AEON, BANKR, Virtuals, Base, EigenCloud
  • Sort by score, status, health, activity
folder_openWallet Manifest Standard
  • .agent/wallets.json open format
  • GitHub + Gitlawb repo support
  • GitHub Action for automated validation
verified_userVerification System
  • Six-tier pipeline: Candidate → Luca Managed
  • Manifest submission fast-tracks to Wallets Declared
  • Wallet claim + signed proof paths
analyticsTransparency Scores
  • 0–100 composite score per agent
  • Factors: wallets, status, activity, evidence, verdict
  • Live on every public profile
psychologyLuca Intelligence
  • AI writes financial summaries for every agent
  • Analyzes settlement patterns and attribution
  • Runs integrity passes + approves claims
badgeSVG Verification Badges
  • Live badge at /api/badge/[slug]
  • Embed in GitHub READMEs in one line
  • Updates automatically as status changes
person_pinAgent Profiles
  • Public profile at /registry/[slug]
  • Wallets, scores, settlement patterns, Luca verdict
  • Claim banner with manifest + wallet paths
securityNipmod Integration
  • Tool decision events on agent profiles
  • Install / reject / defer with risk levels
  • 181+ events indexed live
Introduction

The Manifest Loop

From zero identity to verified financial profile in four steps.

01

Declare

Add .agent/wallets.json to your agent's GitHub or Gitlawb repo. Declare wallet addresses with roles: treasury, fee recipient, deployer, or operator. The GitHub Action validates the format on every push.

02

Submit

Paste your repo URL into the Claim Banner on your agent's profile page. Zetta fetches the manifest, validates the wallets, and queues the update for Luca review.

03

Verify

Luca reviews the submission. Verified manifests upgrade the agent's status to Wallets Declared. Matching a wallet address via the claim form upgrades to Claimed. Full Verified status follows Luca review.

04

Distribute

A live SVG badge appears at /api/badge/[your-slug]. Embed it in your README. Your Transparency Score updates. Your profile shows declared wallets, settlement patterns, and Luca's financial verdict.

Wallet manifest format

Add this file to your repo at .agent/wallets.json:

.agent/wallets.json
{
  "agent": "MyAgent",
  "ecosystem": "AEON",
  "x": "@MyAgent",
  "website": "https://myagent.xyz",
  "wallets": [
    {
      "address": "0x...",
      "role": "treasury",
      "chain": "base",
      "notes": "Primary treasury wallet"
    }
  ]
}

Verification tiers

Trust pipeline
Candidate          →  Indexed, no proof of ownership
Needs Verification →  Flagged for review
Wallets Declared   →  Manifest submitted + validated ← start here
Claimed            →  Wallet address matches declared wallet
Verified           →  Luca-reviewed, fully verified
Luca Managed       →  Luca actively monitors finances
Product

Core Product

The pages that make up the financial identity infrastructure.

/registryAgent Registry

125+ autonomous agents indexed. Sort by verification tier, activity score, treasury health, or name. Filter by ecosystem and status.

Browse agents, filter by status, sort by score
/registry/[slug]Agent Profile

Public financial identity profile for every agent. Shows declared wallets, transparency score, settlement patterns, Luca verdict, and tool decisions.

View wallets, read Luca verdict, claim profile, embed badge
/lucaLuca

Luca's public interface — financial intelligence agent built on Zetta. Access Luca's analysis, ask questions about agent finances.

Ask Luca, view agent economics, read analysis
/developerDeveloper Portal

API key management with $LUCA tier system. Free: 100 req/day. Holder: 500/day. Whale: 2,000/day.

Generate API key, verify wallet for tier, view usage
/docsDocumentation

Product docs, API reference, manifest standard specification, and integration guides.

Read API docs, copy endpoints, learn manifest format
Product

API Reference

Financial identity data for agents, builders, and prediction markets.

Public endpoints require no auth. Financial intelligence endpoints require an API key — generate one at /developer. Free tier: 100 req/day. $LUCA holders: up to 2,000/day.

Public — no auth required

GET/api/stats

Live adoption metrics across the registry. Includes pre-computed resolution booleans for prediction markets.

Response
{
  "agents_indexed": 125,
  "wallets_declared_or_above": 15,
  "claimed_or_above": 4,
  "verified_or_above": 2,
  "by_status": {
    "Candidate": 89, "Wallets Declared": 12,
    "Claimed": 3, "Verified": 1, "Luca Managed": 1
  },
  "by_ecosystem": {
    "AEON":  { "total": 8, "wallets_declared": 2, "verified": 1 },
    "BANKR": { "total": 34, "wallets_declared": 5, "verified": 0 }
  },
  "markets": {
    "100_manifests_before_august": false,
    "50_claimed_before_q4": false,
    "top_ecosystem_by_verified": { "ecosystem": "AEON", "count": 2 }
  },
  "updated_at": "2026-06-07T12:00:00Z"
}
GET/api/badge/[slug]

Returns a live SVG verification badge for any indexed agent. Embed in GitHub READMEs or project pages.

Example
GET /api/badge/aeon
→ image/svg+xml — "aeon | Wallets Declared" (blue)

Cache-Control: public, max-age=60, stale-while-revalidate=300

# In a README:
![Zetta](https://www.x402books.xyz/api/badge/aeon)

Badge colors: Verified / Luca Managed → green · Claimed → purple · Wallets Declared → blue · Candidate → gray

GET/api/registry/agents

Returns all indexed agents with verification status, ecosystem, transparency scores, and declared wallets.

Response (excerpt)
{
  "agents": [
    {
      "name": "Aeon",
      "symbol": "AEON",
      "ecosystem": "AEON",
      "verificationStatus": "Wallets Declared",
      "treasuryHealth": "Active",
      "wallets": [
        { "address": "0x...", "label": "likely treasury" }
      ]
    }
  ],
  "fromSupabase": true
}

Registry — no auth required

POST/api/registry/fetch-manifest

Fetch and validate a .agent/wallets.json manifest from a GitHub or Gitlawb repo. Queues wallet declarations for Luca verification.

Request
POST /api/registry/fetch-manifest
Content-Type: application/json

{ "repo_url": "https://github.com/your-org/your-repo" }
Response
{
  "ok": true,
  "agent": "MyAgent",
  "wallets": [
    { "address": "0x...", "role": "treasury", "label": "likely treasury" }
  ],
  "message": "Manifest submitted. 1 wallet(s) queued for Luca verification."
}
POST/api/registry/claim

Submit a wallet address to claim an agent profile. Checks against declared wallets — a match fast-tracks verification.

Request
POST /api/registry/claim
Content-Type: application/json

{
  "agent_slug": "my-agent",
  "wallet_address": "0x..."
}
Response
{
  "ok": true,
  "matched": true,
  "message": "Wallet matched — claim submitted for review."
}

Financial Intelligence — API key required

GET/api/v1/agent-financial-state

Live treasury health for any wallet — token portfolio, flows, settlement patterns, top counterparties. Also accepts $0.01 USDC x402 payment ($0.007 for $LUCA holders).

Request
GET /api/v1/agent-financial-state?wallet=0x...&range=30d
Authorization: Bearer xb_live_...
Response (excerpt)
{
  "wallet": "0x...",
  "range": "30d",
  "financial_health": {
    "total_income_usd": 91.20,
    "total_spend_usd": 42.80,
    "net_flow_usd": 48.40,
    "budget_status": "safe",
    "transaction_count": 128
  },
  "token_portfolio": [...],
  "top_counterparties": [...],
  "recent_transactions": [...]
}
GET/api/v1/agent-report

Returns a plain-language financial intelligence report for a named agent.

Request
GET /api/v1/agent-report?agentName=Aeon&days=7
Authorization: Bearer xb_live_...
Rate limits: Free — 100 req/day · $LUCA Holder (≥1,000) — 500/day · $LUCA Whale (≥10,000) — 2,000/day. Generate your key at /developer.
Token

$LUCA

The token for Luca — not for Zetta 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 Zetta or the registry API.

analytics
Deep Financial Analysis

Luca goes beyond surface scores. Full settlement classification, treasury runway, counterparty concentration — the complete operational picture.

description
Premium Treasury Reports

Audit-ready financial reports for your agent. Shareable, generated by Luca on demand, structured for compliance.

verified
Priority Verification

Skip the queue. $LUCA holders get priority wallet manifest review and faster profile upgrades in the registry.

Zetta API is separate. Accessing the registry, wallet data, and financial intelligence endpoints does not require $LUCA. API access is tiered by usage volume — free, developer, and enterprise.

Access tiers

FeatureFreeHolder ≥1KWhale ≥10K
Registry API (/api/registry/agents)
Public stats (/api/stats)
Verification badges (/api/badge/*)
Agent financial state (v1)100/day500/day2,000/day
Agent intelligence report (v1)100/day500/day2,000/day
Priority manifest review
Priority claim processing
Premium Luca reports
Enterprise monitoring API
Token

Monetization

Infrastructure companies monetize through trust, access, and data.

01
API Access (live)

Tiered API access for financial intelligence endpoints. Free: 100 req/day. $LUCA Holder: 500/day. $LUCA Whale: 2,000/day.

02
Verification Program

Verification as a service — formal review, Luca verdict, and Verified badge for agent teams that want priority processing.

03
Premium Luca Reports

On-demand deep intelligence reports generated by Luca. Treasury health, settlement quality, runway analysis, counterparty risk.

04
$LUCA Token

Token powers API tier upgrades, priority verification, and future governance over registry standards.

05
Enterprise Monitoring API

Bulk agent monitoring, custom dashboards, and compliance-grade exports for protocols managing agent fleets.

06
Ecosystem Analytics

Aggregated financial intelligence for protocol teams — ecosystem-level transparency scores, adoption metrics, settlement trends.

Vision

Roadmap

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

Phase 1Financial Identity InfrastructureLive
  • 125+ autonomous agents indexed across 5 ecosystems
  • Agent Wallet Manifest standard (.agent/wallets.json)
  • Six-tier verification pipeline: Candidate → Luca Managed
  • Transparency scores + Luca verdicts on every profile
  • SVG verification badges + /api/stats prediction oracle
  • Nipmod tool decision integration — 181+ events live
  • Developer API keys + $LUCA tier system (100 / 500 / 2,000 req/day)
Phase 2Manifest AdoptionUp next
  • Starter templates: OpenAI Agents SDK, LangGraph, CrewAI
  • Registry leaderboards: Most Transparent, Most Verified, Recently Declared
  • Claim flow improvements + claim status tracking
  • Manifest auto-create: unknown agents get profiles on submission
  • Target: 100 manifest submissions · 50 claimed profiles
Phase 3Verification ProgramPlanned
  • Verified Agent Program — formal requirements + public benefits
  • State of Agent Finance — twice weekly intelligence reports (Mon + Thu)
  • Profile sharing improvements: PNG cards, shareable links
  • Homepage featuring verified agents
  • Target: 25 verified profiles
Phase 4Financial IntelligencePlanned
  • Treasury health alerts and runway tracking
  • Settlement quality scoring
  • Recurring spend detection
  • Counterparty concentration analysis
  • Operational finance reports for agent teams
Phase 5Network EffectsPlanned
  • Ecosystem discovery feed — ranked by trust signals
  • Embeddable profile cards for partner sites
  • API partnerships with agent frameworks
  • Zetta as the default financial identity layer for new agents
Phase 6Infrastructure RevenuePlanned
  • Verification as a service
  • Enterprise monitoring API
  • Premium Luca intelligence reports
  • Compliance-grade audit exports
  • Ecosystem analytics packages for protocols
Trust

Security

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

Read-only by design. Zetta AI analyzes public onchain data. It does not require private keys, cannot execute transactions, and holds no custody over any assets.

What Zetta 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 Zetta 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. Zetta 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 Zetta AI is sourced from public Base chain data. No private transaction data, off-chain balances, or non-public information is accessed at any point.

Trust

FAQ

Common questions about Zetta AI.

Trust

Positioning

Financial identity infrastructure for autonomous agents.

The open standard for agent financial identity.

What we are

Zetta is the financial identity layer for the autonomous agent economy — not a wallet scanner, not a dashboard, not a token project.

AI agents are becoming economic actors. They operate wallets, settle payments, generate revenue, and pay for inference — all onchain. But raw blockchain data tells you nothing about who the agent is, whether it can be trusted, or whether its finances are healthy.

Zetta solves the identity problem: every agent gets a verifiable financial identity, publicly readable, verified through an open manifest standard, and interpreted by Luca.

The architecture

Three layers
Zetta  =  infrastructure  (index, verify, classify, display)
Luca       =  intelligence    (interpret, verdict, score, monitor)
$LUCA      =  ecosystem asset (API tier, priority verification)

These are three distinct things. Never blur them.

The moat

The moat is the Agent Wallet Manifest standard. Any agent that adds .agent/wallets.json to their repo plugs into Zetta' verification pipeline, leaderboards, and badge system. As more agents adopt it, the registry becomes the canonical source of truth for agent financial identity.

Infrastructure compounds slowly. Trust compounds slowly. Once infra wins — it is extremely difficult to replace.

What we are not

  • Not a wallet scanner for retail users
  • Not another AI agent personality
  • Not a token project or memecoin
  • Not a dashboard for human wallet tracking
The one question. Before we ship anything: "Does this make autonomous agents more financially readable, trustworthy, or auditable?" If yes — ship it. If no — don't build it.