---
name: hanzo
description: "Use Hanzo's API at https://api.hanzo.ai/v1 as an agent: get a key with a wallet and no person, call it and pay. Full instructions: https://hanzoskills.com/hanzo.md"
---

# Hanzo

> Hanzo's API for agents: one key for every capability listed at https://api.hanzo.ai/v1.

Read the full instructions first: https://hanzoskills.com/hanzo.md

## Start with a wallet, no person

1. GET https://hanzo.id/v1/iam/web3/nonce?chain=evm&address=<address>
2. Sign the CAIP-122 message it describes with EIP-191 personal_sign
3. POST https://hanzo.id/v1/iam/web3/verify (type code, PKCE S256); a first-seen wallet gets its own account and organization
4. POST https://hanzo.id/v1/iam/oauth/token, the code for a token
5. POST https://api.hanzo.ai/v1/account/keys, an API key
6. POST https://api.hanzo.ai/v1/chat/completions, model zen-free, free
7. GET https://api.hanzo.ai/v1/billing/crypto/options, the chains and tokens a deposit address is watched for
8. POST https://api.hanzo.ai/v1/billing/crypto/deposit {chain, token}, an address of your own; send that token on that chain to it
9. GET https://api.hanzo.ai/v1/billing/balance, `cash` — what the deposit is credited to once the chain confirms it

## The API

- Capabilities: https://api.hanzo.ai/v1
- OpenAPI: https://api.hanzo.ai/v1/openapi.json
- MCP: https://api.hanzo.ai/v1/mcp
- Keys, for a person: https://console.hanzo.ai/api-keys