Help CenterHelp Center

Help Center

Find answers to your questions about the Zoris Engine.

Support and Resources

Welcome to the Zoris Help Center. Explore our guides and FAQs for assistance:

Common Issues

401 Unauthorized on all requests

Verify that the X-API-Key header is present and matches a valid key. For internal communication, ensure the master key environment variable is correctly set in the server-side .env file.

502 Bad Gateway

The API process has crashed. Check the execution logs for stack traces and restart the service.

Stale market data

The upstream telemetry scraper may have failed. Verify that the cron schedule is active and that data was successfully transferred. Market data updates after the daily pipeline run on weekdays.

AI accuracy showing 0%

This occurs when the performance log has no entries yet (first day of operation) or if the column mapping is incorrect. Accuracy metrics build over time as the pipeline runs daily.

Trapped positions (cannot exit)

The liquidity rail prevents entering illiquid positions, but existing positions from before the rail was implemented may be stuck with zero daily volume. These are flagged as TRAPPED and excluded from liquid equity calculations. The executor will attempt partial exits when volume appears.

422 Unprocessable Entity

Schema validation failure. Check the FastAPI OpenAPI spec at /docs to align your JSON payload structure with the expected Pydantic models.

403 Forbidden

The provided API Key does not have the required tier (PRO/INSTITUTIONAL) to access the requested endpoint.