GET

/api/v1/markets/mispriced

Markets where Q diverges from market odds

Returns covered markets where Q's forecast diverges from a verified live venue YES quote by at least min_spread. The route batch-fetches quotes before applying the 0.1–0.8 odds band, spread, direction, and sort. Missing, stale, and unsupported live quotes are excluded. Volume is nullable and venue-reported.

Price $0.02Auth x-quotient-api-key or x402Limit 20/s · 600/min · 20,000/day

Parameters

Name	In	Type	Description
venue	query	"polymarket" \| "polymarket_us" \| "kalshi" \| "limitless"	Optional prediction-market venue filter. Omit it on catalog/feed routes to include every covered venue. On legacy slug or condition-ID lookups, omission retains the Polymarket namespace; prefer marketKey for collision-safe cross-venue lookup.
topic	query	string	Case-insensitive exact tag or category name, matched against the market's Event tags, categories, and market-level tags — the same taxonomy as /api/v1/markets?topic. topic=commodities narrows the response to commodity markets. Unknown values return an empty list.
min_spread	query	number	Minimum absolute spread between Q forecast and market odds (0-1). Default: 0.05 Default: 0.05; Minimum: 0; Maximum: 1
max_forecast_age	query	integer	Maximum forecast age in hours. Default: 48 Default: 48; Minimum: 1
sort	query	"spread_desc" \| "spread_asc" \| "updated_desc" \| "volume_desc"	Sort order. Default: spread_desc

Responses

200: List of mispriced markets with forecast data

Field

Type

Description

markets

required

MispricedMarketItem[]

markets fields

Field

Type

Description

venue

required

"polymarket" | "polymarket_us" | "kalshi" | "limitless"

Prediction-market venue key: polymarket (Polymarket International), polymarket_us (Polymarket US), kalshi, or limitless.

nativeMarketId

required

string

nativeEventId

required

string | null

seriesTicker

required

string | null

marketKey

required

string

quotientMarketId

required

string

Stable Quotient market-page id: bare numeric for legacy Polymarket rows, venue-prefixed (kalshi:TICKER, polymarket_us:123, …) elsewhere. quotientUrl is exactly https://quotient.social/markets/{quotientMarketId} (URL-encoded) — the id form the market page resolves for every venue. A market with no Quotient coverage yet may not have a page.

slug

required

string | null

marketUrl

required

string | null

Connector-owned market page URL; null when unavailable.

Format: uri

sourceUrl

required

string | null

Connector provenance or API source URL.

Format: uri

broker_channels

required

"robinhood"[]

Retail brokers that carry this exact venue contract (same order book, same settlement). A broker distributes the venue contract; venue and marketKey remain the contract's identity. Today only robinhood, stamped on Kalshi rows from Robinhood's public listings; empty when no broker lists the market. Filter with topic=robinhood on /markets, /markets/mispriced and /signals, or tag=robinhood on /markets/search.

robinhood_category

required

string | null

Robinhood's own category slug for the listing (economics, politics, crypto, climate, …); null when not listed on Robinhood.

robinhood_url

required

string | null

Deep link to the Robinhood event page; null when not listed on Robinhood.

Format: uri

question

required

string

The market question

end_date

required

string | null

When this market closes/resolves

Format: date-time

quotient_odds

required

number

Q's forecast probability (0-1) expressed as YES odds

market_odds

required

number

Verified live source-venue YES probability (0-1), exactly matching venue_quote.selected_probability.

venue_quote

required

VenueQuoteV1

Verified live quote used for the odds band, spread, direction, ordering, and count.

venue_quote fields

Field	Type	Description
schema_version required	"1"
venue required	"polymarket" \| "polymarket_us" \| "kalshi" \| "limitless" \| null	Prediction-market venue key: polymarket (Polymarket International), polymarket_us (Polymarket US), kalshi, or limitless.
market_id required	string \| null
yes_bid required	number \| null	Minimum: 0; Maximum: 1
yes_ask required	number \| null	Minimum: 0; Maximum: 1
yes_last required	number \| null	Minimum: 0; Maximum: 1
selected_probability required	number \| null	Prediction-market YES probability selected for the enclosing response. Inspect freshness and quote_method before treating it as current. Minimum: 0; Maximum: 1
quote_method required	string \| null	midpoint, bid, ask, fresh last, or graph_snapshot. Null when pricing is unavailable.
venue_timestamp required	string \| null	Source clock for the selected quote: book update for book methods, last-trade time for last, or catalog observation time for graph_snapshot. Format: date-time
observed_at required	string \| null	When Quotient observed the live quote or stored graph snapshot. Format: date-time
freshness required	CapabilityState

inDispute

required

boolean

Whether the source venue currently reports a dispute or challenged settlement state. Legacy Polymarket rows map their UMA dispute state here.

clarifications

required

string | null

Rules clarifications for the market, if provided

bluf

required

string

Bottom-line-up-front summary

forecast

required

CompactForecast

forecast fields

Field

Type

Description

venue

required

"polymarket" | "polymarket_us" | "kalshi" | "limitless" | null

Prediction-market venue key: polymarket (Polymarket International), polymarket_us (Polymarket US), kalshi, or limitless.

market

required

CanonicalMarketRouting | null

market fields

Field	Type	Description
venue required	"polymarket" \| "polymarket_us" \| "kalshi" \| "limitless"	Prediction-market venue key: polymarket (Polymarket International), polymarket_us (Polymarket US), kalshi, or limitless.
nativeMarketId required	string
nativeEventId required	string \| null
seriesTicker required	string \| null
marketKey required	string
quotientMarketId required	string	Stable Quotient market-page id: bare numeric for legacy Polymarket rows, venue-prefixed (kalshi:TICKER, polymarket_us:123, …) elsewhere. quotientUrl is exactly https://quotient.social/markets/{quotientMarketId} (URL-encoded) — the id form the market page resolves for every venue. A market with no Quotient coverage yet may not have a page.
slug required	string \| null
marketUrl required	string \| null	Connector-owned market page URL; null when unavailable. Format: uri
sourceUrl required	string \| null	Connector provenance or API source URL. Format: uri
broker_channels required	"robinhood"[]	Retail brokers that carry this exact venue contract (same order book, same settlement). A broker distributes the venue contract; venue and marketKey remain the contract's identity. Today only robinhood, stamped on Kalshi rows from Robinhood's public listings; empty when no broker lists the market. Filter with topic=robinhood on /markets, /markets/mispriced and /signals, or tag=robinhood on /markets/search.
robinhood_category required	string \| null	Robinhood's own category slug for the listing (economics, politics, crypto, climate, …); null when not listed on Robinhood.
robinhood_url required	string \| null	Deep link to the Robinhood event page; null when not listed on Robinhood. Format: uri

required

string

probability

required

number

created_at

required

string

Format: date-time

headline

string | null

thesis

required

string | null

resolution_pathway

required

ResolutionPathway

The market contract and forecast crux needed to review how this forecast can resolve.

resolution_pathway fields

Field	Type	Description
criteria required	string \| null
crux required	string \| null
deadline required	string \| null	Format: date-time
source required	string \| null

delta_from_prior

number | null

delta_reasoning

string | null

refresh_reason

string | null

relationships

required

RelationshipsEnvelope

Bounded, non-recursive graph references. Each category publishes at most 50 lightweight refs. These refs contain no forecast probability, venue odds, aggregate asset probability, or inferred causal AFFECTS edge.

relationships fields

Field

Type

Description

assets

required

RelationshipAssetRef[]

Maximum items: 50

assets fields

Field	Type	Description
relationship required	"HAS_MARKET" \| "ON_MARKET" \| "ON_FORECAST" \| "HAS_SIGNAL"	Exact graph edge at the final hop. The API does not synthesize AFFECTS relationships.
direction required	"incoming" \| "outgoing"	Direction of the final graph edge relative to the response subject for direct refs, or relative to the explicit via node for two-hop refs.
via required	"direct" \| "market" \| "asset"	direct is one graph hop; market or asset names the explicit intermediate node for a bounded two-hop ref.
id required	string	Format: uuid
assetKey required	string
name required	string
ticker required	string \| null
asset_type required	string

markets

required

RelationshipMarketRef[]

Maximum items: 50

markets fields

Field	Type	Description
relationship required	"HAS_MARKET" \| "ON_MARKET" \| "ON_FORECAST" \| "HAS_SIGNAL"	Exact graph edge at the final hop. The API does not synthesize AFFECTS relationships.
direction required	"incoming" \| "outgoing"	Direction of the final graph edge relative to the response subject for direct refs, or relative to the explicit via node for two-hop refs.
via required	"direct" \| "market" \| "asset"	direct is one graph hop; market or asset names the explicit intermediate node for a bounded two-hop ref.
marketKey required	string
venue required	"polymarket" \| "polymarket_us" \| "kalshi" \| "limitless"	Prediction-market venue key: polymarket (Polymarket International), polymarket_us (Polymarket US), kalshi, or limitless.
nativeMarketId required	string
question required	string \| null

signals

required

RelationshipSignalRef[]

Maximum items: 50

signals fields

Field	Type	Description
relationship required	"HAS_MARKET" \| "ON_MARKET" \| "ON_FORECAST" \| "HAS_SIGNAL"	Exact graph edge at the final hop. The API does not synthesize AFFECTS relationships.
direction required	"incoming" \| "outgoing"	Direction of the final graph edge relative to the response subject for direct refs, or relative to the explicit via node for two-hop refs.
via required	"direct" \| "market" \| "asset"	direct is one graph hop; market or asset names the explicit intermediate node for a bounded two-hop ref.
id required	string
signal_type required	"prediction_market"
canonical_endpoint required	"/api/v1/signals"
side required	string \| null
published_at required	string \| null

truncated

required

object

truncated fields

Field	Type	Description
assets required	boolean
markets required	boolean
signals required	boolean

spread

required

number | null

Absolute difference between Q forecast and market odds

spread_direction

required

"q_higher" | "q_lower"

forecast_status

object | null

Live-priced coverage status against the latest forecast. Null when the required quote or forecast is unavailable.

forecast_status fields

Field	Type	Description
state required	"warning" \| "caution" \| "converged" \| "converging" \| "sideways" \| "diverging"
cents required	integer	Movement states: gap closed (+) or opened (−) over the window. converged: how far past Q the venue sits. Adverse tiers: the move from the worse anchor in position-space cents (negative).
adverse_move_pct required	number \| null	The standing worse-of-anchors adverse move, RELATIVE % of anchor cost, positive = against Q's side. Served on every state — a 14.9% move stays visible below the caution line. Negative means the market has moved in Q's favour. Null when no anchor is priced.
basis required	"since_publish" \| "since_forecast"	The window the read measured: an adverse tier stamps the anchor that fired; other states carry the surface's measurement window.
price_source required	"live" \| "graph"	live = verified venue quote; graph = an explicitly stale graph_snapshot for a venue without a live adapter. Graph snapshots carry stale discovery data.

volume_24h

required

number | null

Nullable venue-reported 24-hour activity. Treat it as venue-specific in the venue's own units.

last_updated

required

string

Format: date-time

signal_count

required

integer

Number of analyst signals for this market

quotientUrl

required

string | null

Canonical Quotient market page: https://quotient.social/markets/{quotientMarketId} (URL-encoded). The id form resolves for every venue; a market with no Quotient coverage yet may not have a page.

polymarketUrl

required

string | null

Legacy Polymarket navigation alias. Populated only for Polymarket International rows and null for Polymarket US, Kalshi, and Limitless; use marketUrl for venue-neutral navigation.

relationships

required

RelationshipsEnvelope

relationships fields

Field

Type

Description

assets

required

RelationshipAssetRef[]

Maximum items: 50

assets fields

Field	Type	Description
relationship required	"HAS_MARKET" \| "ON_MARKET" \| "ON_FORECAST" \| "HAS_SIGNAL"	Exact graph edge at the final hop. The API does not synthesize AFFECTS relationships.
direction required	"incoming" \| "outgoing"	Direction of the final graph edge relative to the response subject for direct refs, or relative to the explicit via node for two-hop refs.
via required	"direct" \| "market" \| "asset"	direct is one graph hop; market or asset names the explicit intermediate node for a bounded two-hop ref.
id required	string	Format: uuid
assetKey required	string
name required	string
ticker required	string \| null
asset_type required	string

markets

required

RelationshipMarketRef[]

Maximum items: 50

markets fields

Field	Type	Description
relationship required	"HAS_MARKET" \| "ON_MARKET" \| "ON_FORECAST" \| "HAS_SIGNAL"	Exact graph edge at the final hop. The API does not synthesize AFFECTS relationships.
direction required	"incoming" \| "outgoing"	Direction of the final graph edge relative to the response subject for direct refs, or relative to the explicit via node for two-hop refs.
via required	"direct" \| "market" \| "asset"	direct is one graph hop; market or asset names the explicit intermediate node for a bounded two-hop ref.
marketKey required	string
venue required	"polymarket" \| "polymarket_us" \| "kalshi" \| "limitless"	Prediction-market venue key: polymarket (Polymarket International), polymarket_us (Polymarket US), kalshi, or limitless.
nativeMarketId required	string
question required	string \| null

signals

required

RelationshipSignalRef[]

Maximum items: 50

signals fields

Field	Type	Description
relationship required	"HAS_MARKET" \| "ON_MARKET" \| "ON_FORECAST" \| "HAS_SIGNAL"	Exact graph edge at the final hop. The API does not synthesize AFFECTS relationships.
direction required	"incoming" \| "outgoing"	Direction of the final graph edge relative to the response subject for direct refs, or relative to the explicit via node for two-hop refs.
via required	"direct" \| "market" \| "asset"	direct is one graph hop; market or asset names the explicit intermediate node for a bounded two-hop ref.
id required	string
signal_type required	"prediction_market"
canonical_endpoint required	"/api/v1/signals"
side required	string \| null
published_at required	string \| null

truncated

required

object

truncated fields

Field	Type	Description
assets required	boolean
markets required	boolean
signals required	boolean

count

required

integer

Number of rows remaining after live quote, odds-band, and spread filters.

Minimum: 0

401: Unauthorized

Field	Type	Description
error required	string	Error code
message required	string	Human-readable message
retry_after	integer	Seconds to wait (only on 429)
retryAfter	integer	Seconds to wait for owner-scoped forecast-request quota errors.
limit_scope	string	Quota scope that rejected the request, such as standard or x_research.
quotaScope	string	Stable forecast-request quota scope, such as venue_market_daily.
limit	integer	Configured bound for the forecast-request quota that was exceeded.

402: Payment Required

Field	Type	Description
error required	string	Error code
message required	string	Human-readable message
retry_after	integer	Seconds to wait (only on 429)
retryAfter	integer	Seconds to wait for owner-scoped forecast-request quota errors.
limit_scope	string	Quota scope that rejected the request, such as standard or x_research.
quotaScope	string	Stable forecast-request quota scope, such as venue_market_daily.
limit	integer	Configured bound for the forecast-request quota that was exceeded.

403: Insufficient credits for the requested route

Field	Type	Description
error required	string	Error code
message required	string	Human-readable message
retry_after	integer	Seconds to wait (only on 429)
retryAfter	integer	Seconds to wait for owner-scoped forecast-request quota errors.
limit_scope	string	Quota scope that rejected the request, such as standard or x_research.
quotaScope	string	Stable forecast-request quota scope, such as venue_market_daily.
limit	integer	Configured bound for the forecast-request quota that was exceeded.

422: Invalid request parameters

Field	Type	Description
error required	string	Error code
message required	string	Human-readable message
retry_after	integer	Seconds to wait (only on 429)
retryAfter	integer	Seconds to wait for owner-scoped forecast-request quota errors.
limit_scope	string	Quota scope that rejected the request, such as standard or x_research.
quotaScope	string	Stable forecast-request quota scope, such as venue_market_daily.
limit	integer	Configured bound for the forecast-request quota that was exceeded.

429: The caller exceeded a per-second, per-minute, daily, or concurrency limit. No credits are debited and no x402 payment is settled for this response.

Field	Type	Description
error required	string	Error code
message required	string	Human-readable message
retry_after	integer	Seconds to wait (only on 429)
retryAfter	integer	Seconds to wait for owner-scoped forecast-request quota errors.
limit_scope	string	Quota scope that rejected the request, such as standard or x_research.
quotaScope	string	Stable forecast-request quota scope, such as venue_market_daily.
limit	integer	Configured bound for the forecast-request quota that was exceeded.

Set QUOTIENT_API_KEY in your shell and replace example identifiers with returned IDs before running a request.

curl

curl --request GET \
  --header "x-quotient-api-key: $QUOTIENT_API_KEY" \
  'https://quotient-api-gateway.onrender.com/api/v1/markets/mispriced'

200 · application/json

{
  "markets": [
    {
      "venue": "polymarket",
      "nativeMarketId": "123456",
      "nativeEventId": "98765",
      "seriesTicker": null,
      "marketKey": "polymarket:123456",
      "quotientMarketId": "123456",
      "slug": "fed-rate-cut-june-2026",
      "marketUrl": "https://polymarket.com/event/fed-rate-cut-june-2026",
      "sourceUrl": "https://gamma-api.polymarket.com/markets/123456",
      "question": "Will the Fed cut rates by June 2026?",
      "end_date": "2026-06-30T00:00:00Z",
      "quotient_odds": 0.34,
      "market_odds": 0.46,
      "venue_quote": {
        "schema_version": "1",
        "venue": "polymarket",
        "market_id": "123456",
        "yes_bid": 0.46,
        "yes_ask": 0.46,
        "yes_last": null,
        "selected_probability": 0.46,
        "quote_method": "midpoint",
        "venue_timestamp": "2026-08-31T12:00:00Z",
        "observed_at": "2026-08-31T12:00:00Z",
        "freshness": "verified"
      },
      "inDispute": false,
      "clarifications": "Rate cut markets resolve based on the upper bound of the target range.",
      "bluf": "Persistent inflation data makes a June cut unlikely.",
      "spread": 0.12,
      "spread_direction": "q_lower",
      "volume_24h": 182400,
      "last_updated": "2026-03-05T14:30:00Z",
      "signal_count": 5,
      "quotientUrl": "https://quotient.social/markets/123456",
      "polymarketUrl": "https://polymarket.com/event/fed-rate-cut-june-2026"
    }
  ],
  "count": 1
}