NEXT_PUBLIC_API_URL. This repository does not hardcode a public API hostname, so examples use $API_ORIGIN.
Endpoint inventory
All JSON responses include an
X-Request-ID header. Token and activity values are indexed and can lag chain receipts. Integer financial amounts are decimal strings in base units.
Service and object responses
GET /health does not query PostgreSQL:
GET /readyz returns the same shape with status ready after a successful database ping, or 503 not_ready. Neither endpoint accepts parameters.
GET /objects/* uses the remaining path as an object key. It streams the stored image or JSON object with immutable caching, returns application/json for .json keys, and returns 404 if storage is unavailable or the object does not exist.
For all token, creator, trade, and activity routes, malformed addresses return 400 invalid_address; invalid pagination returns 400 invalid_request; unexpected repository failures return 500 internal_error. See Errors.