REST API
API Overview
21 endpoints for programmatic access to scores, transactions, budgets, and verification.
The Qova REST API runs on Hono + Bun with 21 endpoints. All responses are JSON. Rate-limited, cached, and validated with Zod.
Base URL: https://api.qova.cc
Response Format
{
"success": true,
"data": { ... }
}Error responses:
{
"success": false,
"error": {
"code": "AGENT_NOT_FOUND",
"message": "Agent 0x1234... is not registered"
}
}Endpoint Groups
- Agent Endpoints - 6 endpoints for agent CRUD and scoring
- Transaction Endpoints - 2 endpoints for recording and stats
- Budget Endpoints - 4 endpoints for spending limits
- Score Endpoints - 5 CRE-compatible scoring endpoints
- Verification Endpoints - 2 endpoints for agent verification
Middleware
| Layer | Description |
|---|---|
| CORS | Cross-origin enabled |
| Body Limit | 1MB max request body |
| Rate Limiting | Per-IP limits (see each endpoint) |
| Cache | 30s TTL on GET requests |
| Validation | Zod schema validation |
| Error Handler | Structured error codes |