GET

/api/v1/markets

List markets tracked by Q

Every active Q-tracked prediction market with either an in-window forecast or a Q signal, returned in one complete response with venue_quote provenance. Polymarket International and Kalshi expose a verified live quote or null; Polymarket US and Limitless expose a graph snapshot marked stale. Event tags and categories support discovery; use exact topic filtering or /markets/search to narrow the response.

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

Parameters

Name	In	Type	Description
topic	query	string	Case-insensitive exact Event/market tag or category filter. Direct tags do not need a Category assignment.
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.
max_forecast_age	query	integer	Maximum forecast age in hours. Windows forecast_count and latest_forecast_at — only forecasts created within this window are counted. Markets with no in-window forecast are still included if they have signals. Default: 48 Default: 48; Minimum: 1
changed_within	query	integer	Only markets whose latest forecast was created within this many hours — 'recently updated by Q'. Evaluated against the unwindowed latest forecast, independent of max_forecast_age. Minimum: 1; Maximum: 168
sort	query	"updated_desc" \| "volume_desc" \| "signal_count_desc"	Sort order. Default: updated_desc

Responses

200: List of markets with forecast data

Field

Type

Description

markets

required

MarketListItem[]

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

event

required

MarketEventContext | null

Parent Event context when the market is attached to an Event.

event fields

Field	Type	Description
id required	string \| null
title required	string \| null
slug required	string \| null

categories

required

string[]

Categories derived from Event tags and venue-native market metadata.

end_date

required

string | null

When this market closes/resolves. Null if no end date is set.

Format: date-time

market_odds

required

number | null

Source-venue YES probability (0-1), exactly matching venue_quote.selected_probability. Polymarket International and Kalshi use a verified live quote or null. Polymarket US and Limitless currently expose a graph snapshot marked quote_method=graph_snapshot and freshness=stale.

venue_quote

required

VenueQuoteV1

Provenance for market_odds, including selection method and freshness.

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

volume_24h

required

number | null

Nullable venue-reported 24-hour activity where available. Units, refresh cadence, and comparability can differ by venue; do not rank across venues without inspecting the source context.

signal_count

required

integer

Number of analyst signals for this market

forecast_count

required

integer

Number of Q forecasts within the max_forecast_age window

latest_forecast_at

required

string | null

When Q's most recent forecast was created

Format: date-time

market_updated_at

required

string | null

When the market's odds or metadata last synced from its source venue

Format: date-time

latest_forecast_delta

required

number | null

Probability change of the latest forecast vs its prior (deltaFromPrior)

latest_forecast_refresh_reason

required

string | null

Why the latest forecast reran (e.g. price_move). Null for scheduled runs.

forecast_status

object | null

Coverage status against the latest forecast, priced from the same market_odds and venue_quote. 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.

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

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

venue_facets

required

object[]

venue_facets 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.
count required	integer

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'

200 · application/json

{
  "markets": [
    {
      "venue": "kalshi",
      "nativeMarketId": "KXGOLD-26AUG-T2500",
      "nativeEventId": "KXGOLD-26AUG",
      "seriesTicker": "KXGOLD",
      "marketKey": "kalshi:KXGOLD-26AUG-T2500",
      "quotientMarketId": "kalshi:KXGOLD-26AUG-T2500",
      "slug": null,
      "marketUrl": null,
      "sourceUrl": null,
      "question": "Will gold settle above $2,500 in August?",
      "event": {
        "id": "KXGOLD-26AUG",
        "title": "Gold price in August",
        "slug": null
      },
      "tags": [
        "Commodities",
        "Metals",
        "Gold"
      ],
      "categories": [
        "Commodities"
      ],
      "end_date": "2026-08-31T20:00:00Z",
      "market_odds": 0.46,
      "venue_quote": {
        "schema_version": "1",
        "venue": "kalshi",
        "market_id": "KXGOLD-26AUG-T2500",
        "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": null,
      "volume_24h": null,
      "signal_count": 0,
      "forecast_count": 1,
      "latest_forecast_at": "2026-08-08T14:30:00Z",
      "market_updated_at": "2026-08-08T15:02:11Z",
      "latest_forecast_delta": 0.03,
      "latest_forecast_refresh_reason": "price_move",
      "quotientUrl": "https://quotient.social/markets/kalshi%3AKXGOLD-26AUG-T2500",
      "polymarketUrl": null
    }
  ],
  "venue_facets": [
    {
      "venue": "kalshi",
      "count": 1
    }
  ]
}