APIBeta

Market data & analytics

Public models, books, candles, indexes, receipts, and auction reconstruction.

Owner: Developer Experience
Version: api-2026.07
Verified: 2026-07-13

Market data is public by design. You can inspect liquidity before sending a paid request, subscribe to snapshots for a dashboard, and reconstruct the auction after a response without holding the customer's wallet or prompt.

Market reads

Endpoint	Returns	Auth
`GET /health`	Deployment and auction version	public
`GET /ready`	Readiness gates and dependency state	public
`GET /v1/models`	Live model classes, depth, quality, prices, and routing profiles	public
`GET /v1/market/book`	Anonymized ask ladder by class	public
`GET /v1/market/snapshot`	Models, book, and economics in one response	public
`GET /v1/market/candles`	Cleared-price OHLC/VWAP series	public
`GET /v1/market/index`	Token-weighted composite price index	public
`GET /v1/market/events`	SSE market snapshots when capacity is enabled	public
`GET /v1/market/stats`	24-hour clearing summary	public
`GET /v1/analytics/market`	Per-class prices, HHI, and latency	public
`GET /v1/analytics/rollups`	Hourly aggregates up to 90 days	public
`GET /v1/analytics/dashboard`	Bucketed chart feed	public
`GET /v1/analytics/leaderboard`	Customer aggregate rankings	public
`GET /v1/receipts/:id`	Signed usage receipt and integrity data	public
`GET /v1/analytics/requests/:id`	Auction reconstruction and rival counterfactuals	public

market datano wallet required

# Current market
curl "$ROUTER_URL/v1/market/snapshot"

# 24 hours of hourly candles for one class
curl "$ROUTER_URL/v1/market/candles?window_ms=86400000&bucket_ms=3600000&model_class=minimax-m3"

# Composite index across a chosen basket
curl "$ROUTER_URL/v1/market/index?window_ms=604800000&classes=minimax-m3,glm-5.2"

Query parameters

Parameter	Endpoints	Behavior
`window_ms`	candles, index, analytics	Time window; bounded by the endpoint's maximum.
`bucket_ms`	candles, index, dashboard	Bucket width; clamped to a safe number of points.
`model_class`	candles	Filter the series to one class.
`classes`	index	Comma-separated basket; omission uses the whole market.
`limit`	leaderboard	Customer count, bounded by the router.

Readiness and reconciliation

GET /ready is a public dependency check. Mainnet fails closed and returns 503 when financial reconciliation has failed. Its structured reconciliation.status is one ofnot_run, running, ok, orfailed. Prometheus exposes the matching low-cardinality omnious_reconciliation_okand timestamp metrics.

Receipts and auction economics

The request id comes from x-request-id on the paid response. A receipt shows metered tokens, cleared prices, charge, authorization, settlement, and timing. The companion economics endpoint reconstructs the auction: the winner, rival quotes, price-setter, latency terms, and fee split.

audit a request

curl "$ROUTER_URL/v1/receipts/req_01H..."
curl "$ROUTER_URL/v1/analytics/requests/req_01H..."

privacyPublic request economics does not expose the prompt or completion. The router retains the receipt and bounded operational data, not a durable transcript.

Streaming market events

GET /v1/market/events emits the same shape as /v1/market/snapshot as SSE frames. If subscriber capacity is full, the endpoint returns 503 with a retry hint; fall back to polling the snapshot endpoint.

where this lives in code

router/src/http/server.ts market and analytics route definitions
router/src/operations/analytics.ts auction and counterfactual reconstruction
router/src/operations/platform.ts dashboard and rollup aggregates