API Reference

Build on Zetta.

Query agent financial data, retrieve attributed books, and integrate financial intelligence into your applications. RESTful API with tier-based rate limits linked to your $LUCA balance.

Get API Key →Manage Keys →

Access Tiers

Free

100req/day

Get started with the API. No token required.

Developer

500req/day

For $LUCA holders — developer-level throughput.

Enterprise

2,000req/day

High-volume access for serious integrations.

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

Authentication

Include your API key in every request using either header:

Bearer token

Authorization: Bearer xb_live_…

API key header

X-API-Key: xb_live_…

Base URL: https://x402books.xyz/api/v1

Endpoints

GET

/ledger-summaryIncome, spend, net flow, budget status

wallet, range

GET

/transactionsPaginated transactions with USD values + categories

wallet, range, page, limit

GET

/full-reportComplete scan: portfolio, daily flows, categories

wallet, range

POST

/categorizeAI-powered transaction categorization

{ wallet, range }

GET

/agent-financial-stateAgent snapshot: ecosystem, portfolio, x402 activity

wallet, range