API Overview

The cleanest public split is:

1. Historical Data

Use this for archive access, bulk download, and research queries over past market activity. Initial families:

Markets
Trades
Candles
Order books later

2. Realtime Data

Use this for live reads that power dashboards, monitoring, and event-driven systems. Initial families:

Markets
Ticks
Order books

3. Product APIs

Use this for user-owned workflow objects inside Forecast. Initial families:

Backtests
Bots
Strategies

Documentation Rules For This First Pass

If a page maps to a live route, it shows the current path and request shape.
If a page maps to a planned product, it documents the intended resource and delivery model without locking the final endpoint yet.