# Superior Trade API

> Market context and execution runtime for AI trading agents. Deploy
> freqtrade and NautilusTrader strategies in the cloud, bring your own
> keys, and read the market through one data engine.

Every page below is also available as raw markdown at https://docs.superior.trade/md/<path>.
MCP discovery is available at https://docs.superior.trade/.well-known/mcp.json and points to https://api.superior.trade/mcp.

## Quick Start

- [Introduction](https://docs.superior.trade/md/quickstart/introduction): What the API supports, and the two ways code executes on it.
- [Agent](https://docs.superior.trade/md/quickstart/agent): One prompt that sets your AI agent up on Superior — coming soon.

## Getting Started

- [Introduction](https://docs.superior.trade/md/getting-started/introduction): What Superior Trade is, and how the API is organized.
- [Quickstart](https://docs.superior.trade/md/getting-started/quickstart): From an email address to a running strategy — every request shown in full.
- [Authentication](https://docs.superior.trade/md/getting-started/authentication): API keys, the OTP flow, and how humans and agents authenticate.

## Account

- [Registration & OTP](https://docs.superior.trade/md/account/registration): Create an account with an email and a six-digit code.
- [API Keys](https://docs.superior.trade/md/account/api-keys): List, mint, rename, and revoke keys.
- [Usage & Limits](https://docs.superior.trade/md/account/usage): What your account is consuming and where the ceilings are.

## Managed Wallet

- [Overview](https://docs.superior.trade/md/wallet/overview): The managed wallet behind your account.
- [Deposits](https://docs.superior.trade/md/wallet/deposits): Fund the managed wallet and list deposit history.
- [Withdrawals](https://docs.superior.trade/md/wallet/withdrawals): Withdraw managed wallet funds to the verified login wallet.

## Market Context

- [Overview](https://docs.superior.trade/md/context/overview): The data engine — what it serves and where the data comes from.
- [Venues](https://docs.superior.trade/md/context/venues): The capability matrix — venues, frameworks, regions, requirements.
- [Markets](https://docs.superior.trade/md/context/markets): One market-discovery endpoint across every venue.
- [Candles & Funding](https://docs.superior.trade/md/context/market-data): Historical OHLCV and funding rates from immutable dataset releases.
- [Datasets](https://docs.superior.trade/md/context/datasets): Exactly what history exists — coverage windows, releases, gaps.
- [Intelligence](https://docs.superior.trade/md/context/intelligence): Market scans and pair setups from Superior's analysis engine.
- [Leaderboard & Traders](https://docs.superior.trade/md/context/leaderboard): Performing strategies and copyable traders, with honest metrics.

## Runtime

- [Overview](https://docs.superior.trade/md/runtime/overview): The execution layer — what deploys, where it runs, how it's isolated.
- [Frameworks](https://docs.superior.trade/md/runtime/frameworks): Supported open-source frameworks, pinned versions, capability matrix.
- [One-Time Execution](https://docs.superior.trade/md/runtime/executions): Run a script once against your account — no standing process.
- [Deployments](https://docs.superior.trade/md/runtime/deployments): One resource to run any supported framework on any supported venue.
- [Credentials](https://docs.superior.trade/md/runtime/credentials): Managed trading wallets by default; bring your own key when you want custody.
- [Exchange Authorization](https://docs.superior.trade/md/runtime/exchange-authorization): The required steps before a live deployment can trade on Hyperliquid or Lighter.
- [Backtests](https://docs.superior.trade/md/runtime/backtests): Validate a strategy against real history before it touches capital.
- [Paper Trading](https://docs.superior.trade/md/runtime/paper-trading): The same deployment, no capital — a mode, not a separate product.

## Guides

- [Run Freqtrade in the Cloud](https://docs.superior.trade/md/guides/freqtrade-cloud): Move a local freqtrade bot to a managed runtime without changing the strategy.
- [Run NautilusTrader in the Cloud](https://docs.superior.trade/md/guides/nautilus-cloud): Deploy Nautilus strategies against Polymarket, Lighter, and Hyperliquid.
- [Key Safety for BYOK](https://docs.superior.trade/md/guides/byok-security): Scoped keys, agent wallets, and the rules that keep custody with you.
- [Integrate an AI Agent](https://docs.superior.trade/md/guides/agent-integration): The full human-operated agent flow, request by request.

## Reference

- [Errors](https://docs.superior.trade/md/reference/errors): One error shape, a named code for every failure, and a docs link in each.
- [Rate Limits](https://docs.superior.trade/md/reference/rate-limits): Ceilings by area, headers to watch, and how to behave at the limit.
- [Migrating from v1/v2/v3](https://docs.superior.trade/md/reference/migration): How every current endpoint maps onto the unified surface.
- [Design Log](https://docs.superior.trade/md/reference/design-log): Every decision in this design, dated, with reasoning — so it can be revisited and confirmed.