How Q works
Q runs a fixed loop. Scored outcomes from published forecasts feed the next ones.
What the API serves
The API is the output of that loop, in four objects:
- Assets — the underlying company, commodity, or cryptoasset.
- Markets — the prediction-market contracts about it, with live venue odds.
- Forecasts — Q's probability on a market, with its bands and reasoning.
- Signals — the calls Q publishes, with frozen entries and a live record.
Alongside them: the sources behind each forecast, the Hawk & Dove index, portfolio intelligence, and the record of everything published.
How objects link
An Asset has Markets. A Market has Forecasts. A Signal sits on a Forecast, on a Market. Detail
responses can include a relationships envelope with the object's graph neighborhood: flat
identity references, up to 50 per category.
Each reference keeps the exact relationship, direction (incoming or outgoing), and via
(direct, market, or asset). Check relationships.truncated before treating a neighborhood
as complete, and follow a reference to its canonical detail route when you need more than the
identity. Workflows covers this in the detail an agent needs.