Errors

OwlViz API errors use a consistent JSON envelope:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable message."
  }
}

The TypeScript SDK throws OwlVizApiError with status, code, and message parsed from this shape.

import { OwlViz, OwlVizApiError } from '@owlviz/sdk';

try {
  await client.assets.get('not-a-valid-mint');
} catch (err) {
  if (err instanceof OwlVizApiError) {
    console.error(err.code, err.status, err.message);
  }
}

Client guidance

• Treat any non-2xx as failure; read error.code when present.
• Legacy Fastify validation responses may omit error.code — fall back to message or HTTP status.
• Stack traces are never returned to clients.

Common codes (sample)

Full matrix and retry behavior: [errors-and-rate-limits.md](./errors-and-rate-limits.md).