Errors

HTTP envelope, socket codes, and receipt sync failures.

HTTP errors return the standard envelope with success: false and a human error string. Socket errors emit error with { code, message }.

401 Unauthorized: Missing/invalid JWT, or wallet room subscribe without matching token.
403 Forbidden: Authenticated but not allowed (admin/labs allowlists).
400 / validation: Zod body or query failed; check docs/api.md field names.
429 Rate limited: Global or bucket limit. Back off and retry.
Socket RATE_LIMITED / ROOM_LIMIT: Too many events or rooms on one socket.
Receipt sync failures: POST /buy|/sell|/tokens/create when txHash is missing events, wrong wallet, or already indexed.

jsonerror.json

{
  "success": false,
  "data": null,
  "error": "Invalid signature"
}

Health checks may return HTTP 503 with success: false when database, Redis, RPC, or indexer checks fail. POST /rpc returns raw JSON-RPC errors, not the envelope.