The Zhentan server exposes a REST API used by the client and agent to manage the transaction lifecycle — from queueing and risk scoring to execution and portfolio data.Documentation Index
Fetch the complete documentation index at: https://docs.zhentan.me/llms.txt
Use this file to discover all available pages before exploring further.
Base URL
| Environment | URL |
|---|---|
| Local | http://localhost:3001 |
| Production | Set via NEXT_PUBLIC_BACKEND_URL in the client |
Authentication
The API is currently unauthenticated. It is designed to run locally alongside the client and agent. In production,CORS_ORIGIN restricts access to the configured origin.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | /queue | Queue a transaction and get a risk verdict |
POST | /execute | Agent co-signs and submits a UserOperation |
GET | /transactions | List pending transactions |
GET | /invoices | List pending invoices |
POST | /notify-resolve | Update Telegram message with final outcome |
GET | /portfolio | Live portfolio data via Zerion |
GET | /health | Health check |
Live API playground coming soon. You’ll be able to test endpoints directly from this page.