# Itô Markets

> Institutional dashboard for thematic prediction-market baskets (app.itomarkets.com). Public market-data + ATOP backtesting API and a dashboard HTTP API.

## Docs
- [Public API overview](https://app.itomarkets.com/docs/md/public-api): Market data and ATOP backtesting over one keyed HTTPS surface.
- [Dashboard HTTP API](https://app.itomarkets.com/docs/md/api): Dashboard snapshot, basket state/summary/exposures, streams, and paper trade tickets.

## Public API endpoints
- [GET /baskets](https://app.itomarkets.com/docs/md/public-api/get-baskets): All system baskets with current price and 24h change.
- [GET /baskets/{basket_id}](https://app.itomarkets.com/docs/md/public-api/get-baskets-basket-id): Details and composition stats for one basket.
- [GET /baskets/{basket_id}/price](https://app.itomarkets.com/docs/md/public-api/get-baskets-basket-id-price): Current price plus the latest per-underlyer snapshot.
- [GET /baskets/{basket_id}/history](https://app.itomarkets.com/docs/md/public-api/get-baskets-basket-id-history): Time-ordered price series for charting.
- [GET /baskets/{basket_id}/chart](https://app.itomarkets.com/docs/md/public-api/get-baskets-basket-id-chart): Aggregated OHLC-style chart data for a period.
- [GET /baskets/{basket_id}/metrics](https://app.itomarkets.com/docs/md/public-api/get-baskets-basket-id-metrics): Period returns, intraday change, and 30d volatility.
- [GET /baskets/{basket_id}/underlyers](https://app.itomarkets.com/docs/md/public-api/get-baskets-basket-id-underlyers): Component market prices, weights, and stats.
- [GET /baskets/overrides](https://app.itomarkets.com/docs/md/public-api/get-baskets-overrides): Manual price/composition overrides currently applied to baskets.
- [GET /baskets/volume/daily](https://app.itomarkets.com/docs/md/public-api/get-baskets-volume-daily): Total traded volume aggregated by UTC day from the platform trade ledger.
- [GET /markets/search](https://app.itomarkets.com/docs/md/public-api/get-markets-search): Filtered listing of open Polymarket and Kalshi markets, sorted by volume.
- [GET /markets/{market_id}](https://app.itomarkets.com/docs/md/public-api/get-markets-market-id): Full metadata for a single market including categorization, basket assignment, and trading data.
- [GET /markets/{market_id}/history](https://app.itomarkets.com/docs/md/public-api/get-markets-market-id-history): Daily close price time series for a single market.
- [GET /data/orderbook](https://app.itomarkets.com/docs/md/public-api/get-data-orderbook): L2 orderbook snapshots from ClickHouse hot storage. Maximum 168-hour (7-day) query window per request.
- [GET /data/prices](https://app.itomarkets.com/docs/md/public-api/get-data-prices): Daily close prices for up to 50 markets in a single request.
- [GET /data/spot/klines](https://app.itomarkets.com/docs/md/public-api/get-data-spot-klines): Historical spot OHLCV candles for major cryptoassets (BTC, ETH, SOL). Sourced from ClickHouse hot storage.
- [GET /backtests/atop/strategies](https://app.itomarkets.com/docs/md/public-api/get-backtests-atop-strategies): Dispatchable strategy templates with parameter schemas.
- [POST /backtests/atop/strategies](https://app.itomarkets.com/docs/md/public-api/post-backtests-atop-strategies): Create a dispatchable custom strategy from an approved template. Returns 201.
- [GET /backtests/atop/custom-strategies](https://app.itomarkets.com/docs/md/public-api/get-backtests-atop-custom-strategies): Custom strategies created through the API.
- [GET /backtests/atop/datasets](https://app.itomarkets.com/docs/md/public-api/get-backtests-atop-datasets): Registered ClickHouse replay datasets available as backtest inputs.
- [GET /backtests/atop/execution-models](https://app.itomarkets.com/docs/md/public-api/get-backtests-atop-execution-models): Fill/execution models for replay runs.
- [GET /backtests/atop/orderbook](https://app.itomarkets.com/docs/md/public-api/get-backtests-atop-orderbook): Pull a bounded sample from registered historical L2 datasets for inspection before replay.
- [POST /backtests/atop/dataset](https://app.itomarkets.com/docs/md/public-api/post-backtests-atop-dataset): Bundle L2 orderbook windows + spot klines for a symbol and period into a single response ready for backtest replay.
- [POST /backtests/atop/validate](https://app.itomarkets.com/docs/md/public-api/post-backtests-atop-validate): Validate a run spec without dispatching execution.
- [POST /backtests/atop/plan](https://app.itomarkets.com/docs/md/public-api/post-backtests-atop-plan): Validate a multi-window experiment plan without dispatching jobs. The body wraps a shared base_spec with named windows; each window is validated as its own run spec.
- [POST /backtests/atop](https://app.itomarkets.com/docs/md/public-api/post-backtests-atop): Submit a validated run spec for execution. Returns 202 with data.run_id to poll.
- [GET /backtests/atop/{run_id}](https://app.itomarkets.com/docs/md/public-api/get-backtests-atop-run-id): Run status, or the durable result artifact once complete. Returns 202 while running.

## Optional
- [Full docs as one Markdown file](https://app.itomarkets.com/llms-full.txt): The overview, every endpoint, and the dashboard API concatenated.