# Tektii Documentation

> Tektii ships two complementary products — the hosted CLI for cloud backtesting and the self-hosted Trading Gateway for paper and live trading.

## Get Started

- [Introduction](https://docs.tektii.com/docs): Tektii ships two complementary products — the hosted CLI for cloud backtesting and the self-hosted Trading Gateway for paper and live trading.
- [Use with Claude Code](https://docs.tektii.com/docs/mcp/claude-code): Set up the Tektii MCP server in Claude Code and run a full register-version → backtest → results loop using only chat.

## CLI (Hosted)

- [Overview](https://docs.tektii.com/docs/cli): The Tektii CLI manages strategies, scenarios, and configuration on the hosted Tektii backtesting platform at api.tektii.com.
- [Install](https://docs.tektii.com/docs/installation): Install the Tektii CLI on macOS, Linux, or Windows to interact with the Tektii backtesting platform.
- [Authenticate](https://docs.tektii.com/docs/authentication): Configure the Tektii CLI to authenticate with your API key and access your resources.
- [Read Workflow](https://docs.tektii.com/docs/workflows/read-workflow): List your strategies and download backtest results using the Tektii CLI.
- [Write Workflow](https://docs.tektii.com/docs/workflows/write-workflow): Push Docker images as strategy versions, then configure, run, and read a backtest using the Tektii CLI.
- [Commands Reference](https://docs.tektii.com/docs/reference/commands): Complete reference for all Tektii CLI commands, options, and usage examples.
- [Available Instruments](https://docs.tektii.com/docs/reference/instruments): Browse the Tektii backtesting data catalog with the management-API GET /v1/instruments endpoint — the symbols, markets, granularities, and date ranges available for scenarios.
- [Plan Limits](https://docs.tektii.com/docs/reference/limits): Per-plan limits for Tektii backtests — how far back a run can reach (historical data recency), how long a single run can span (max backtest length), the monthly quota, and the other caps — so you can size scenarios before you launch them.
- [Troubleshooting](https://docs.tektii.com/docs/troubleshooting): Common errors and solutions for the Tektii CLI, including PATH issues, authentication problems, Docker configuration, and debugging techniques.

## Gateway (Self-Hosted)

- [Overview](https://docs.tektii.com/docs/trading-gateway): The Tektii Trading Gateway is an open-source, self-hosted proxy that normalises multiple broker APIs behind a single REST + WebSocket protocol on port 8080.
- [Install](https://docs.tektii.com/docs/trading-gateway/overview): Set up and run the open-source Trading Gateway to connect your strategies to live brokers via the same REST + WebSocket protocol across backtest, paper, and live modes.
- [Setup](https://docs.tektii.com/docs/trading-gateway/setup): Configure feature-gated builds, verify your gateway installation, set up monitoring, and test locally.
- [Going Live](https://docs.tektii.com/docs/trading-gateway/going-live): Deploy your backtested strategy to paper and live trading using the Trading Gateway with zero code changes.
- Protocol Reference
  - [Overview](https://docs.tektii.com/docs/trading-api): The Trading API is the REST + WebSocket protocol exposed by the Trading Gateway. One protocol covers backtest, paper, and live trading.
  - [Concepts](https://docs.tektii.com/docs/trading-api/concepts): Understand the unified Trading API protocol, execution modes, and how your strategy communicates with the Trading Gateway.
  - [Connection](https://docs.tektii.com/docs/trading-api/connection): Learn how to connect your strategy via the Trading API, configure subscriptions, and handle events.
  - Types
    - [Order Types](https://docs.tektii.com/docs/trading-api/types/orders): Reference documentation for order types, statuses, and request/response schemas in the Trading API.
    - [Position Types](https://docs.tektii.com/docs/trading-api/types/positions): Reference documentation for position types, P&L calculations, and REST endpoints in the Trading API.
    - [Event Types](https://docs.tektii.com/docs/trading-api/types/events): Reference documentation for WebSocket event types, market data events, and client messages in the Trading API.
    - [Instrument Types](https://docs.tektii.com/docs/trading-api/types/instruments): Reference documentation for instrument asset classes, provider-native symbol formats, and how strategies discover tradeable symbols through the Trading Gateway.
  - Messages
    - [WebSocket Messages](https://docs.tektii.com/docs/trading-api/messages/websocket): Reference documentation for WebSocket message types in the Trading API, including event subscriptions, heartbeats, and acknowledgments.
    - [REST Endpoints](https://docs.tektii.com/docs/trading-api/messages/rest): Reference documentation for REST API endpoints in the Trading API, including order management, positions, trades, account information, and market data.
  - Examples
    - [Hello World](https://docs.tektii.com/docs/trading-api/examples/hello-world): A minimal example showing how to connect to the Trading API WebSocket and receive market events.
    - [Placing Orders](https://docs.tektii.com/docs/trading-api/examples/placing-orders): Examples showing how to submit market orders, limit orders, and stop loss orders via the Trading API REST endpoint.
    - [Handling Events](https://docs.tektii.com/docs/trading-api/examples/handling-events): Patterns for handling WebSocket events including market data, order updates, error handling, and graceful recovery in the Trading API.