---
title: "Cross-venue price-gap view over matched pairs (v2)"
method: GET
path: "/v2/spreads"
tags: ["data"]
---

# Cross-venue price-gap view over matched pairs (v2)

`GET /v2/spreads`

The Market-shaped spread-observation counterpart to /v2/arbitrage: matched pairs whose resolution rule
marks them spread-only (never arb-fireable) but that still carry a live, disclosed cross-venue price
gap. Same tier availability as the arb surface — every active-subscription tier, gated only by the
generic account/rate-limit check (no tier-specific feature gate on this REST surface, §7.1).

## 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
- `min_gap` number, nullable — Minimum spread_pts (cross-venue gap, in points)
- `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

## Changes

- **2026-07-26** `e6ef9fe45ca4` — 7 info
  - added the new optional `query` request parameter `asset`
  - added the new optional `query` request parameter `basis`
  - added the new optional `query` request parameter `category`
  - added the new optional `query` request parameter `competition`
  - …3 more

[Change history](https://skmtc.dev/dino/apis/dino-markets-api/changes/v2/spreads/get.md)

---

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