GET

/api/v1/markets/{slug}/intelligence

Full intelligence on a market

Q's forecast with key drivers, correlated article evidence, and venue-quote provenance. Polymarket International and Kalshi use verified live pricing or null; other venues label graph snapshots stale. Per-article direction is null when the correlation does not assess it.

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

Parameters

Name	In	Type	Description
slug	path, required	string	Market slug identifier
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.

Responses

200: Market intelligence with forecast, key drivers, and signals

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

string

end_date

string | null

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

Format: date-time

quotient_odds

number

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

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

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

boolean

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

clarifications

string | null

Rules clarifications for the market, if provided

bluf

string

Bottom-line-up-front summary

forecast

CompactForecast | null

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

last_updated

string | null

When Q's most recent forecast was created

Format: date-time

volume_24h

number | null

Nullable venue-reported 24-hour activity where available; cadence and units can differ by venue.

quotientUrl

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

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.

forecast_status

required

object | null

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

key_drivers

KeyDriver[]

key_drivers fields

Field	Type	Description
factor	string	What this driver is
direction	"for" \| "against" \| "neutral"
impact	"critical" \| "significant" \| "moderate" \| "minor"
citation	string \| null	Source citation for this driver

signals

SignalItem[]

Up to 10 correlated articles, newest source publication first

signals fields

Field	Type	Description
id required	string \| null	Stable article identifier, normally its URL
title required	string	Article or source title
comment required	string	Why the article was correlated to the market, when available
direction required	"yes" \| "no" \| "neutral" \| null	Direction relative to the market question; null when the article correlation does not assess direction
url required	string \| null	Source article URL Format: uri
source required	string \| null	Source publication name
published_at required	string \| null	Best available article publication or ingestion time Format: date-time
correlated_at required	string \| null	When Quotient correlated or ingested the article for this market Format: date-time
confidence required	string \| null	Correlation confidence when available
evidence_quote required	string \| null	Supporting quote recorded on the correlation when available

source_reads_updated_at

string | null

Publication/ingestion time of the newest returned article

Format: date-time

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

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.

404: Invalid market slug, or no forecast/source-read coverage. The gateway does not bill or settle non-success responses.

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/example-slug/intelligence'

200 · application/json

{
  "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.",
  "last_updated": "2026-03-05T14:30:00Z",
  "volume_24h": 182400,
  "quotientUrl": "https://quotient.social/markets/123456",
  "polymarketUrl": "https://polymarket.com/event/fed-rate-cut-june-2026",
  "key_drivers": [
    {
      "factor": "CPI re-acceleration in February print",
      "direction": "against",
      "impact": "critical",
      "citation": "Bureau of Labor Statistics CPI Report, March 2026"
    }
  ],
  "signals": [
    {
      "id": "https://example.com/march-cpi",
      "title": "March CPI Report Shows Re-acceleration",
      "comment": "CPI re-acceleration and hawkish Fed minutes suggest rate cuts are unlikely near-term.",
      "direction": null,
      "url": "https://example.com/march-cpi",
      "source": "Example News",
      "published_at": "2026-03-05T13:45:00Z",
      "correlated_at": "2026-03-05T14:25:00Z",
      "confidence": "high",
      "evidence_quote": "Inflation re-accelerated in the March release."
    }
  ],
  "source_reads_updated_at": "2026-03-05T14:25:00Z"
}