Developer Reference · v1

Zetta API v1

Programmatic access to agent financial books, attributed revenue, on-chain classification, and Luca economic analysis. RESTful API with tier-based rate limits.

Base URLhttps://www.zettaai.co/api/v1
Get API Key →Manage KeysManifest Spec
Authentication
TypeAPI Key (Bearer token or header)
Header AAuthorization: Bearer zt_live_…
Header BX-API-Key: zt_live_…
Formatzt_live_ production · zt_test_ sandbox
Scopes
read:booksread:revenueread:ledgerread:intelligenceagent:self
NoteAgent-scoped keys (agent:your-slug) can only query their own agent's data. Global keys have read access to all public agent data. Create one in your key dashboard.
Access Tiers
Free
100req/day

Public data. No token required to start.

Developer
500req/day

$LUCA holders — developer-level throughput.

Enterprise
2,000req/day

High-volume access for serious integrations.

Tier determined by $LUCA balance verified via wallet signature. Link your wallet in the Operators Dashboard.

Wallet / Ledger Endpoints
MethodEndpoint · DescriptionParams
GET
/api/v1/ledger-summaryIncome, spend, net flow, budget status
wallet, range
GET
/api/v1/transactionsPaginated transactions with USD values + categories
wallet, range, page, limit
GET
/api/v1/full-reportComplete scan: portfolio, daily flows, categories
wallet, range
POST
/api/v1/categorizeAI-powered transaction categorization
{ wallet, range }
Example — ledger summary
curl "https://www.zettaai.co/api/v1/ledger-summary?wallet=0xabc…&range=30d" \
  -H "Authorization: Bearer zt_live_…"
Response 200
"wallet": "0xabc…123",
"range": "30d",
"summary": {
"total_income": 142380.50,
"total_spend": 18200.00,
"net_flow": 124180.50,
"transaction_count": 4821,
"budget_status": "healthy"
}
Agent-Centric Endpoints

Query financial data for a specific registered agent. Use an agent-scoped key to restrict access to your agent only, or an unscoped key for cross-agent access.

MethodEndpoint · DescriptionParams
GET
/api/v1/agent-books/{slug}Financial statement: revenue, spend, net across declared wallets
range (7d|30d|90d)
GET
/api/v1/agent-books/{slug}/historyHistorical books snapshots for time-series charting
period (7d|30d|90d|all)
GET
/api/v1/agent-revenue/{slug}Classified revenue events for one agent
limit, offset
GET
/api/v1/agent-truth/{slug}Wallet claims, eligibility, manifest status, revenue evidence
—
GET
/api/v1/agent-reportLuca-generated financial narrative and verdict
slug, range
GET
/api/v1/luca/economyAggregate agent economy: GDP, active agents, settlement volume
—
Quickstart — fetch agent books
curl "https://www.zettaai.co/api/v1/agent-books/bankr?range=30d" \
  -H "Authorization: Bearer zt_live_…"
Response 200
"slug": "bankr",
"has_books": true,
"summary": {
"total_revenue": 142380.50,
"total_expenses": 18200.00,
"net_flow": 124180.50,
"tx_count": 4821
}
Rate Limits
PlanReq / minReq / dayNotes
Free10 rpm500 / dayPublic data only. No intelligence endpoints.
Builder60 rpm5,000 / dayFull endpoint access. Agent-scoped by default.
Pro300 rpmUnlimitedGlobal read + Luca analysis + custom key scopes.

Rate limit status in every response: X-RateLimit-Remaining · X-RateLimit-Reset

Error Codes
HTTPCodeMeaning
401unauthorizedMissing or invalid API key.
403forbiddenAgent-scoped key accessing a different agent.
404agent_not_foundNo agent with that slug in the registry.
409no_booksAgent indexed but no wallet manifest declared.
429rate_limitedRetry after X-RateLimit-Reset.
503registry_unavailableData layer offline. Safe to retry with backoff.
Agent-Scoped Keys & Manifest

An agent-scoped key is a standard API key whose name follows the pattern agent:your-slug. The API enforces this key can only query data for that agent — any cross-agent request returns 403. Create one in your key dashboard.

To have your agent indexed on the registry, submit a wallet manifest at /manifest. The manifest links your agent to its treasury and fee wallets, enabling financial attribution.

Get your API key

Free tier: 500 requests / day. No credit card required.

Request Access →Manifest Spec