---
title: "Matched cross-venue catalog (v2)"
method: GET
path: "/v2/markets"
tags: ["data"]
---

# Matched cross-venue catalog (v2)

`GET /v2/markets`

Canonical market list.

Unfiltered / ?signal=spread: the Market catalog. ?signal=candidates: review-band Market rows.
Arbitrage is a different resource with different identity and execution fields; use GET /v2/arbitrage.
market_type default (moneyline,outright) preserves the pre-family-build row set and existing field
semantics — MARKET_FAMILIES.md §2 DoD #2. Additive type discriminators may appear; `all` removes
the filter.

## Query parameters

- `category` string, nullable
- `sport` string, nullable
- `competition` string, nullable
- `location` string, nullable
- `asset` string, nullable
- `indicator` string, nullable
- `basis` string, nullable
- `institution` string, nullable
- `league` string, nullable — Deprecated sports-only alias for competition
- `status` string, nullable — Comma-separated: open,live,resolving,closed,settled. Default: open,live
- `signal` string, nullable — spread | candidates. Arbitrage is GET /v2/arbitrage
- `sort` string, nullable — start_time | -start_time | -spread_pts
- `include` string, nullable — ids,depth,settlement
- `market_type` string, nullable — Comma-separated: moneyline,outright,total,spread,team_total,advance,weather_high,weather_low,crypto_above,fed_decision,econ_print,cb_decision,all. Default: moneyline,outright
- `game_id` string, nullable — Exact match on the family grouping key
- `has_history` boolean — Resolved markets only: require real price history
- `page` integer — Page through history-backed resolved markets
- `limit` integer

## Headers

- `authorization` string

## Response `200`

Successful Response

- unknown

## Other responses

- `401` — Missing or invalid API key
- `402` — Subscription inactive
- `422` — Validation Error
- `429` — Rate limit exceeded
- `503` — Auth admission gate full (transient) — retry shortly, see retry_after

---

[API](https://skmtc.net/dino/apis/dino-markets-api.md) · [All operations](https://skmtc.net/dino/apis/dino-markets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dino/dino-markets-api/versions/8cbe8774824f/schema)