Venue Capabilities

Venues differ in what they publish. Ask a venue's capabilities before asking it for candles, books or trades.

An AMM venue has pools and no order book; an order-book venue has a book and no pools; some venues publish trades and candles and some do not. Instead of discovering this through errors, ask the venue first:

curl -s "https://api.cantoncap.cc/v1/venues/temple/capabilities" \
  -H "X-API-Key: $CANTONCAP_API_KEY"

JSON

{
  "status": { "request_id": "req_7Hk2pQ9xLm", "error_code": 0 },
  "data": {
    "venue_id": "temple",
    "features": {
      "prices": true,
      "trades": true,
      "candles": true,
      "order_book": true,
      "quotes": true,
      "liquidity": true
    },
    "history": {
      "available_from": "2026-09-10T00:00:00.000Z",
      "intervals": ["1m", "5m", "15m", "1h", "4h", "1d"]
    }
  }
}

The values above are illustrative; read each venue's own.

Fields

Field	Meaning
`features.prices`	The venue publishes a ticker for its markets.
`features.trades`	The venue publishes its recent trades.
`features.candles`	The venue publishes its own candles. CantonCap also builds rollup candles from trades, so market candles can exist where this is false.
`features.order_book`	The venue publishes order books.
`features.quotes`	The venue can price a trade of a given size. Trade quotes are not part of the public API; the flag describes the venue.
`features.liquidity`	Liquidity snapshots are available for the venue's markets.
`history.available_from`	The earliest time history is available from, or null when unknown. Where history began when CantonCap started observing a venue, earlier periods do not exist.
`history.intervals`	Intervals the venue's history is available in.

Capability Is Not Availability

Capabilities describe what a venue can publish. Whether its feed is working right now is a separate question, answered by GET /v1/status/sources. A venue can support candles and still be briefly unavailable; a venue that does not support order books will never have one.

Market Model First

Within a venue, the market decides: market_model is amm, order_book, order_book_rfq or hybrid. Asking an AMM market for its order book answers 422 unsupported_capability with Order books are not available for this market model; ask its pool instead.

Choosing the Right Endpoint

You want	Order-book market	AMM market
Current price	`/v1/markets/{id}/ticker`	`/v1/markets/{id}/ticker`
Depth	`/v1/markets/{id}/orderbook`	`/v1/markets/{id}/liquidity` (modelled from pool state)
Liquidity	`/v1/markets/{id}/liquidity` (spread and depth)	`/v1/pools/{id}`, `/v1/markets/{id}/liquidity`
Candles	`/v1/markets/{id}/ohlcv`	`/v1/markets/{id}/ohlcv`

For one asset across every venue, use the asset endpoints instead: Venues, markets and pairs.