Introduction
What the API supports, and the two ways code executes on it.
Superior Trade is execution infrastructure for developers and AI agents: you bring code — and your own keys only if you want custody — we supply managed runtimes with venue connectivity and a managed trading wallet by default. Base URL https://api.superior.trade; every request after registration authenticates with an x-api-key header.
Supported platforms
Ranked by typical trading volume:
| Venue | Type | Frameworks | Paper |
|---|---|---|---|
 Binance | CEX (spot + perps) | freqtrade | yes |
 Hyperliquid | perp DEX (crypto + HIP-3 equities) | freqtrade, NautilusTrader | yes |
 Lighter | perp DEX | NautilusTrader | not yet |
 Polymarket | prediction market | NautilusTrader | not yet |
The live capability matrix — credential shapes, regions, minimum deposits — is GET /context/venues.
Two kinds of execution
Everything you run on Superior is one of two shapes:
One-time execution — POST /runtime/executions. A script that runs once against your account and exits: place or close a position, rebalance, sweep balances, run a check. You send Python, it executes in an isolated sandbox with your credentials injected, you get the result and logs back. Minutes-bounded, no standing process.
Recurring execution (runtime) — POST /runtime/deployments. A strategy that runs continuously: a freqtrade or NautilusTrader bot watching the market and trading until you stop it (or its alive_until lapses). This is the managed-bot product: isolation, restarts, logs, metrics, lifecycle.
Both use the same credential model: by default Superior creates and manages a trading wallet for your account (deposit and go — no key handling), and BYOK is available when you'd rather bring your own scoped key (agent wallet, trade-only API key) and keep custody entirely on your side.
Where to go next
- Get a key: Registration & OTP — two requests, one six-digit code.
- Validate an idea: Backtests.
- Do something once: One-Time Execution. Run something continuously: Deployments.
- Operating an AI agent? The Agent page is the full flow, request by request.