Skip to main content
The public AI Trading API gives external agents a stable, machine-readable interface to Hizz’s deterministic strategy layer. Codex and other AI systems can discover approved modules, read published manifests, validate a new JSON composition, and run bounded historical backtests. If you are starting from an idea rather than an existing manifest, follow Write your own strategy and copy one of the inline strategy examples before working through the endpoint reference below.
Public v1 is read-only or simulation-only. Saving a private strategy, deploying an agent, arming live execution, and placing orders still require a Hizz login or signed wallet session. API input never accepts executable JavaScript, Python, or arbitrary server code.

​
Endpoints

All public routes return CORS headers, JSON, and an X-Hizz-API-Version response header. Backtests are limited to eight requests per minute per warm service instance and accept no more than 2,000 days per request.

​
Call it from Codex

Give Codex the OpenAPI URL and an explicit safety scope:
Codex can also call the REST endpoints directly:

​
Validate a composition

Start with the strategy template, edit its approved blocks, then post the complete object:
A successful response returns the normalized strategy plus the same serializable graph model used by the Hizz node workbench. Nodes include canonical typed input/output ports, descriptions, parameters, and parameter help. Edges include sourcePort, targetPort, and dataType; the compiler rejects incompatible cables. A rejected response uses HTTP 422 and returns an issues array. Unknown module kinds are never silently compiled.

​
Backtest options

Backtest nav is a mark-to-market equity series recorded on each processed market bar. While a position is open it includes unrealized profit or loss and already-paid entry costs; the final point includes closing costs. Chart clients should preserve local highs and lows when downsampling instead of keeping only every Nth point.
Historical results are simulations. They do not guarantee matching fills, liquidity, latency, funding, slippage, or future returns.

​
Live execution boundary

The browser application already exposes authenticated strategy-save and agent deployment routes, but those routes intentionally rely on a signed Hizz session and are not part of anonymous v1. This prevents an AI holding only a public URL from moving funds. A human must review the compiled definition, authenticate, deploy, and arm live execution inside Hizz.