---
title: "List current sportsbook-consensus fair values"
method: GET
path: "/v1/fair-values"
tags: ["Fair Values"]
---

# List current sportsbook-consensus fair values

`GET /v1/fair-values`

## Request

- Base URL: `https://sorqen.flashodds.live`
- URL: `https://sorqen.flashodds.live/v1/fair-values`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Returns real current fair values for an authenticated Free or paid key. Free sees the number at the same freshness as paid plans; paid plans can include evidence and higher limits.

## Query parameters

- `league` string
- `market_type` string
- `min_confidence` number
- `limit` integer
- `cursor` string

## Response `200`

Current fair values, shaped to the caller plan.

- object
  - `data` FairValue[]
    - `outcome_id` string, required
    - `market_id` string
    - `event_id` string
    - `league` 'nfl' | 'nba' | 'mlb' | 'nhl', required
    - `market_type` 'moneyline' | 'spread' | 'total', required
    - `selection` string
    - `starts_at` string, date-time
    - `fair_probability` number, nullable, required: Null means Sorqen refused to produce a number; limiting_factor explains why.
    - `confidence` number, nullable
    - `dispersion` number, nullable
    - `books` integer
    - `limiting_factor` string, nullable
    - `method_version` string, required
    - `computed_at` string, date-time
    - `oldest_component_age_s` integer, nullable
    - `evidence` object: Paid-plan component evidence. Omitted when the plan does not include evidence.
  - `page` object
  - `meta` object

## Other responses

- `401`: Missing or invalid API key.
- `403`: The authenticated plan does not include this entitlement.
- `429`: Plan request limit exceeded. Retry-After and X-RateLimit headers are returned.

---

[API](https://skmtc.dev/flashodds/apis/sorqen-api.md) · [All operations](https://skmtc.dev/flashodds/apis/sorqen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flashodds/apis/sorqen-api/revisions/ec67a9e22813?raw)