Luca Skills

Wallet Audit

Classify an on-chain address and determine its books-eligibility type. Returns address_type (eoa, token_contract, treasury_contract, etc.) and whether it is compatible with books attribution.

curl -X POST https://www.zettaai.co/api/luca/skills/wallet-audit \
  -H "Authorization: Bearer xb_live_..." \
  -H "Content-Type: application/json" \
  -d '{"address": "0xf1e958db7d1e4c074377946018ad645db4fb158e"}'

{
  "skill": "wallet-audit",
  "address": "0xf1e958db7d1e4c074377946018ad645db4fb158e",
  "chain": "base",
  "address_type": "eoa",
  "books_compatible": true,
  "books_note": "EOA wallet is books-eligible when manifest-declared"
}

Skill Discovery

Call the discovery endpoint to get the full manifest of all available skills — no auth required.

curl https://www.zettaai.co/api/luca/skills

Returns version, all 7 skill definitions with inputs, and the data integrity block.

Authentication

All skill routes (POST) require an API key. Two formats are supported — use whichever fits your stack.

# Option 1 — Bearer token (recommended)
curl -X POST https://www.zettaai.co/api/luca/skills/agent-books \
  -H "Authorization: Bearer xb_live_..." \
  -H "Content-Type: application/json" \
  -d '{"slug": "aeon"}'

# Option 2 — X-API-Key header
curl -X POST https://www.zettaai.co/api/luca/skills/agent-books \
  -H "X-API-Key: xb_live_..." \
  -H "Content-Type: application/json" \
  -d '{"slug": "aeon"}'

Data Integrity Rules

Every skill enforces these rules on every response. They cannot be overridden.