Validator Master Public API

Machine-readable overview of the current public evaluation endpoints and their operational boundaries.

OpenAPI

The machine-readable OpenAPI document is https://api.heartcodeprotocol.org/openapi.json. It is built from repository-owned contract constants and is regression-tested against the TypeScript validators.

Direct evaluation

POST /api/evaluate-response uses contract 1.0.0. Prompt length is limited to 2000 characters and response length to 8000 characters.

Provider-backed evaluation

POST /api/evaluate uses contract 1.0.0. Supported contract provider identifiers are: openai, ollama, gemini, anthropic, xai, nvidia.

Public-alpha admission can return HTTP 429 for quota, global-budget, concurrency, or duplicate-request limits. When a retry interval is known, the response includes Retry-After.

Arena

POST /api/arena uses contract 1.0.0. It accepts 2–5 distinct provider identifiers from: openai, anthropic, google, xai, nvidia.

Arena provider-spend admission preserves global budget and kill-switch protections. Admission exhaustion can return HTTP 429 with Retry-After when available; spend disablement or kill-switch state fails closed.